### Initialize Backend Project Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/SPARC_Methodology_Example.md

Sets up the backend directory, initializes npm, and installs core dependencies and development tools.

```bash
# Create project structure
mkdir attendance-fleet-platform
cd attendance-fleet-platform

# Initialize backend
mkdir backend
cd backend
npm init -y
npm install express sequelize pg pg-hstore jsonwebtoken bcrypt dotenv cors helmet
npm install -D jest supertest nodemon eslint prettier
```

--------------------------------

### Initialize Frontend Project Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/SPARC_Methodology_Example.md

Creates a new React frontend application and installs necessary libraries for state management, routing, and UI components.

```bash
# Initialize frontend
cd ..
npx create-react-app frontend
cd frontend
npm install @reduxjs/toolkit react-redux react-router-dom axios @mui/material chart.js react-chartjs-2

# Return to root
cd ..

```

--------------------------------

### Install RuVector and Initialize AgentDB

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Basic setup command for intermediate integration. Run this before using both AgentDB and RuVector.

```bash
npm install ruvector
claude-flow memory init
```

--------------------------------

### Parallel Implementation Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Initialize parallel worktrees for multiple contexts before starting swarm execution.

```bash
wt-add [context-a]
wt-add [context-b]
wt-add [context-c]
```

--------------------------------

### Post-Setup Verification Commands

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/README.md

Commands to run after installation to reload the shell, verify installation, and get help.

```bash
# 1. Reload shell
source ~/.bashrc

# 2. Verify installation
turbo-status

# 3. Get help
turbo-help

# 4. Run post-setup verification (13 checks)
# ./.devcontainer/post-setup-turboflow-4.sh
```

--------------------------------

### Docker Setup and Management

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/SPARC_Methodology_Example.md

Commands for building Docker containers, starting services in detached mode, and viewing logs.

```bash
docker-compose build
docker-compose up -d
docker-compose logs -f
```

--------------------------------

### Create and Make Executable Start Environment Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/prd2build.md

This snippet shows how to create a start-env.sh script in the project root and make it executable. It also includes example output for accessing different services.

```bash
# Add service-specific start command

echo "✅ All services started!"
echo ""
echo "Access your application:"
echo "  - Frontend: http://localhost:3000"
echo "  - Backend API: http://localhost:5843"
echo "  - Database: localhost:5432"
echo "  - Cache: localhost:6379"

```

```bash
Save to project root: start-env.sh
Make executable: chmod +x start-env.sh
```

--------------------------------

### Morning Setup Commands

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/DEVELOPMENT_GUIDE.md

Commands to run at the start of the day for checking system status and verifying recent activity.

```bash
npx claude-flow proxy status --verbose
```

```bash
npx claude-flow verify status --recent 5
```

```bash
npx claude-flow truth --report
```

```bash
npx claude-flow agent memory status
```

--------------------------------

### Start Multiple Workspaces

Source: https://github.com/marcuspat/turbo-flow/blob/main/spot_rackspace_setup_guide.md

Use this command to start new workspaces for different projects. Each repository gets its own pod, and only active workspaces consume resources.

```bash
# Each repo gets its own pod
devpod up https://github.com/user/project1
devpod up https://github.com/user/project2
devpod up https://github.com/user/project3

# Only active workspaces use resources
```

--------------------------------

### GitHub Codespaces Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Automated setup for GitHub Codespaces. Pushing to GitHub triggers the automatic execution of the .devcontainer script, which installs the complete stack.

```bash
Push to GitHub → Open in Codespace → .devcontainer runs automatically.
The setup-turboflow-4.sh script installs the complete stack.
```

--------------------------------

### First Time Project Setup with Native Commands

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Performs initial project setup tasks using native commands for Ruflo, GitNexus, and Beads.

```bash
# Using native commands:
npx ruflo@latest init
npx gitnexus analyze
bd init
npx ruflo@latest hooks pretrain
```

--------------------------------

### Example Task Kickoff for Codex

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

Illustrates the structured format for passing a task to Codex, including context, objective, scope, acceptance criteria, environment setup, priority, and the action to be taken.

```markdown
[CONTEXT]
Monorepo at /mnt/storage/saasgen, Node 20, pnpm, CI via GitHub Actions.
Current branch: main. No uncommitted changes.

[OBJECTIVE]
Add pagination to GET /users endpoint (server + tests).
Success = new tests pass, existing tests unaffected, response time ≤ 100ms.

[SCOPE]
Files: backend/routes/users.ts, backend/tests/users.test.ts
Out of scope: frontend, UI components, database schema changes

[ACCEPTANCE]
- New pagination tests pass (offset, limit, total_count)
- All existing tests pass
- No breaking changes to response structure
- Performance: response time unchanged or improved

[ENV]
cd /mnt/storage/saasgen
pnpm install
pnpm test

[PRIORITY]
Due by end of week; not blocking other work

[ACTION]
Codex, please implement pagination for GET /users and add comprehensive tests.

```

--------------------------------

### Multi-Agent Worktree Setup with Shared Beads

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Sets up a multi-agent development environment, initializing Beads, starting the Dolt server, creating worktrees for each agent, and defining task claiming and progress tracking mechanisms.

```bash
bd init
```

```bash
bd dolt set mode server && bd dolt start
```

```bash
wt-add agent-architect
wt-add agent-coder-1
wt-add agent-coder-2
wt-add agent-tester
```

```bash
bd update <task-id> --claim --assignee agent-coder-1
bd update <task-id> --status in_progress
```

```bash
bd update <task-id> --comment "Implemented auth module, tests passing"
```

```bash
bd close <task-id> --reason "Completed: [summary]"
```

```bash
bd dolt stop
wt-clean
```

--------------------------------

### Ruflo Setup Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/release_notes_4.0.0.md

The setup script handles the migration from v3.x to v4.0.0, including cleanup of old aliases and configuration.

```bash
#!/bin/bash
# This script handles the migration from v3.x to v4.0.0
# It includes cleanup of old aliases and configuration.

# Step 1: Cleanup old aliases
echo "Cleaning up old aliases..."
# Placeholder for actual alias cleanup commands

# Step 2: Update Ruflo configuration
echo "Updating Ruflo configuration..."
# Placeholder for actual configuration update commands

# Step 3: Initialize Beads memory
echo "Initializing Beads memory..."
# Placeholder for bd init command

# Step 4: Analyze codebase with GitNexus
echo "Analyzing codebase with GitNexus..."
# Placeholder for npx gitnexus analyze command

echo "Migration to Ruflo v4.0.0 complete."
```

--------------------------------

### Install flyctl on Linux

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Install the Fly.io CLI tool on Linux by downloading and executing the official installation script.

```bash
curl -L https://fly.io/install.sh | sh
```

--------------------------------

### Manual Turbo Flow Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/README.md

Clones the Turbo Flow repository, sets up the environment, and sources the bashrc.

```bash
git clone https://github.com/adventurewavelabs/turbo-flow -b main
cd turbo-flow
chmod +x devpods/setup.sh
./devpods/setup.sh
source ~/.bashrc
turbo-status
```

--------------------------------

### First Time Project Setup with TF Aliases

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Performs initial project setup tasks using Turbo Flow's command aliases, including Ruflo initialization, GitNexus analysis, and Beads initialization.

```bash
# Using TF aliases:
rf-init               # Initialize Ruflo
gnx-analyze           # Build codebase knowledge graph
bd init               # Initialize Beads task tracker
hooks-train           # Pretrain Ruflo on this codebase
```

--------------------------------

### Install DevPod on Windows

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Installs DevPod on Windows using Chocolatey. It then sets up the Turbo Flow project.

```bash
# Windows
choco install devpod
devpod up https://github.com/marcuspat/turbo-flow --ide vscode
```

--------------------------------

### Create and Edit boot.sh for Codespace Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/github_codespaces_setup.md

This command creates a boot.sh file and makes it executable, preparing it to receive the setup script for Turbo Flow in GitHub Codespaces.

```bash
touch boot.sh && chmod +x boot.sh && vi boot.sh
```

--------------------------------

### Post-Setup Shell Reload and Verification

Source: https://github.com/marcuspat/turbo-flow/blob/main/README.md

Steps to reload the shell and verify the installation after setup. Run `source ~/.bashrc` to reload the shell.

```bash
# 1. Reload shell
source ~/.bashrc

# 2. Verify installation
turbo-status

# 3. Get help
turbo-help

# 4. Run post-setup verification (13 checks)
# ./devpods/post-setup.sh
```

--------------------------------

### GitHub Codespaces Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Describes the automated setup process for Turbo Flow when using GitHub Codespaces. The .devcontainer configuration automatically runs the setup script.

```text
Push to GitHub → Open in Codespace → .devcontainer runs automatically.
The devpods/setup.sh script installs the complete stack.
```

--------------------------------

### Initialize Ruflo Project Interactively

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Use this command for an interactive project setup with Ruflo.

```bash
npx ruflo@latest init --wizard
```

--------------------------------

### Install DevPod on Linux

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Installs DevPod on Linux by downloading the binary and placing it in the local bin directory. It then sets up the Turbo Flow project.

```bash
# Linux
curl -L -o devpod "https://github.com/loft-sh/devpod/releases/latest/download/devpod-linux-amd64"
sudo install devpod /usr/local/bin
devpod up https://github.com/marcuspat/turbo-flow --ide vscode
```

--------------------------------

### Install flyctl on Windows

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Install the Fly.io CLI tool on Windows using PowerShell.

```powershell
pwsh -Command "iwr https://fly.io/install.ps1 -useb | iex"
```

--------------------------------

### Manual Turbo Flow Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/README.md

Clones the Turbo Flow repository, sets up the v4 environment, and sources the bashrc.

```bash
git clone https://github.com/marcuspat/turbo-flow -b main
cd turbo-flow/v4
chmod +x .devcontainer/setup-turboflow-4.sh
./.devcontainer/setup-turboflow-4.sh
source ~/.bashrc
turbo-status
```

--------------------------------

### Manual Infrastructure Setup

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Quick_Reference_Guide.md

Command for manual setup of Turbo Flow v4 on macOS/Linux systems.

```bash
cd turbo-flow/v4 && ./. devcontainer/setup-turboflow-4.sh
```

--------------------------------

### Install spotctl CLI on Linux/macOS

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Download and install the spotctl CLI binary for Linux or macOS. Ensure the binary is executable and moved to a directory in your system's PATH.

```bash
curl -LO https://github.com/rackspace-spot/spotctl/releases/latest/download/spotctl-linux-amd64
chmod +x spotctl-linux-amd64
sudo mv spotctl-linux-amd64 /usr/local/bin/spotctl
```

--------------------------------

### Install DevPod on Linux

Source: https://github.com/marcuspat/turbo-flow/blob/main/README.md

Downloads and installs the DevPod CLI tool for Linux systems.

```bash
curl -L -o devpod "https://github.com/loft-sh/devpod/releases/latest/download/devpod-linux-amd64"
sudo install devpod /usr/local/bin
```

--------------------------------

### Start GitNexus Web UI

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Starts the web-based user interface for GitNexus.

```bash
gnx-serve
```

--------------------------------

### Run Linux Installer Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/macosx_linux_setup.md

Execute the boot script for Linux to install dependencies and configure the environment.

```bash
./boot_linux.sh
```

--------------------------------

### Show Ready Tasks for Session Start

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Displays tasks that are ready to be worked on at the start of a session. Use --json for programmatic output.

```bash
bd ready --json
```

--------------------------------

### Verify Claude Flow Installation

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/DEVELOPMENT_GUIDE.md

Checks the current status of the Claude Flow installation. Run this after initialization to confirm setup.

```bash
npx claude-flow status
```

--------------------------------

### Initial Project Setup and Database Migration

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/SPARC_Methodology_Example.md

Commands to create a PostgreSQL database, navigate to the backend directory, and run database migrations and seeding.

```bash
createdb attendance_fleet_db
cd backend
npx sequelize-cli db:migrate
npx sequelize-cli db:seed:all
```

--------------------------------

### Set Up Project Structure

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/DEVELOPMENT_GUIDE.md

Command to create a complete development environment, including project structure, package.json, and Docker configuration.

```bash
npx claude-flow swarm "Set up complete development environment with project structure, package.json, Docker configuration" --claude --parallel
```

--------------------------------

### Manual Turbo Flow Installation

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Installs Turbo Flow manually by cloning the repository, making the setup script executable, running it, and sourcing the bashrc file.

```bash
git clone https://github.com/marcuspat/turbo-flow -b main
cd turbo-flow
chmod +x devpods/setup.sh
./devpods/setup.sh
source ~/.bashrc
turbo-status
```

--------------------------------

### Session Protocol - Start

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

The initial steps to begin a work session, including loading project state, reviewing native tasks, and ensuring AgentDB is active.

```bash
bd ready --json → Review Native Tasks → AgentDB loads automatically
```

--------------------------------

### Verify Codex Installation and Login Status

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

After setup, confirm Codex is installed correctly and authenticated. These commands check the version, login status, and execution capabilities.

```bash
codex --version
```

```bash
codex login status
```

```bash
codex exec -p claude "any command"
```

--------------------------------

### Install Prometheus Monitoring Stack

Source: https://github.com/marcuspat/turbo-flow/blob/main/Rackspace_Kubernetes_Cluster_Survival_Guide.md

Quickly set up Prometheus for monitoring using a Helm chart. This command adds the Prometheus community Helm repository and installs the kube-prometheus-stack.

```bash
# Quick Prometheus setup (if not already installed)
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm install prometheus prometheus-community/kube-prometheus-stack -n monitoring --create-namespace
```

--------------------------------

### Playwright Setup for UI Testing

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/UITEST.md

Basic Playwright setup for launching a browser, configuring context with HAR and video recording, and enabling tracing.

```javascript
const { chromium } = require('playwright');
const browser = await chromium.launch({ headless: true });
const context = await browser.newContext({
  recordHar: { path: 'uitest/har/session.har' },
  recordVideo: { dir: 'uitest/videos/' }
});
const page = await context.newPage();

// Enable tracing for failures
await context.tracing.start({ screenshots: true, snapshots: true, sources: true });

// Navigate and interact
await page.goto(TARGET_URL);
await page.fill('#email', 'test@uitest.local');
await page.click('button[type="submit"]');
await page.waitForURL('**/dashboard');

// Save trace on failure
await context.tracing.stop({ path: 'uitest/traces/test-name.zip' });
```

--------------------------------

### SSH into Fly.io Machine and Install Docker

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Access the Fly.io Machine via SSH and install Docker. This is a multi-step process.

```bash
fly ssh console --app devpod-workspace
# Inside the machine:
apt-get update && apt-get install -y docker.io
```

--------------------------------

### Get npm Global Directory

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

This command helps determine the npm global installation directory, which can indicate if sudo privileges are needed for global package installations.

```bash
npm config get prefix
```

--------------------------------

### Start: Load Mandatory Agents and Initialize

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/FEEDCLAUDE.md

Load mandatory agents first, then initialize the session using pre-task hooks.

```bash
# Load mandatory agents first
cat $WORKSPACE_FOLDER/agents/doc-planner.md
cat $WORKSPACE_FOLDER/agents/microtask-breakdown.md

# Initialize
npx claude-flow@alpha hooks pre-task --description "[task]"
npx claude-flow@alpha hooks session-restore --session-id "swarm-[id]"
```

--------------------------------

### Example User Request for Sorting Function

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/CCFOREVER.md

This is an example of a user request for a Python function to sort a list of integers. It serves as a starting point for the AI's task analysis.

--------------------------------

### Initialize a New Project with Ruflo

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Quick_Reference_Guide.md

Use `rf-wizard` to start a new project and then initialize various tools like Beads, OpenSpec, GitNexus, and worktrees.

```bash
rf-wizard
bd init
openspec init --tools claude
gitnexus analyze
wt-add main-dev
```

--------------------------------

### Setup Script for Turboflow v4.0.0

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/release_notes_4.0.0.md

This script handles the automated setup and cleanup required for migrating to Turboflow v4.0.0. It manages old aliases and configures new functionalities.

```bash
#!/bin/bash
# setup-turboflow-4.sh
# (771 lines, 10 steps)
```

--------------------------------

### Serve GitNexus Repository

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Quick_Reference_Guide.md

Start a server for the GitNexus repository using the `gnx-serve` alias.

```bash
npx gitnexus serve
```

--------------------------------

### Start a Fly.io Machine

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Resume a stopped Fly.io Machine.

```bash
fly machine start <machine-id> --app devpod-workspace
```

--------------------------------

### Full Feature Build Workflow

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Guides the end-to-end build of a feature using a comprehensive set of tools for setup, planning, building, and validation.

```bash
Build [feature name] end-to-end using all available tools:

SETUP:
- wt-add feat-[name] for isolated worktree
- bd-ready to load cross-session context
- gnx-analyze to understand current codebase

PLAN:
- OpenSpec: os-init then define the spec
- SPARC: specification → pseudocode → architecture
- Store plan in Beads

BUILD:
- rf-swarm with architect + 2 coders + tester
- TDD: write tests first, implement to pass
- Each agent in its own worktree

VALIDATE:
- aqe-gate for quality
- gnx-analyze for blast radius
- Security scan
- Performance profiling

SHIP:
- Code review (Agent Teams)
- bd-add to record decisions
- Update documentation
- wt-clean to remove worktrees
```

--------------------------------

### Initialize Ruflo Project

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Initializes a new Ruflo project.

```bash
npx ruflo@latest init
```

--------------------------------

### Example prd2build Execution

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/prd2build.md

Demonstrates a typical execution of the prd2build command, showing the initialization, agent spawning, and output generation process.

```bash
$ /prd2build ~/projects/my-project/prd.md

Initializing system...
✅ Directories created
✅ Memory initialized

Spawning documentation agents (8 parallel)...
→ Specification Analyst (researcher)
→ UX Designer (ui-designer)
→ Environment Setup (coder)
→ DDD Expert (code-analyzer)
→ System Architect (system-architect)
→ SPARC Coordinator (sparc-coord)
→ Implementation Planner (task-orchestrator)
→ Test Strategist (tester)
→ Documentation Integrator (planner)

⏳ Agents working... (this takes 5-10 minutes)

✅ All agents complete!

Generating unified index...
✅ INDEX.md created

Documentation complete! Generated:
- 1 environment startup script (start-env.sh)
- 8 specification files
- 11 DDD files (5 aggregates, 3 bounded contexts)
- 31 ADRs
- 6 SPARC files
- 4 milestones, 12 epics, 67 tasks
- 4 testing files
- 1 unified INDEX.md

🚀 Quick start: ./start-env.sh
📖 Start here: docs/README.md
🎯 Implementation guide: docs/implementation/INDEX.md
```

--------------------------------

### Build Full Application From Scratch Workflow

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

A comprehensive workflow for building a new application from initialization to deployment, utilizing a hierarchical swarm of specialized AI agents.

```bash
1. INITIALIZE:
   rf-wizard → bd init → os-init → Create dirs (src, tests, docs, scripts, config, plans)

2. PRD:
   Generate comprehensive PRD → plans/research/PLAN.md → aqe-gate

3. PLAN:
   Review /plans/research → create ADR/DDD → aqe-gate per ADR
   Update CLAUDE.md → update statusline → hooks-train → neural-train

4. SCAFFOLD (rf-swarm, hierarchical, 8 agents):
   Agent 1 (architect): project structure, configuration — does NOT write code
   Agent 2 (backend-coder): API, services, database
   Agent 3 (frontend-coder): UI, components, state management
   Agent 4 (auth-coder): authentication, authorization
   Agent 5 (tester): test suites for all layers — QA role
   Agent 6 (devops): CI/CD, Docker, deployment
   Agent 7 (documenter): API docs, README, architecture docs
   Agent 8 (security): security hardening, input validation

5. BUILD (iterative):
   - Each agent in its own worktree
   - SPARC TDD for all implementation
   - Beads for cross-agent coordination
   - AgentDB for pattern storage
   - aqe-gate per bounded context

6. VALIDATE:
   - aqe-gate: full codebase quality gate
   - gnx-analyze: dependency graph, no circular deps
   - Performance profiling (Perf Optimizer)
   - Security audit
   - Accessibility audit (UI UX Pro Max)

7. SHIP:
   - Agent Teams review
   - CI/CD pipeline green
   - Staging deployment + smoke tests
   - Production deployment
   - bd-add: record launch decisions and rollback plan
   - git tag -a v1.0.0
```

--------------------------------

### UI UX Pro Max Skill Activation

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

The UI UX Pro Max skill, providing component patterns, accessibility, responsive layouts, and design tokens, is automatically activated when describing UI/UX work. It is installed as part of the setup script.

```bash
# Installed as part of Step 4 of setup-turboflow-4.sh
# uipro-cli provides: component patterns, accessibility, responsive layouts, design tokens
# Auto-activated when describing UI/UX work — no manual invocation needed
```

--------------------------------

### Verify RuVector installation

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Checks if RuVector is installed and accessible. Run this after installation to confirm.

```bash
# Step 2: Verify installation
npx ruvector status
```

--------------------------------

### Build Backend and Frontend for Production

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/SPARC_Methodology_Example.md

Commands to build the backend and frontend applications for production deployment.

```bash
cd backend
npm run build
cd ../frontend
npm run build
```

--------------------------------

### Create Workspace on AWS (Spot Instance)

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Create a development workspace on AWS using a Spot Instance for potential cost savings. Set `spot-instance=true`.

```bash
devpod up https://github.com/your/repo --provider aws --option spot-instance=true
```

--------------------------------

### Install DevPod on macOS

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Installs DevPod using Homebrew for macOS users. After installation, it can be used to set up the Turbo Flow project.

```bash
# macOS
brew install loft-sh/devpod/devpod
devpod up https://github.com/marcuspat/turbo-flow --ide vscode
```

--------------------------------

### Verify RuVector Installation

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Checks if the RuVector CLI has been installed correctly. Run this command after installation to confirm the CLI is accessible and operational.

```bash
npx ruvector status
```

--------------------------------

### Verify Codex Installation (Linux)

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

After installation on Linux, use 'which codex' to find its path and 'codex --version' to confirm the installation and version.

```bash
which codex
codex --version
```

--------------------------------

### Onboard Existing Codebase

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Steps to onboard a new agent to an existing repository. Utilizes various tools for analysis, documentation generation, pre-training, and learning codebase conventions. Requests an architecture summary, dependencies, hot paths, and technical debt.

```bash
Onboard me on [repo]:
1. gitnexus analyze — knowledge graph
2. gitnexus wiki — generate documentation
3. hooks-train — pretrain on codebase
4. bd init && bd ready --json — task state
5. neural-train && neural-patterns — learn conventions
6. Code Intelligence: identify architecture, tech debt, test gaps
Give me: architecture summary, dependencies, hot paths, technical debt.
```

--------------------------------

### Onboard a New Agent with Beads

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Performs the first-time onboarding process for an agent using Beads.

```bash
bd onboard
```

--------------------------------

### Find Codex Installation Path on macOS

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

Use 'which codex' to find the installation path. If not found, use 'brew --prefix codex' for Homebrew installations.

```bash
which codex
```

```bash
brew --prefix codex
```

--------------------------------

### Start GitNexus MCP Server

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Starts the MCP server for GitNexus.

```bash
gitnexus mcp
```

--------------------------------

### Environment Bootstrap Sequence

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/UITEST.md

Execute this bash script to set up the testing environment, install necessary tools, and initialize the workspace.

```bash
# 1. Pre-flight
source ~/.bashrc
rf-doctor
bd ready --json
gnx-analyze
turbo-status

# 2. Install Playwright + dependencies
npm init -y 2>/dev/null
npm install playwright @playwright/test
npx playwright install --with-deps chromium firefox webkit

# 3. Install supplemental tools
npm install axe-core       # Accessibility auditing
npm install lighthouse      # Performance auditing (optional)
npm install sharp           # Screenshot diffing

# 4. Install RuVector self-learning hooks + AgentDB
npx @ruvector/cli hooks init
npx @ruvector/cli hooks install
npm install ruvector 2>/dev/null  # SONA learning engine for test pattern adaptation

# 5. Create workspace structure
mkdir -p uitest/{reports/bugs,screenshots,fixtures,traces,har,videos,trajectories}
mkdir -p uitest/specs/{discovery,forms,auth,navigation,api,a11y,load,regression}
mkdir -p uitest/fixes

# 6. Initialize Beads for test tracking
bd init 2>/dev/null
bd create "UITEST: Full UAT Campaign" -t epic -p 0

# 7. Initialize SONA/AgentDB memory for test patterns
ruv-remember "uitest-session-start" "$(date -Iseconds)"
mem-search "uitest" 2>/dev/null  # Recall patterns from prior sessions
```

--------------------------------

### Initialize New Project with Ruflo

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Initializes a new project using Ruflo's wizard and related tools. This includes setting up a task tracker, OpenSpec, knowledge graph, and primary worktree.

```shell
Initialize a new project with Ruflo. Run rf-wizard, then:
1. bd init — initialize Beads task tracker
2. openspec init --tools claude — initialize OpenSpec
3. gitnexus analyze — build knowledge graph
4. wt-add main-dev — create primary worktree
Scaffold a [Next.js/Express/FastAPI] app with src/, tests/, docs/, scripts/, config/, plans/.
Use a hierarchical swarm with architect, coder, and tester agents.
```

--------------------------------

### Install Claude Code and Claude Flow CLI Tools

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/QA_DEVELOPMENT_GUIDE.md

Installs the necessary command-line tools for Claude Code and Claude Flow, including the global installation of `@anthropic-ai/claude-code` and `claude-flow@alpha`.

```bash
# Install Claude Code globally (required)
npm install -g @anthropic-ai/claude-code

# Install Claude Flow alpha
npm install -g claude-flow@alpha

# Initialize project with force flag
npx claude-flow@alpha init --force
```

--------------------------------

### List Installed Ruflo Plugins

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Displays a list of all installed Ruflo plugins.

```bash
npx ruflo@latest plugins list
```

--------------------------------

### Initialize DevPod with a GitHub repository

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

This command initializes a DevPod environment by cloning a specified GitHub repository and configuring it for VS Code.

```bash
devpod up https://github.com/marcuspat/turbo-flow --ide vscode
```

--------------------------------

### Start Ruflo Daemon Workers

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Starts the background worker processes for Ruflo.

```bash
npx ruflo@latest daemon start
```

--------------------------------

### Install flyctl on macOS

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Install the Fly.io CLI tool on macOS using Homebrew.

```bash
brew install flyctl
```

--------------------------------

### Generate Environment Setup Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/prd2build.md

Reads a PRD to extract technology stack information and generates a `start-env.sh` script to launch all required development services with health checks and graceful shutdown.

```Bash
#!/bin/bash

```

--------------------------------

### Set Up CI/CD Pipeline

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/DEVELOPMENT_GUIDE.md

Sets up a comprehensive CI/CD pipeline, including testing, security scans, and deployment. Automates the software delivery process.

```bash
npx claude-flow github gh-coordinator "setup comprehensive CI/CD with testing, security scans, and deployment" --auto-approve
```

--------------------------------

### Initialize OpenSpec

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Initializes the OpenSpec system.

```bash
os-init
```

--------------------------------

### Start All ForgeCMS Services Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/prd2build.md

This script sequentially starts essential ForgeCMS services. It includes echo statements for user feedback and placeholders for service-specific start commands. Ensure all dependencies are met before execution.

```shell
set -e

echo "🚀 Starting ForgeCMS services..."

# Start PostgreSQL
echo "📊 Starting PostgreSQL on port 5432..."
# Add service-specific start command

# Start Redis
echo "⚡ Starting Redis on port 6379..."
# Add service-specific start command

# Start Backend (Rust + Loco)
echo "🦀 Starting backend on port 5843..."
# Add service-specific start command

# Start Frontend (React + Vite)
echo "⚛️  Starting frontend on port 3000..."

```

--------------------------------

### Example Subagent Prompt for Email Validation

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/CCFOREVER.md

This example demonstrates a prompt for a subagent tasked with implementing an email validation function in Python. It specifies the task, context, success criteria, and provides before/after code examples.

```python
def is_valid_email(email):
 import re
 pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
 return bool(re.match(pattern, email))
```

--------------------------------

### Bootstrapping Session with Native Commands

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Quick_Reference_Guide.md

Source the bashrc and run essential commands using their native Ruflo and GitNexus commands for session setup.

```bash
source ~/.bashrc
bd ready --json
npx gitnexus analyze
npx ruflo@latest doctor --fix
npx ruflo@latest hooks pretrain
npx ruflo@latest daemon start
```

--------------------------------

### Install Codex via Homebrew

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

Use this command to install Codex on macOS if Homebrew is available.

```bash
brew install codex
```

--------------------------------

### Create VM CloudSpace with spotctl

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Create a VM CloudSpace using the spotctl CLI. Specify the VM name, region, organization, and on-demand nodepool configuration including server class and desired count.

```bash
spotctl cloudspaces create \
  --name devpod-vm \
  --region us-central-dfw-1 \
  --org your-org-name \
  --ondemand-nodepool "serverclass=gp.vs1.large-dfw,desired=1"
```

--------------------------------

### Check Git Installation (Windows)

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

Execute this command in PowerShell on Windows to verify if Git is installed.

```powershell
git --version
```

--------------------------------

### Quick Copy-Paste Boot Sequence (Native Commands)

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

A consolidated command sequence using native Ruflo and other commands to initialize the environment, run diagnostics, and start essential services.

```bash
# Using native commands:
source ~/.bashrc && npx ruflo@latest init --wizard && npx ruflo@latest doctor --fix && bd ready --json && npx gitnexus analyze && npx ruflo@latest hooks pretrain && npx ruflo@latest daemon start
```

--------------------------------

### Install DevPod on Windows

Source: https://github.com/marcuspat/turbo-flow/blob/main/README.md

Installs the DevPod CLI tool using Chocolatey for Windows users.

```powershell
choco install devpod
```

--------------------------------

### Install DevPod on macOS

Source: https://github.com/marcuspat/turbo-flow/blob/main/README.md

Installs the DevPod CLI tool using Homebrew for macOS users.

```bash
brew install loft-sh/devpod/devpod
```

--------------------------------

### CI/CD Pipeline Setup Prompt

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Use this prompt to define a CI/CD pipeline structure. Specify the project, stages, and target platform.

```markdown
Create a CI/CD pipeline for [project]:
1. Build stage: compile, lint, type-check
2. Test stage: unit, integration, e2e (parallel)
3. Security stage: dependency scan, SAST, secrets check
4. Quality gate: aqe-gate thresholds
5. Deploy stage: staging → smoke tests → production
6. Monitoring: health checks, alerting

Target platform: [GitHub Actions / GitLab CI / etc.]
Use SPARC DevOps mode for infrastructure design.
Store pipeline decisions in Beads.
```

--------------------------------

### Daily Development Cycle Commands

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/SPARC_Methodology_Example.md

Commands for setting up the development environment, running tests in watch mode, and starting backend and frontend development servers.

```bash
docker-compose up -d
npm run test:watch
cd backend && npm run dev
cd frontend && npm start
```

--------------------------------

### Troubleshooting 'codex: command not found' on macOS

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

If Codex is not found after installation via Homebrew, try linking it. If installed via npm, ensure your PATH is configured correctly. Use 'which codex' to verify the installation path.

```bash
brew link codex
```

```bash
which codex
```

--------------------------------

### Turbo Flow Codespace Setup Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/github_codespaces_setup.md

This bash script automates the setup of Turbo Flow in GitHub Codespaces. It clones the repository, moves necessary directories, makes scripts executable, and runs the main setup script.

```bash
#!/bin/bash
# Clone the repository
echo "Cloning repository..."
git clone https://github.com/marcuspat/turbo-flow-claude.git

# Check if clone was successful
if [ $? -ne 0 ]; then
    echo "Error: Failed to clone repository"
    exit 1
fi

# Navigate into the cloned directory
cd turbo-flow-claude

# Move devpods directory to parent directory
echo "Moving devpods directory..."
mv devpods ..

# Go back to parent directory
cd ..

# Remove the cloned repository
echo "Removing turbo-flow-claude directory..."
rm -rf turbo-flow-claude

# Make all shell scripts in devpods executable
echo "Making scripts executable..."
chmod +x ./devpods/*.sh

# Run the setup script
echo "Running codespace_setup.sh..."
./devpods/codespace_setup.sh

echo "Script completed!"
```

--------------------------------

### Create Project Directory Structure

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/DEVELOPMENT_GUIDE.md

Sets up the standard directory structure for a new SaaS platform project. This includes common folders like src, docs, tests, config, and scripts.

```bash
mkdir -p ~/my-saas-platform/{src,docs,tests,config,scripts}
cd ~/my-saas-platform
```

--------------------------------

### Install RuVector for final recommendation

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Installs RuVector globally. This is a prerequisite for enabling advanced features as recommended.

```bash
npm install -g ruvector
claude-flow doctor  # Verify detection
```

--------------------------------

### Core Loop: Customize

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Steps for customizing the project environment, including updating documentation and training hooks.

```bash
update CLAUDE.md → update statusline → hooks-train → gnx-analyze → aqe-gate
```

--------------------------------

### Enable RuVector and Sona Features

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Setup commands for advanced integration, enabling RuVector and specific neural features like Sona.

```bash
npm install ruvector
claude-flow memory init
claude-flow config set ruvector.enabled true
claude-flow config set neural.sona true
```

--------------------------------

### Short Version: Execute Ready Beads

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Quick_Reference_Guide.md

Executes all ready beads in dependency order without stopping between items. Includes AQE gates after each context and a summary at the end.

```shell
Execute all ready beads in dependency order. Don't stop between items. aqe-gate after each context. Summary at end.
```

--------------------------------

### Run macOS Installer Script

Source: https://github.com/marcuspat/turbo-flow/blob/main/macosx_linux_setup.md

Execute the boot script for macOS to install dependencies and configure the environment.

```bash
./boot_macosx.sh
```

--------------------------------

### Core Loop: Bootstrapping

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

The initial setup sequence for Turbo Flow. Includes sourcing bashrc, running diagnostics, and initializing core components.

```bash
source ~/.bashrc → rf-doctor (npx ruflo doctor --fix) → bd ready → gnx-analyze (npx gitnexus analyze) → hooks-train (npx ruflo hooks pretrain) → rf-daemon (npx ruflo daemon start) → turbo-status
```

--------------------------------

### Worktree Setup for Agents

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/UITEST.md

Creates git worktrees for each specialized testing agent as part of the swarm setup.

```bash
# qa-lead creates worktrees for all agents
for agent in crawler form-tester auth-tester nav-tester api-verifier a11y-tester load-tester regression-tester; do
  wt-add $agent
done
```

--------------------------------

### Store Launch Checklist

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/DEVELOPMENT_GUIDE.md

Store the completed launch readiness checklist in memory.

```bash
npx claude-flow memory store "launch_readiness" "Launch preparation completed: deployment verified, monitoring active, support ready"
```

--------------------------------

### Install RuVector

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Installs RuVector globally using npm. This is the first step to enabling optional advanced features.

```bash
# Step 1: Install RuVector
npm install -g ruvector
```

--------------------------------

### Installing Ruflo Plugins

Source: https://github.com/marcuspat/turbo-flow/blob/main/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Install a specific Ruflo plugin by name. Use 'rf-plugins' to check available plugins first.

```bash
npx ruflo@latest plugins install -n <name>
```

--------------------------------

### Install Codex CLI (Windows)

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

Execute this npm command in an administrator PowerShell to install the Codex CLI globally on Windows.

```powershell
npm install -g "@openai/codex"
```

--------------------------------

### Bootstrapping Session with TF Aliases

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Quick_Reference_Guide.md

Source the bashrc and run essential commands using Turbo Flow aliases for session setup.

```bash
source ~/.bashrc
bd ready --json          # (native: bd ready --json)
gnx-analyze              # (native: npx gitnexus analyze)
turbo-status             # (TF-specific)
```

--------------------------------

### Onboard New Codebase

Source: https://github.com/marcuspat/turbo-flow/blob/main/fixes-backup-20260319-223343/V4_Turbo Flow v4 + Ruflo v3.5 — The Definitive Prompt & Workflow Guide.md

Onboard a new codebase by initializing the Turbo Flow environment, building the knowledge graph, generating documentation, and training AI models. This process includes setting up the environment, analyzing the repository, and identifying key architectural elements and technical debt.

```bash
Run setup-turboflow-4.sh (or rf-init if TF already installed)
gitnexus analyze
gitnexus wiki
gitnexus serve
hooks-train
bd init
bd ready --json
neural-train
neural-patterns
Use Code Intelligence plugin to identify: architecture patterns, 
    bounded contexts, technical debt, test coverage gaps
Generate a CLAUDE.md summarizing architecture, patterns, and conventions
```

--------------------------------

### Initialize Build State Tracking

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/prd2build.md

Sets up memory tracking for the build process, including the current milestone, total milestones, and overall build status.

```Bash
npx @claude-flow/cli@latest memory store --key 'build/milestone' --value 'M0' --namespace build 2>/dev/null || true
npx @claude-flow/cli@latest memory store --key 'build/total_milestones' --value '4' --namespace build 2>/dev/null || true
npx @claude-flow/cli@latest memory store --key 'build/status' --value 'in_progress' --namespace build 2>/dev/null || true
```

--------------------------------

### Setup RuVector Postgres and AgentDB

Source: https://github.com/marcuspat/turbo-flow/blob/main/AGENTDB-VS-RUVECTOR.md

Enterprise-level setup involving RuVector Postgres for centralized state and configuring AgentDB to use it as a backend.

```bash
docker run -d ruvnet/ruvector-postgres
claude-flow config set memory.backend postgres
npm install ruvector
```

--------------------------------

### Install Codex via npm

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpods/context/codex_claude.md

Install Codex globally using npm if Homebrew is not an option. Ensure you check the npm prefix first.

```bash
npm config get prefix
```

```bash
npm install -g @openai/codex
```

--------------------------------

### Initialize Terraform with Spot Provider

Source: https://github.com/marcuspat/turbo-flow/blob/main/devpod_provider_setup_guide.md

Initializes a Terraform working directory, downloading the Rackspace Spot provider. This is the first step in managing infrastructure with Terraform.

```bash
# Initialize Terraform with the Spot provider
terraform init
```