maestro-flow 0.1.0 → 0.1.2

package/.codex/skills/team-coordinate/SKILL.md

@@ -28,8 +28,8 @@ Universal team coordination skill: analyze task -> generate role-specs -> dispat
   (roles generated at runtime from task analysis)
 
   CLI Tools (callable by any worker):
-    ccw cli --mode analysis  - analysis and exploration
-    ccw cli --mode write     - code generation and modification
+    maestro cli --mode analysis  - analysis and exploration
+    maestro cli --mode write     - code generation and modification
 ```
 
 ## Delegation Lock
@@ -48,7 +48,7 @@ Before calling ANY tool, apply this check:
 | `Read` on `roles/`, `commands/`, `specs/` | ALLOWED | Loading own instructions |
 | `Read/Grep/Glob` on project source code | BLOCKED | Delegate to worker |
 | `Edit` on any file outside `.workflow/` | BLOCKED | Delegate to worker |
-| `Bash("ccw cli ...")` | BLOCKED | Only workers call CLI |
+| `Bash("maestro cli ...")` | BLOCKED | Only workers call CLI |
 | `Bash` running build/test/lint commands | BLOCKED | Delegate to worker |
 
 **If a tool call is BLOCKED**: STOP. Create a task, spawn a worker.
@@ -65,8 +65,8 @@ Before calling ANY tool, apply this check:
 | Session path | `.workflow/.team/TC-<slug>-<date>/` |
 | Worker agent | `team-worker` |
 | Message bus | `mcp__maestro-tools__team_msg(session_id=<session-id>, ...)` |
-| CLI analysis | `ccw cli --mode analysis` |
-| CLI write | `ccw cli --mode write` |
+| CLI analysis | `maestro cli --mode analysis` |
+| CLI write | `maestro cli --mode write` |
 | Max roles | 5 |
 
 ## Role Router
@@ -92,8 +92,8 @@ Workers can use CLI tools for analysis and code operations:
 
 | Tool | Purpose |
 |------|---------|
-| ccw cli --mode analysis | Analysis, exploration, pattern discovery |
-| ccw cli --mode write | Code generation, modification, refactoring |
+| maestro cli --mode analysis | Analysis, exploration, pattern discovery |
+| maestro cli --mode write | Code generation, modification, refactoring |
 
 ### Dispatch
 

package/.codex/skills/team-coordinate/roles/coordinator/role.md

@@ -18,7 +18,7 @@ Orchestrate the team-coordinate workflow: task analysis, dynamic role-spec gener
 ```
 WRONG: Read("src/components/Button.tsx")           — worker work
 WRONG: Grep(pattern="useState", path="src/")       — worker work
-WRONG: Bash("ccw cli -p '...' --tool gemini")      — worker work
+WRONG: Bash("maestro cli -p '...' --tool gemini")      — worker work
 WRONG: Edit("src/utils/helper.ts", ...)             — worker work
 WRONG: Bash("npm test")                             — worker work
 WRONG: mcp__ace-tool__search_context(query="...")   — worker work

package/.codex/skills/team-lifecycle-v4/SKILL.md

@@ -71,7 +71,7 @@ Before calling ANY tool, apply this check:
 | `Read` on `roles/`, `commands/`, `specs/`, `templates/` | ALLOWED | Loading own instructions |
 | `Read/Grep/Glob` on project source code | BLOCKED | Delegate to worker |
 | `Edit` on any file outside `.workflow/` | BLOCKED | Delegate to worker |
-| `Bash("ccw cli ...")` | BLOCKED | Only workers call CLI |
+| `Bash("maestro cli ...")` | BLOCKED | Only workers call CLI |
 | `Bash` running build/test/lint commands | BLOCKED | Delegate to worker |
 
 **If a tool call is BLOCKED**: STOP. Create a task, spawn a worker.
@@ -86,7 +86,7 @@ Before calling ANY tool, apply this check:
 - **Session path**: `.workflow/.team/TLV4-<slug>-<date>/`
 - **State file**: `<session>/tasks.json`
 - **Discovery files**: `<session>/discoveries/{task_id}.json`
-- **CLI tools**: `ccw cli --mode analysis` (read-only), `ccw cli --mode write` (modifications)
+- **CLI tools**: `maestro cli --mode analysis` (read-only), `maestro cli --mode write` (modifications)
 
 ## Worker Spawn Template
 

package/.codex/skills/team-lifecycle-v4/instructions/agent-instruction.md

@@ -27,7 +27,7 @@ This instruction is loaded by team-worker agents when spawned with roles: `analy
 
 2. **Explore domain** (use CLI analysis tools):
    ```bash
-   ccw cli -p "PURPOSE: Research domain for {requirement}
+   maestro cli -p "PURPOSE: Research domain for {requirement}
    TASK: • Identify problem statement • Define target users • Extract constraints • Map integration points
    CONTEXT: @**/* | Memory: {requirement}
    EXPECTED: Structured research context with problem/users/domain/constraints
@@ -294,7 +294,7 @@ This instruction is loaded by team-worker agents when spawned with roles: `analy
 
 2. **Explore codebase** (use CLI analysis tools):
    ```bash
-   ccw cli -p "PURPOSE: Explore codebase for {requirement}
+   maestro cli -p "PURPOSE: Explore codebase for {requirement}
    TASK: • Identify relevant files • Find existing patterns • Locate integration points
    CONTEXT: @**/* | Memory: {requirement}
    EXPECTED: Exploration findings with file paths and patterns

package/.codex/skills/team-lifecycle-v4/roles/analyst/role.md

@@ -36,7 +36,7 @@ Research and codebase exploration for context gathering.
 4. If topic references file (@path or .md/.txt) -> read it
 5. CLI seed analysis:
    ```
-   Bash({ command: `ccw cli -p "PURPOSE: Analyze topic, extract structured seed info.
+   Bash({ command: `maestro cli -p "PURPOSE: Analyze topic, extract structured seed info.
    TASK: * Extract problem statement * Identify target users * Determine domain
    * List constraints * Identify 3-5 exploration dimensions
    TOPIC: <topic-content>
@@ -54,7 +54,7 @@ Research and codebase exploration for context gathering.
 
 When project detected:
 ```
-Bash({ command: `ccw cli -p "PURPOSE: Explore codebase for context
+Bash({ command: `maestro cli -p "PURPOSE: Explore codebase for context
 TASK: * Identify tech stack * Map architecture patterns * Document conventions * List integration points
 MODE: analysis
 CONTEXT: @**/*

package/.codex/skills/team-lifecycle-v4/roles/coordinator/role.md

@@ -14,7 +14,7 @@ Orchestrate team-lifecycle-v4: analyze -> dispatch -> spawn -> monitor -> report
 ```
 WRONG: Read("src/...")                              — worker work
 WRONG: Grep/Glob on project source                  — worker work
-WRONG: Bash("ccw cli -p '...' --tool gemini")       — worker work
+WRONG: Bash("maestro cli -p '...' --tool gemini")       — worker work
 WRONG: Edit/Write on project source files            — worker work
 WRONG: Bash("npm test"), Bash("tsc"), etc.           — worker work
 ```
@@ -47,7 +47,7 @@ WRONG: Bash("npm test"), Bash("tsc"), etc.           — worker work
 - Modify task output artifacts
 - Spawn workers with general-purpose agent (MUST use tlv4_worker)
 - Generate more than 5 worker roles
-- Call CLI tools (ccw cli) — only workers use CLI
+- Call CLI tools (maestro cli) — only workers use CLI
 
 ## Command Execution Protocol
 When coordinator needs to execute a specific phase:

package/.codex/skills/team-lifecycle-v4/roles/executor/commands/implement.md

@@ -51,7 +51,7 @@ CONSTRAINTS: Only modify listed files | Follow existing patterns
 
 CLI call:
 ```
-Bash(`ccw cli -p "<prompt>" --tool <tool> --mode write --rule development-implement-feature`)
+Bash(`maestro cli -p "<prompt>" --tool <tool> --mode write --rule development-implement-feature`)
 ```
 
 Resume strategy:

package/.codex/skills/team-lifecycle-v4/roles/planner/role.md

@@ -36,7 +36,7 @@ Codebase-informed implementation planning with complexity assessment.
 3. Check <session>/explorations/cache-index.json for cached explorations
 4. Explore codebase (cache-aware):
    ```
-   Bash({ command: `ccw cli -p "PURPOSE: Explore codebase to inform planning
+   Bash({ command: `maestro cli -p "PURPOSE: Explore codebase to inform planning
    TASK: * Search for relevant patterns * Identify files to modify * Document integration points
    MODE: analysis
    CONTEXT: @**/*
@@ -48,7 +48,7 @@ Codebase-informed implementation planning with complexity assessment.
 
 Generate plan.json + .task/TASK-*.json:
 ```
-Bash({ command: `ccw cli -p "PURPOSE: Generate implementation plan from exploration results
+Bash({ command: `maestro cli -p "PURPOSE: Generate implementation plan from exploration results
 TASK: * Create plan.json overview * Generate TASK-*.json files (2-7 tasks) * Define dependencies * Set convergence criteria
 MODE: write
 CONTEXT: @<session>/explorations/*.json

package/.codex/skills/team-lifecycle-v4/roles/writer/role.md

@@ -61,7 +61,7 @@ Template-driven document generation with progressive dependency loading.
 
 CLI generation:
 ```
-Bash({ command: `ccw cli -p "PURPOSE: Generate <doc-type> document following template
+Bash({ command: `maestro cli -p "PURPOSE: Generate <doc-type> document following template
 TASK: * Load template * Apply spec config and discovery context * Integrate prior feedback * Generate all sections
 MODE: write
 CONTEXT: @<session>/spec/*.json @<template-path>

package/.codex/skills/team-lifecycle-v4/schemas/tasks-schema.md

@@ -1,6 +1,6 @@
 # Tasks Schema — team-lifecycle-v4
 
-> Base schema: `~/.ccw/workflows/cli-templates/schemas/team-tasks-schema.json`
+> Base schema: `~/.maestro/templates/cli/schemas/team-tasks-schema.json`
 
 This file documents lifecycle-v4 specific extensions to the universal team tasks schema.
 

package/.codex/skills/team-quality-assurance/SKILL.md

@@ -63,7 +63,7 @@ Before calling ANY tool, apply this check:
 | `Read` on `roles/`, `commands/`, `specs/` | ALLOWED | Loading own instructions |
 | `Read/Grep/Glob` on project source code | BLOCKED | Delegate to worker |
 | `Edit` on any file outside `.workflow/` | BLOCKED | Delegate to worker |
-| `Bash("ccw cli ...")` | BLOCKED | Only workers call CLI |
+| `Bash("maestro cli ...")` | BLOCKED | Only workers call CLI |
 | `Bash` running build/test/lint commands | BLOCKED | Delegate to worker |
 
 **If a tool call is BLOCKED**: STOP. Create a task, spawn a worker.
@@ -77,7 +77,7 @@ Before calling ANY tool, apply this check:
 - **Session prefix**: `QA`
 - **Session path**: `.workflow/.team/QA-<slug>-<date>/`
 - **Team name**: `quality-assurance`
-- **CLI tools**: `ccw cli --mode analysis` (read-only), `ccw cli --mode write` (modifications)
+- **CLI tools**: `maestro cli --mode analysis` (read-only), `maestro cli --mode write` (modifications)
 - **Message bus**: `mcp__maestro-tools__team_msg(session_id=<session-id>, ...)`
 
 ## Worker Spawn Template

package/.codex/skills/team-quality-assurance/roles/coordinator/role.md

@@ -12,7 +12,7 @@ Orchestrate team-quality-assurance: analyze -> dispatch -> spawn -> monitor -> r
 **FORBIDDEN** (even if the task seems trivial):
 ```
 WRONG: Read/Grep/Glob on project source code        — worker work
-WRONG: Bash("ccw cli ...")                           — worker work
+WRONG: Bash("maestro cli ...")                           — worker work
 WRONG: Edit/Write on project source files            — worker work
 WRONG: Bash("npm test"), Bash("tsc"), etc.           — worker work
 ```
@@ -45,7 +45,7 @@ WRONG: Bash("npm test"), Bash("tsc"), etc.           — worker work
 - Modify test files or source code
 - Spawn workers with general-purpose agent (MUST use team-worker)
 - Generate more than 6 worker roles
-- Call CLI tools (ccw cli) — only workers use CLI
+- Call CLI tools (maestro cli) — only workers use CLI
 
 ## Command Execution Protocol
 When coordinator needs to execute a specific phase:

package/.codex/skills/team-quality-assurance/roles/executor/role.md

@@ -26,7 +26,7 @@ Run test suites, collect coverage data, and perform automatic fix cycles when te
 | Target layer | task description `layer: L1/L2/L3` | Yes |
 
 1. Extract session path and target layer from task description
-2. Load validation specs: Run `ccw spec load --category validation` for verification rules and acceptance criteria
+2. Load validation specs: Run `maestro spec load --category validation` for verification rules and acceptance criteria
 3. Read .msg/meta.json for strategy and generated test file list
 3. Detect test command by framework:
 

package/.codex/skills/team-quality-assurance/roles/scout/role.md

@@ -39,7 +39,7 @@ Scan codebase from multiple perspectives (bug, security, test-coverage, code-qua
 
 **Low complexity**: Use `mcp__ace-tool__search_context` for quick pattern-based scan.
 
-**Medium/High complexity**: CLI fan-out -- one `ccw cli --mode analysis` per perspective:
+**Medium/High complexity**: CLI fan-out -- one `maestro cli --mode analysis` per perspective:
 
 For each active perspective, build prompt:
 ```
@@ -50,7 +50,7 @@ CONTEXT: @<scan-scope>
 EXPECTED: List of findings with severity (critical/high/medium/low), file:line references, description
 CONSTRAINTS: Focus on actionable findings only
 ```
-Execute via: `ccw cli -p "<prompt>" --tool gemini --mode analysis`
+Execute via: `maestro cli -p "<prompt>" --tool gemini --mode analysis`
 
 After all perspectives complete:
 - Parse CLI outputs into structured findings

package/.codex/skills/team-review/SKILL.md

@@ -61,7 +61,7 @@ Before calling ANY tool, apply this check:
 | `Read` on `roles/`, `commands/`, `specs/` | ALLOWED | Loading own instructions |
 | `Read/Grep/Glob` on project source code | BLOCKED | Delegate to worker |
 | `Edit` on any file outside `.workflow/` | BLOCKED | Delegate to worker |
-| `Bash("ccw cli ...")` | BLOCKED | Only workers call CLI |
+| `Bash("maestro cli ...")` | BLOCKED | Only workers call CLI |
 | `Bash` running build/test/lint commands | BLOCKED | Delegate to worker |
 
 **If a tool call is BLOCKED**: STOP. Create a task, spawn a worker.
@@ -75,7 +75,7 @@ Before calling ANY tool, apply this check:
 - **Session prefix**: `RV`
 - **Session path**: `.workflow/.team/RV-<slug>-<date>/`
 - **Team name**: `review`
-- **CLI tools**: `ccw cli --mode analysis` (read-only), `ccw cli --mode write` (modifications)
+- **CLI tools**: `maestro cli --mode analysis` (read-only), `maestro cli --mode write` (modifications)
 - **Message bus**: `mcp__maestro-tools__team_msg(session_id=<session-id>, ...)`
 
 ## Worker Spawn Template

package/.codex/skills/team-review/roles/coordinator/role.md

@@ -12,7 +12,7 @@ Orchestrate team-review: parse target -> detect mode -> dispatch task chain -> m
 **FORBIDDEN** (even if the task seems trivial):
 ```
 WRONG: Read/Grep/Glob on project source code        — worker work
-WRONG: Bash("ccw cli ...")                           — worker work
+WRONG: Bash("maestro cli ...")                           — worker work
 WRONG: Bash("semgrep/eslint/tsc ...")                — worker work
 WRONG: Edit/Write on project source files            — worker work
 ```
@@ -45,7 +45,7 @@ WRONG: Edit/Write on project source files            — worker work
 - Perform code review or scanning directly
 - Bypass worker roles
 - Spawn workers with general-purpose agent (MUST use team_worker)
-- Call CLI tools (ccw cli) — only workers use CLI
+- Call CLI tools (maestro cli) — only workers use CLI
 
 ## Command Execution Protocol
 When coordinator needs to execute a specific phase:

package/.codex/skills/team-review/roles/reviewer/role.md

@@ -21,7 +21,7 @@ Deep analysis on scan findings: triage, root cause / impact / optimization enric
 | .msg/meta.json | <session>/.msg/meta.json | No |
 
 1. Extract session path, input path, dimensions from task description
-2. Load review specs: Run `ccw spec load --category review` for review standards, checklists, and approval gates
+2. Load review specs: Run `maestro spec load --category review` for review standards, checklists, and approval gates
 3. Load scan results. If missing or empty -> report clean, complete immediately
 3. Load wisdom files from `<session>/wisdom/`
 4. Triage findings into two buckets:
@@ -52,7 +52,7 @@ Build prompt per group requesting 6 enrichment fields per finding:
 - `fix_complexity`: low / medium / high
 - `fix_dependencies`: finding IDs that must be fixed first
 
-Execute via `ccw cli --tool gemini --mode analysis --rule analysis-diagnose-bug-root-cause` (fallback: qwen -> codex). Parse JSON array responses, merge with originals (CLI-enriched replace originals, unenriched get defaults). Write `<session>/review/enriched-findings.json`.
+Execute via `maestro cli --tool gemini --mode analysis --rule analysis-diagnose-bug-root-cause` (fallback: qwen -> codex). Parse JSON array responses, merge with originals (CLI-enriched replace originals, unenriched get defaults). Write `<session>/review/enriched-findings.json`.
 
 ## Phase 4: Report Generation
 

package/.codex/skills/team-review/roles/scanner/role.md

@@ -59,7 +59,7 @@ Build prompt with target file patterns, toolchain dedup summary, and per-dimensi
 - PRF: Algorithm complexity, N+1 queries, unnecessary sync, memory leaks, missing caching
 - MNT: Architectural coupling, abstraction leaks, convention violations, dead code
 
-Execute via `ccw cli --tool gemini --mode analysis --rule analysis-review-code-quality` (fallback: qwen -> codex). Parse JSON array response, validate required fields (dimension, title, location.file), enforce per-dimension limit (max 5 each), filter minimum severity (medium+). Write `<session>/scan/semantic-findings.json`.
+Execute via `maestro cli --tool gemini --mode analysis --rule analysis-review-code-quality` (fallback: qwen -> codex). Parse JSON array response, validate required fields (dimension, title, location.file), enforce per-dimension limit (max 5 each), filter minimum severity (medium+). Write `<session>/scan/semantic-findings.json`.
 
 ## Phase 4: Aggregate & Output
 

package/.codex/skills/team-tech-debt/SKILL.md

@@ -63,7 +63,7 @@ Before calling ANY tool, apply this check:
 | `Read` on `roles/`, `commands/`, `specs/` | ALLOWED | Loading own instructions |
 | `Read/Grep/Glob` on project source code | BLOCKED | Delegate to worker |
 | `Edit` on any file outside `.workflow/` | BLOCKED | Delegate to worker |
-| `Bash("ccw cli ...")` | BLOCKED | Only workers call CLI |
+| `Bash("maestro cli ...")` | BLOCKED | Only workers call CLI |
 | `Bash` running build/test/lint commands | BLOCKED | Delegate to worker |
 
 **If a tool call is BLOCKED**: STOP. Create a task, spawn a worker.
@@ -76,7 +76,7 @@ Before calling ANY tool, apply this check:
 
 - **Session prefix**: `TD`
 - **Session path**: `.workflow/.team/TD-<slug>-<date>/`
-- **CLI tools**: `ccw cli --mode analysis` (read-only), `ccw cli --mode write` (modifications)
+- **CLI tools**: `maestro cli --mode analysis` (read-only), `maestro cli --mode write` (modifications)
 - **Message bus**: `mcp__maestro-tools__team_msg(session_id=<session-id>, ...)`
 - **Max GC rounds**: 3
 

package/.codex/skills/team-tech-debt/roles/coordinator/role.md

@@ -12,7 +12,7 @@
 **FORBIDDEN** (even if the task seems trivial):
 ```
 WRONG: Read/Grep/Glob on project source code        — worker work
-WRONG: Bash("ccw cli ...")                           — worker work
+WRONG: Bash("maestro cli ...")                           — worker work
 WRONG: Edit/Write on project source files            — worker work
 ```
 

package/.codex/skills/team-tech-debt/roles/executor/role.md

@@ -37,7 +37,7 @@ For each batch, use CLI tool for implementation:
 **Per-batch delegation**:
 
 ```bash
-ccw cli -p "PURPOSE: Apply tech debt fixes in batch; success = all items fixed without breaking changes
+maestro cli -p "PURPOSE: Apply tech debt fixes in batch; success = all items fixed without breaking changes
 TASK: <batch-type-specific-tasks>
 MODE: write
 CONTEXT: @<worktree-path>/**/* | Memory: Remediation plan context

package/.codex/skills/team-tech-debt/roles/scanner/role.md

@@ -18,7 +18,7 @@ Multi-dimension tech debt scanner. Scan codebase across 5 dimensions (code, arch
 | .msg/meta.json | <session>/.msg/meta.json | Yes |
 
 1. Extract session path and scan scope from task description
-2. Load debug specs: Run `ccw spec load --category debug` for known issues, workarounds, and root-cause notes
+2. Load debug specs: Run `maestro spec load --category debug` for known issues, workarounds, and root-cause notes
 3. Read .msg/meta.json for team context
 3. Detect project type and framework:
 
@@ -56,7 +56,7 @@ Multi-dimension tech debt scanner. Scan codebase across 5 dimensions (code, arch
 - Classify findings into dimensions
 
 **Medium/High Complexity** (Fan-out):
-- Fan-out A: CLI exploration (structure, patterns, dependencies angles) via `ccw cli --tool gemini --mode analysis`
+- Fan-out A: CLI exploration (structure, patterns, dependencies angles) via `maestro cli --tool gemini --mode analysis`
 - Fan-out B: CLI dimension analysis (parallel gemini per dimension -- code, architecture, testing, dependency, documentation)
 - Fan-out C (High only): Multi-perspective Gemini analysis (security, performance, code-quality, architecture)
 - Fan-in: Merge results, cross-deduplicate by file:line, boost severity for multi-source findings

package/.codex/skills/team-tech-debt/roles/validator/role.md

@@ -58,7 +58,7 @@ Execute 4-layer validation (all commands in worktree):
 **Auto-fix attempt** (when total_regressions <= 3):
 - Use CLI tool to fix regressions in worktree:
   ```
-  Bash(`cd "${worktreePath}" && ccw cli -p "PURPOSE: Fix regressions found in validation
+  Bash(`cd "${worktreePath}" && maestro cli -p "PURPOSE: Fix regressions found in validation
   TASK: ${regressionDetails}
   MODE: write
   CONTEXT: @${modifiedFiles.join(' @')}

package/.codex/skills/team-testing/SKILL.md

@@ -62,7 +62,7 @@ Before calling ANY tool, apply this check:
 | `Read` on `roles/`, `commands/`, `specs/` | ALLOWED | Loading own instructions |
 | `Read/Grep/Glob` on project source code | BLOCKED | Delegate to worker |
 | `Edit` on any file outside `.workflow/` | BLOCKED | Delegate to worker |
-| `Bash("ccw cli ...")` | BLOCKED | Only workers call CLI |
+| `Bash("maestro cli ...")` | BLOCKED | Only workers call CLI |
 | `Bash` running build/test/lint commands | BLOCKED | Delegate to worker |
 
 **If a tool call is BLOCKED**: STOP. Create a task, spawn a worker.
@@ -76,7 +76,7 @@ Before calling ANY tool, apply this check:
 - **Session prefix**: `TST`
 - **Session path**: `.workflow/.team/TST-<slug>-<date>/`
 - **Team name**: `testing`
-- **CLI tools**: `ccw cli --mode analysis` (read-only), `ccw cli --mode write` (modifications)
+- **CLI tools**: `maestro cli --mode analysis` (read-only), `maestro cli --mode write` (modifications)
 - **Message bus**: `mcp__maestro-tools__team_msg(session_id=<session-id>, ...)`
 
 ## Worker Spawn Template

package/.codex/skills/team-testing/roles/coordinator/role.md

@@ -12,7 +12,7 @@ Orchestrate team-testing: analyze -> dispatch -> spawn -> monitor -> report.
 **FORBIDDEN** (even if the task seems trivial):
 ```
 WRONG: Read/Grep/Glob on project source code        — worker work
-WRONG: Bash("ccw cli ...")                           — worker work
+WRONG: Bash("maestro cli ...")                           — worker work
 WRONG: Bash("npm test"), Bash("jest"), etc.          — worker work
 WRONG: Edit/Write on test or source files            — worker work
 ```
@@ -43,7 +43,7 @@ WRONG: Edit/Write on test or source files            — worker work
 - Skip quality gates when coverage is below target
 - Modify test files or source code directly -- delegate to workers
 - Force-advance pipeline past failed GC loops
-- Call CLI tools (ccw cli) — only workers use CLI
+- Call CLI tools (maestro cli) — only workers use CLI
 
 ## Command Execution Protocol
 When coordinator needs to execute a specific phase:

package/.codex/skills/team-testing/roles/executor/role.md

@@ -24,7 +24,7 @@ Execute tests, collect coverage, attempt auto-fix for failures. Acts as the Crit
 | .msg/meta.json | <session>/wisdom/.msg/meta.json | No |
 
 1. Extract session path and test directory from task description
-2. Load test specs: Run `ccw spec load --category test` for test framework conventions and coverage targets
+2. Load test specs: Run `maestro spec load --category test` for test framework conventions and coverage targets
 3. Extract coverage target (default: 80%)
 3. Read .msg/meta.json for framework info (from strategist namespace)
 4. Determine test framework:
@@ -61,7 +61,7 @@ Bash("<test-command> 2>&1 || true")
 **Auto-fix delegation** (on failure):
 
 ```
-Bash(`ccw cli -p "PURPOSE: Fix test failures to achieve pass rate >= 0.95; success = all tests pass
+Bash(`maestro cli -p "PURPOSE: Fix test failures to achieve pass rate >= 0.95; success = all tests pass
 TASK: • Analyze test failure output • Identify root causes • Fix test code only (not source) • Preserve test intent
 MODE: write
 CONTEXT: @<session>/<test-dir>/**/* | Memory: Test framework: <framework>, iteration <N>/3

package/.codex/skills/team-testing/roles/generator/role.md

@@ -22,7 +22,7 @@ Generate test code by layer (L1 unit / L2 integration / L3 E2E). Acts as the Gen
 | .msg/meta.json | <session>/wisdom/.msg/meta.json | No |
 
 1. Extract session path and layer from task description
-2. Load test specs: Run `ccw spec load --category test` for test framework conventions and coverage targets
+2. Load test specs: Run `maestro spec load --category test` for test framework conventions and coverage targets
 3. Read test strategy:
 
 ```
@@ -63,7 +63,7 @@ For revision mode:
 **CLI delegation** (medium/high complexity):
 
 ```
-Bash(`ccw cli -p "PURPOSE: Generate <layer> tests using <framework> to achieve coverage target; success = all priority files covered with quality tests
+Bash(`maestro cli -p "PURPOSE: Generate <layer> tests using <framework> to achieve coverage target; success = all priority files covered with quality tests
 TASK: • Analyze source files • Generate test cases (happy path, edge cases, errors) • Write test files with proper structure • Ensure import resolution
 MODE: write
 CONTEXT: @<source-files> @<session>/strategy/test-strategy.md | Memory: Framework: <framework>, Layer: <layer>, Round: <round>

package/README.md

@@ -220,14 +220,22 @@ Maestro-Flow doesn't pick one AI — it uses them together:
 
 ### Install
 
+#### npm (Recommended)
+
+```bash
+npm install -g maestro-flow
+
+# Install workflows, commands, agents, templates
+maestro install
+```
+
+#### From Source
+
 ```bash
 git clone https://github.com/catlog22/Maestro-Flow.git
 cd Maestro-Flow
 npm install && npm run build
-
-# Dashboard
-cd dashboard && npm install && npm run dev
-# → http://127.0.0.1:3001
+maestro install
 ```
 
 ### First Run
@@ -242,6 +250,37 @@ cd dashboard && npm install && npm run dev
 /maestro "build a REST API for user management"
 ```
 
+### Dashboard & TUI
+
+```bash
+# Web dashboard — real-time project control panel
+maestro serve
+# → http://127.0.0.1:3001
+
+# TUI — terminal-based dashboard
+maestro view
+```
+
+| View | Key | Description |
+|------|-----|-------------|
+| **Board** | `K` | Kanban — Backlog, In Progress, Review, Done |
+| **Timeline** | `T` | Gantt-style phase timeline |
+| **Table** | `L` | Sortable phase & issue table |
+| **Center** | `C` | Command center — active executions, quality metrics |
+
+### Workflow Launcher
+
+Switch between different workflow configurations (e.g., Maestro ↔ CCW):
+
+```bash
+maestro launcher               # Interactive workflow + settings picker
+maestro launcher list           # Show registered workflows
+```
+
+When switching workflows, the launcher automatically:
+- Detects missing dependencies and offers `npm install -g <package>` + resource installation
+- Detects project-level workflow file conflicts and offers cleanup
+
 ### MCP Server
 
 Expose Maestro-Flow tools to Claude Desktop and other MCP clients:

package/dist/agents/dashboard-bridge.d.ts

@@ -15,6 +15,7 @@ interface NormalizedEntry {
 }
 export declare class DashboardBridge {
     private ws;
+    private activeCount;
     /**
      * Attempt to connect to the Dashboard WS endpoint.
      * Returns immediately if connection fails or times out.
@@ -24,8 +25,12 @@ export declare class DashboardBridge {
     forwardSpawn(process: AgentProcess): void;
     /** Forward a normalized entry to the Dashboard */
     forwardEntry(entry: NormalizedEntry): void;
+    /** Register an active CLI process for reference counting */
+    registerProcess(): void;
     /** Notify Dashboard that the CLI process has stopped */
     forwardStopped(processId: string): void;
+    /** Close the WS connection only when no active processes remain */
+    closeIfIdle(): void;
     /** Close the WS connection */
     close(): void;
     private send;

package/dist/agents/dashboard-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-bridge.d.ts","sourceRoot":"","sources":["../../src/agents/dashboard-bridge.ts"],"names":[],"mappings":"AAWA,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA0B;IAEpC;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBjE,qDAAqD;IACrD,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIzC,kDAAkD;IAClD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,wDAAwD;IACxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIvC,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,IAAI;CASb"}
+{"version":3,"file":"dashboard-bridge.d.ts","sourceRoot":"","sources":["../../src/agents/dashboard-bridge.ts"],"names":[],"mappings":"AAWA,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAa;IAEhC;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBjE,qDAAqD;IACrD,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIzC,kDAAkD;IAClD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,4DAA4D;IAC5D,eAAe,IAAI,IAAI;IAIvB,wDAAwD;IACxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKvC,mEAAmE;IACnE,WAAW,IAAI,IAAI;IAMnB,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,IAAI;CASb"}

package/dist/agents/dashboard-bridge.js

@@ -8,6 +8,7 @@ import { WebSocket } from 'ws';
 // ---------------------------------------------------------------------------
 export class DashboardBridge {
     ws = null;
+    activeCount = 0;
     /**
      * Attempt to connect to the Dashboard WS endpoint.
      * Returns immediately if connection fails or times out.
@@ -38,9 +39,20 @@ export class DashboardBridge {
     forwardEntry(entry) {
         this.send({ action: 'cli:entry', entry });
     }
+    /** Register an active CLI process for reference counting */
+    registerProcess() {
+        this.activeCount++;
+    }
     /** Notify Dashboard that the CLI process has stopped */
     forwardStopped(processId) {
         this.send({ action: 'cli:stopped', processId });
+        this.activeCount--;
+    }
+    /** Close the WS connection only when no active processes remain */
+    closeIfIdle() {
+        if (this.activeCount <= 0) {
+            this.close();
+        }
     }
     /** Close the WS connection */
     close() {
@@ -48,6 +60,7 @@ export class DashboardBridge {
             this.ws.close();
         }
         this.ws = null;
+        this.activeCount = 0;
     }
     send(data) {
         if (this.ws && this.ws.readyState === WebSocket.OPEN) {

package/dist/agents/dashboard-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-bridge.js","sourceRoot":"","sources":["../../src/agents/dashboard-bridge.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAuB/B,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,OAAO,eAAe;IAClB,EAAE,GAAqB,IAAI,CAAC;IAEpC;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,SAAS,GAAG,IAAI;QAC5C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,EAAE,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAE9B,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAClB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,YAAY,CAAC,OAAqB;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,kDAAkD;IAClD,YAAY,CAAC,KAAsB;QACjC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,wDAAwD;IACxD,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,8BAA8B;IAC9B,KAAK;QACH,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC;IAEO,IAAI,CAAC,IAAa;QACxB,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;YACzD,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"dashboard-bridge.js","sourceRoot":"","sources":["../../src/agents/dashboard-bridge.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAuB/B,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,OAAO,eAAe;IAClB,EAAE,GAAqB,IAAI,CAAC;IAC5B,WAAW,GAAW,CAAC,CAAC;IAEhC;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,SAAS,GAAG,IAAI;QAC5C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,EAAE,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAE9B,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAClB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,YAAY,CAAC,OAAqB;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,kDAAkD;IAClD,YAAY,CAAC,KAAsB;QACjC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,4DAA4D;IAC5D,eAAe;QACb,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,wDAAwD;IACxD,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,mEAAmE;IACnE,WAAW;QACT,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,KAAK;QACH,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAEO,IAAI,CAAC,IAAa;QACxB,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;YACzD,CAAC;QACH,CAAC;IACH,CAAC;CACF"}