claude-code-workflow 7.2.23 → 7.2.25

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

@@ -1,72 +1,72 @@
-# Analyze Task
-
-Parse user task -> detect QA capabilities -> build dependency graph -> design roles.
-
-**CONSTRAINT**: Text-level analysis only. NO source code reading, NO codebase exploration.
-
-## Signal Detection
-
-| Keywords | Capability | Prefix |
-|----------|------------|--------|
-| scan, discover, find issues, audit | scout | SCOUT |
-| strategy, plan, test layers, coverage | strategist | QASTRAT |
-| generate tests, write tests, create tests | generator | QAGEN |
-| run tests, execute, fix tests | executor | QARUN |
-| analyze, report, quality score | analyst | QAANA |
-
-## QA Mode Detection
-
-| Condition | Mode |
-|-----------|------|
-| Keywords: discovery, scan, issues, bug-finding | discovery |
-| Keywords: test, coverage, TDD, unit, integration | testing |
-| Both keyword types OR no clear match | full |
-
-## Dependency Graph
-
-Natural ordering tiers for QA pipeline:
-- Tier 0: scout (issue discovery)
-- Tier 1: strategist (strategy requires scout discoveries)
-- Tier 2: generator (generation requires strategy)
-- Tier 3: executor (execution requires generated tests)
-- Tier 4: analyst (analysis requires execution results)
-
-## Pipeline Definitions
-
-```
-Discovery Mode: SCOUT -> QASTRAT -> QAGEN(L1) -> QARUN(L1) -> QAANA
-Testing Mode: QASTRAT -> QAGEN(L1) -> QARUN(L1) -> QAGEN(L2) -> QARUN(L2) -> QAANA
-Full Mode: SCOUT -> QASTRAT -> [QAGEN(L1) || QAGEN(L2)] -> [QARUN(L1) || QARUN(L2)] -> QAANA -> SCOUT(regression)
-```
-
-## Complexity Scoring
-
-| Factor | Points |
-|--------|--------|
-| Per capability | +1 |
-| Cross-domain (test + discovery) | +2 |
-| Parallel tracks | +1 per track |
-| Serial depth > 3 | +1 |
-
-Results: 1-3 Low, 4-6 Medium, 7+ High
-
-## Role Minimization
-
-- Cap at 6 roles (coordinator + 5 workers)
-- Merge overlapping capabilities
-- Absorb trivial single-step roles
-
-## Output
-
-Write <session>/task-analysis.json:
-```json
-{
-  "task_description": "<original>",
-  "pipeline_mode": "<discovery|testing|full>",
-  "capabilities": [{ "name": "<cap>", "prefix": "<PREFIX>", "keywords": ["..."] }],
-  "dependency_graph": { "<TASK-ID>": { "role": "<role>", "addBlockedBy": ["..."], "priority": "P0|P1|P2" } },
-  "roles": [{ "name": "<role>", "prefix": "<PREFIX>", "inner_loop": false }],
-  "complexity": { "score": 0, "level": "Low|Medium|High" },
-  "gc_loop_enabled": true
-}
-```
+# Analyze Task
+
+Parse user task -> detect QA capabilities -> build dependency graph -> design roles.
+
+**CONSTRAINT**: Text-level analysis only. NO source code reading, NO codebase exploration.
+
+## Signal Detection
+
+| Keywords | Capability | Prefix |
+|----------|------------|--------|
+| scan, discover, find issues, audit | scout | SCOUT |
+| strategy, plan, test layers, coverage | strategist | QASTRAT |
+| generate tests, write tests, create tests | generator | QAGEN |
+| run tests, execute, fix tests | executor | QARUN |
+| analyze, report, quality score | analyst | QAANA |
+
+## QA Mode Detection
+
+| Condition | Mode |
+|-----------|------|
+| Keywords: discovery, scan, issues, bug-finding | discovery |
+| Keywords: test, coverage, TDD, unit, integration | testing |
+| Both keyword types OR no clear match | full |
+
+## Dependency Graph
+
+Natural ordering tiers for QA pipeline:
+- Tier 0: scout (issue discovery)
+- Tier 1: strategist (strategy requires scout discoveries)
+- Tier 2: generator (generation requires strategy)
+- Tier 3: executor (execution requires generated tests)
+- Tier 4: analyst (analysis requires execution results)
+
+## Pipeline Definitions
+
+```
+Discovery Mode: SCOUT -> QASTRAT -> QAGEN(L1) -> QARUN(L1) -> QAANA
+Testing Mode: QASTRAT -> QAGEN(L1) -> QARUN(L1) -> QAGEN(L2) -> QARUN(L2) -> QAANA
+Full Mode: SCOUT -> QASTRAT -> [QAGEN(L1) || QAGEN(L2)] -> [QARUN(L1) || QARUN(L2)] -> QAANA -> SCOUT(regression)
+```
+
+## Complexity Scoring
+
+| Factor | Points |
+|--------|--------|
+| Per capability | +1 |
+| Cross-domain (test + discovery) | +2 |
+| Parallel tracks | +1 per track |
+| Serial depth > 3 | +1 |
+
+Results: 1-3 Low, 4-6 Medium, 7+ High
+
+## Role Minimization
+
+- Cap at 6 roles (coordinator + 5 workers)
+- Merge overlapping capabilities
+- Absorb trivial single-step roles
+
+## Output
+
+Write <session>/task-analysis.json:
+```json
+{
+  "task_description": "<original>",
+  "pipeline_mode": "<discovery|testing|full>",
+  "capabilities": [{ "name": "<cap>", "prefix": "<PREFIX>", "keywords": ["..."] }],
+  "dependency_graph": { "<TASK-ID>": { "role": "<role>", "addBlockedBy": ["..."], "priority": "P0|P1|P2" } },
+  "roles": [{ "name": "<role>", "prefix": "<PREFIX>", "inner_loop": false }],
+  "complexity": { "score": 0, "level": "Low|Medium|High" },
+  "gc_loop_enabled": true
+}
+```

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

@@ -1,108 +1,108 @@
-# Dispatch Tasks
-
-Create task chains from dependency graph with proper blockedBy relationships.
-
-## Workflow
-
-1. Read task-analysis.json -> extract pipeline_mode and dependency_graph
-2. Read specs/pipelines.md -> get task registry for selected pipeline
-3. Topological sort tasks (respect blockedBy)
-4. Validate all owners exist in role registry (SKILL.md)
-5. For each task (in order):
-   - Build JSON entry with structured description (see template below)
-   - Set blockedBy and owner fields in the entry
-6. Write all entries to `<session>/tasks.json`
-7. Update session.json with pipeline.tasks_total
-8. Validate chain (no orphans, no cycles, all refs valid)
-
-## Task Description Template
-
-Each task is a JSON entry in the tasks array:
-
-```json
-{
-  "id": "<TASK-ID>",
-  "subject": "<TASK-ID>",
-  "description": "PURPOSE: <goal> | Success: <criteria>\nTASK:\n  - <step 1>\n  - <step 2>\nCONTEXT:\n  - Session: <session-folder>\n  - Layer: <L1-unit|L2-integration|L3-e2e> (if applicable)\n  - Upstream artifacts: <list>\n  - Shared memory: <session>/wisdom/.msg/meta.json\nEXPECTED: <artifact path> + <quality criteria>\nCONSTRAINTS: <scope limits>\n---\nInnerLoop: <true|false>\nRoleSpec: ~  or <project>/.codex/skills/team-quality-assurance/roles/<role>/role.md",
-  "status": "pending",
-  "owner": "<role>",
-  "blockedBy": ["<dependency-list>"]
-}
-```
-
-## Pipeline Task Registry
-
-### Discovery Mode
-```
-SCOUT-001 (scout): Multi-perspective issue scanning
-  blockedBy: []
-QASTRAT-001 (strategist): Test strategy formulation
-  blockedBy: [SCOUT-001]
-QAGEN-001 (generator): L1 unit test generation
-  blockedBy: [QASTRAT-001], meta: layer=L1
-QARUN-001 (executor): L1 test execution + fix cycles
-  blockedBy: [QAGEN-001], inner_loop: true, meta: layer=L1
-QAANA-001 (analyst): Quality analysis report
-  blockedBy: [QARUN-001]
-```
-
-### Testing Mode
-```
-QASTRAT-001 (strategist): Test strategy formulation
-  blockedBy: []
-QAGEN-L1-001 (generator): L1 unit test generation
-  blockedBy: [QASTRAT-001], meta: layer=L1
-QARUN-L1-001 (executor): L1 test execution + fix cycles
-  blockedBy: [QAGEN-L1-001], inner_loop: true, meta: layer=L1
-QAGEN-L2-001 (generator): L2 integration test generation
-  blockedBy: [QARUN-L1-001], meta: layer=L2
-QARUN-L2-001 (executor): L2 test execution + fix cycles
-  blockedBy: [QAGEN-L2-001], inner_loop: true, meta: layer=L2
-QAANA-001 (analyst): Quality analysis report
-  blockedBy: [QARUN-L2-001]
-```
-
-### Full Mode
-```
-SCOUT-001 (scout): Multi-perspective issue scanning
-  blockedBy: []
-QASTRAT-001 (strategist): Test strategy formulation
-  blockedBy: [SCOUT-001]
-QAGEN-L1-001 (generator-1): L1 unit test generation
-  blockedBy: [QASTRAT-001], meta: layer=L1
-QAGEN-L2-001 (generator-2): L2 integration test generation
-  blockedBy: [QASTRAT-001], meta: layer=L2
-QARUN-L1-001 (executor-1): L1 test execution + fix cycles
-  blockedBy: [QAGEN-L1-001], inner_loop: true, meta: layer=L1
-QARUN-L2-001 (executor-2): L2 test execution + fix cycles
-  blockedBy: [QAGEN-L2-001], inner_loop: true, meta: layer=L2
-QAANA-001 (analyst): Quality analysis report
-  blockedBy: [QARUN-L1-001, QARUN-L2-001]
-SCOUT-002 (scout): Regression scan after fixes
-  blockedBy: [QAANA-001]
-```
-
-## InnerLoop Flag Rules
-
-- true: executor roles (run-fix cycles)
-- false: scout, strategist, generator, analyst roles
-
-## Dependency Validation
-
-- No orphan tasks (all tasks have valid owner)
-- No circular dependencies
-- All blockedBy references exist
-- Session reference in every task description
-- RoleSpec reference in every task description
-
-## Log After Creation
-
-```
-mcp__ccw-tools__team_msg({
-  operation: "log",
-  session_id: <session-id>,
-  from: "coordinator",
-  type: "pipeline_selected",
-  data: { pipeline: "<mode>", task_count: <N> }
-})
-```
+# Dispatch Tasks
+
+Create task chains from dependency graph with proper blockedBy relationships.
+
+## Workflow
+
+1. Read task-analysis.json -> extract pipeline_mode and dependency_graph
+2. Read specs/pipelines.md -> get task registry for selected pipeline
+3. Topological sort tasks (respect blockedBy)
+4. Validate all owners exist in role registry (SKILL.md)
+5. For each task (in order):
+   - Build JSON entry with structured description (see template below)
+   - Set blockedBy and owner fields in the entry
+6. Write all entries to `<session>/tasks.json`
+7. Update session.json with pipeline.tasks_total
+8. Validate chain (no orphans, no cycles, all refs valid)
+
+## Task Description Template
+
+Each task is a JSON entry in the tasks array:
+
+```json
+{
+  "id": "<TASK-ID>",
+  "subject": "<TASK-ID>",
+  "description": "PURPOSE: <goal> | Success: <criteria>\nTASK:\n  - <step 1>\n  - <step 2>\nCONTEXT:\n  - Session: <session-folder>\n  - Layer: <L1-unit|L2-integration|L3-e2e> (if applicable)\n  - Upstream artifacts: <list>\n  - Shared memory: <session>/wisdom/.msg/meta.json\nEXPECTED: <artifact path> + <quality criteria>\nCONSTRAINTS: <scope limits>\n---\nInnerLoop: <true|false>\nRoleSpec: ~  or <project>/.codex/skills/team-quality-assurance/roles/<role>/role.md",
+  "status": "pending",
+  "owner": "<role>",
+  "blockedBy": ["<dependency-list>"]
+}
+```
+
+## Pipeline Task Registry
+
+### Discovery Mode
+```
+SCOUT-001 (scout): Multi-perspective issue scanning
+  blockedBy: []
+QASTRAT-001 (strategist): Test strategy formulation
+  blockedBy: [SCOUT-001]
+QAGEN-001 (generator): L1 unit test generation
+  blockedBy: [QASTRAT-001], meta: layer=L1
+QARUN-001 (executor): L1 test execution + fix cycles
+  blockedBy: [QAGEN-001], inner_loop: true, meta: layer=L1
+QAANA-001 (analyst): Quality analysis report
+  blockedBy: [QARUN-001]
+```
+
+### Testing Mode
+```
+QASTRAT-001 (strategist): Test strategy formulation
+  blockedBy: []
+QAGEN-L1-001 (generator): L1 unit test generation
+  blockedBy: [QASTRAT-001], meta: layer=L1
+QARUN-L1-001 (executor): L1 test execution + fix cycles
+  blockedBy: [QAGEN-L1-001], inner_loop: true, meta: layer=L1
+QAGEN-L2-001 (generator): L2 integration test generation
+  blockedBy: [QARUN-L1-001], meta: layer=L2
+QARUN-L2-001 (executor): L2 test execution + fix cycles
+  blockedBy: [QAGEN-L2-001], inner_loop: true, meta: layer=L2
+QAANA-001 (analyst): Quality analysis report
+  blockedBy: [QARUN-L2-001]
+```
+
+### Full Mode
+```
+SCOUT-001 (scout): Multi-perspective issue scanning
+  blockedBy: []
+QASTRAT-001 (strategist): Test strategy formulation
+  blockedBy: [SCOUT-001]
+QAGEN-L1-001 (generator-1): L1 unit test generation
+  blockedBy: [QASTRAT-001], meta: layer=L1
+QAGEN-L2-001 (generator-2): L2 integration test generation
+  blockedBy: [QASTRAT-001], meta: layer=L2
+QARUN-L1-001 (executor-1): L1 test execution + fix cycles
+  blockedBy: [QAGEN-L1-001], inner_loop: true, meta: layer=L1
+QARUN-L2-001 (executor-2): L2 test execution + fix cycles
+  blockedBy: [QAGEN-L2-001], inner_loop: true, meta: layer=L2
+QAANA-001 (analyst): Quality analysis report
+  blockedBy: [QARUN-L1-001, QARUN-L2-001]
+SCOUT-002 (scout): Regression scan after fixes
+  blockedBy: [QAANA-001]
+```
+
+## InnerLoop Flag Rules
+
+- true: executor roles (run-fix cycles)
+- false: scout, strategist, generator, analyst roles
+
+## Dependency Validation
+
+- No orphan tasks (all tasks have valid owner)
+- No circular dependencies
+- All blockedBy references exist
+- Session reference in every task description
+- RoleSpec reference in every task description
+
+## Log After Creation
+
+```
+mcp__ccw-tools__team_msg({
+  operation: "log",
+  session_id: <session-id>,
+  from: "coordinator",
+  type: "pipeline_selected",
+  data: { pipeline: "<mode>", task_count: <N> }
+})
+```