claude-code-workflow 7.2.14 → 7.2.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/workflow/analyze-with-file.md +7 -0
- package/.codex/skills/analyze-with-file/SKILL.md +1181 -1182
- package/.codex/skills/brainstorm/SKILL.md +723 -725
- package/.codex/skills/brainstorm-with-file/SKILL.md +10 -5
- package/.codex/skills/clean/SKILL.md +33 -26
- package/.codex/skills/collaborative-plan-with-file/SKILL.md +830 -831
- package/.codex/skills/csv-wave-pipeline/SKILL.md +906 -906
- package/.codex/skills/issue-discover/SKILL.md +57 -50
- package/.codex/skills/issue-discover/phases/01-issue-new.md +18 -11
- package/.codex/skills/issue-discover/phases/02-discover.md +31 -26
- package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +13 -11
- package/.codex/skills/issue-discover/phases/04-quick-execute.md +32 -27
- package/.codex/skills/parallel-dev-cycle/SKILL.md +402 -402
- package/.codex/skills/project-documentation-workflow/SKILL.md +13 -3
- package/.codex/skills/roadmap-with-file/SKILL.md +901 -897
- package/.codex/skills/session-sync/SKILL.md +222 -212
- package/.codex/skills/spec-add/SKILL.md +620 -613
- package/.codex/skills/spec-generator/SKILL.md +2 -2
- package/.codex/skills/spec-generator/phases/01-5-requirement-clarification.md +10 -10
- package/.codex/skills/spec-generator/phases/01-discovery.md +11 -18
- package/.codex/skills/spec-generator/phases/02-product-brief.md +5 -5
- package/.codex/skills/spec-generator/phases/03-requirements.md +7 -7
- package/.codex/skills/spec-generator/phases/04-architecture.md +4 -4
- package/.codex/skills/spec-generator/phases/05-epics-stories.md +5 -6
- package/.codex/skills/spec-generator/phases/06-readiness-check.md +10 -17
- package/.codex/skills/spec-generator/phases/07-issue-export.md +326 -329
- package/.codex/skills/spec-setup/SKILL.md +669 -657
- package/.codex/skills/team-arch-opt/SKILL.md +50 -50
- package/.codex/skills/team-arch-opt/agents/completion-handler.md +3 -3
- package/.codex/skills/team-brainstorm/SKILL.md +724 -725
- package/.codex/skills/team-coordinate/SKILL.md +51 -51
- package/.codex/skills/team-coordinate/agents/completion-handler.md +3 -3
- package/.codex/skills/team-coordinate/agents/plan-reviewer.md +4 -4
- package/.codex/skills/team-designer/SKILL.md +691 -691
- package/.codex/skills/team-designer/agents/requirement-clarifier.md +11 -12
- package/.codex/skills/team-executor/SKILL.md +45 -45
- package/.codex/skills/team-frontend/SKILL.md +45 -45
- package/.codex/skills/team-frontend/agents/completion-handler.md +3 -3
- package/.codex/skills/team-frontend/agents/qa-gate-reviewer.md +4 -4
- package/.codex/skills/team-frontend-debug/SKILL.md +50 -50
- package/.codex/skills/team-frontend-debug/agents/completion-handler.md +3 -3
- package/.codex/skills/team-frontend-debug/agents/conditional-skip-gate.md +4 -4
- package/.codex/skills/team-issue/SKILL.md +751 -740
- package/.codex/skills/team-iterdev/SKILL.md +825 -826
- package/.codex/skills/team-lifecycle-v4/SKILL.md +775 -775
- package/.codex/skills/team-lifecycle-v4/agents/quality-gate.md +165 -165
- package/.codex/skills/team-lifecycle-v4/agents/requirement-clarifier.md +163 -163
- package/.codex/skills/team-perf-opt/SKILL.md +50 -50
- package/.codex/skills/team-perf-opt/agents/completion-handler.md +3 -3
- package/.codex/skills/team-planex-v2/SKILL.md +652 -637
- package/.codex/skills/team-quality-assurance/SKILL.md +51 -52
- package/.codex/skills/team-review/SKILL.md +40 -40
- package/.codex/skills/team-roadmap-dev/SKILL.md +51 -51
- package/.codex/skills/team-roadmap-dev/agents/roadmap-discusser.md +8 -8
- package/.codex/skills/team-tech-debt/SKILL.md +50 -50
- package/.codex/skills/team-tech-debt/agents/plan-approver.md +5 -5
- package/.codex/skills/team-testing/SKILL.md +51 -52
- package/.codex/skills/team-uidesign/SKILL.md +40 -40
- package/.codex/skills/team-uidesign/agents/completion-handler.md +177 -177
- package/.codex/skills/team-ultra-analyze/SKILL.md +786 -787
- package/.codex/skills/team-ultra-analyze/agents/discussion-feedback.md +8 -8
- package/.codex/skills/team-ux-improve/SKILL.md +51 -52
- package/.codex/skills/team-ux-improve/agents/ux-designer.md +2 -2
- package/.codex/skills/team-ux-improve/agents/ux-explorer.md +1 -1
- package/.codex/skills/unified-execute-with-file/SKILL.md +797 -796
- package/.codex/skills/workflow-execute/SKILL.md +1117 -1118
- package/.codex/skills/workflow-lite-planex/SKILL.md +1144 -1141
- package/.codex/skills/workflow-plan/SKILL.md +631 -636
- package/.codex/skills/workflow-tdd-plan/SKILL.md +753 -759
- package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -392
- package/README.md +25 -0
- package/ccw/dist/commands/install.d.ts.map +1 -1
- package/ccw/dist/commands/install.js +12 -0
- package/ccw/dist/commands/install.js.map +1 -1
- package/package.json +1 -1
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-testing
|
|
3
3
|
description: Multi-agent test pipeline with progressive layer coverage (L1/L2/L3), Generator-Critic loops for coverage convergence, and shared defect memory. Strategist -> Generator -> Executor -> Analyst with dynamic pipeline selection.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"task description or scope\""
|
|
5
|
-
allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep,
|
|
5
|
+
allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
## Auto Mode
|
|
@@ -274,16 +274,15 @@ Write(`${sessionFolder}/gc-state.json`, JSON.stringify({
|
|
|
274
274
|
|
|
275
275
|
5. **Clarify if ambiguous** (skip if AUTO_YES):
|
|
276
276
|
```javascript
|
|
277
|
-
|
|
277
|
+
request_user_input({
|
|
278
278
|
questions: [{
|
|
279
|
-
question:
|
|
280
|
-
header: "Pipeline
|
|
281
|
-
|
|
279
|
+
question: `Detected scope suggests '${pipeline}' pipeline. Approve or override?`,
|
|
280
|
+
header: "Pipeline",
|
|
281
|
+
id: "pipeline_select",
|
|
282
282
|
options: [
|
|
283
|
-
{ label: "
|
|
284
|
-
{ label: "
|
|
285
|
-
{ label: "
|
|
286
|
-
{ label: "Use comprehensive", description: "Full: L1 + L2 + L3 + analysis" }
|
|
283
|
+
{ label: "Approve (Recommended)", description: `Use ${pipeline} pipeline as detected` },
|
|
284
|
+
{ label: "Targeted", description: "Minimal: L1 only" },
|
|
285
|
+
{ label: "Standard/Full", description: "Progressive L1+L2 or comprehensive L1+L2+L3" }
|
|
287
286
|
]
|
|
288
287
|
}]
|
|
289
288
|
})
|
|
@@ -525,13 +524,13 @@ Session: ${sessionFolder}
|
|
|
525
524
|
`)
|
|
526
525
|
|
|
527
526
|
if (!AUTO_YES) {
|
|
528
|
-
|
|
527
|
+
request_user_input({
|
|
529
528
|
questions: [{
|
|
530
|
-
question: "Testing pipeline complete.
|
|
531
|
-
header: "
|
|
532
|
-
|
|
529
|
+
question: "Testing pipeline complete. Choose next action.",
|
|
530
|
+
header: "Done",
|
|
531
|
+
id: "completion",
|
|
533
532
|
options: [
|
|
534
|
-
{ label: "Archive
|
|
533
|
+
{ label: "Archive (Recommended)", description: "Archive session, output final summary" },
|
|
535
534
|
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
536
535
|
{ label: "Deepen Coverage", description: "Add more test layers or increase coverage targets" }
|
|
537
536
|
]
|
|
@@ -730,41 +729,41 @@ TESTGEN -> TESTRUN -> (if pass_rate < 0.95 OR coverage < target) -> GC Loop Hand
|
|
|
730
729
|
8. **GC Loop Discipline**: Max 3 rounds per layer; never infinite-loop on coverage
|
|
731
730
|
9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
732
731
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
---
|
|
736
|
-
|
|
737
|
-
## Coordinator Role Constraints (Main Agent)
|
|
738
|
-
|
|
739
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
740
|
-
|
|
741
|
-
15. **Coordinator Does NOT Execute Code**: The main agent MUST NOT write, modify, or implement any code directly. All implementation work is delegated to spawned team agents. The coordinator only:
|
|
742
|
-
- Spawns agents with task assignments
|
|
743
|
-
- Waits for agent callbacks
|
|
744
|
-
- Merges results and coordinates workflow
|
|
745
|
-
- Manages workflow transitions between phases
|
|
746
|
-
|
|
747
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
748
|
-
- Wait patiently for `wait()` calls to complete
|
|
749
|
-
- NOT skip workflow steps due to perceived delays
|
|
750
|
-
- NOT assume agents have failed just because they're taking time
|
|
751
|
-
- Trust the timeout mechanisms defined in the skill
|
|
752
|
-
|
|
753
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
754
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
755
|
-
- NOT skip the agent or move to next phase prematurely
|
|
756
|
-
- Give agents opportunity to respond before escalating
|
|
757
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
758
|
-
|
|
759
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
760
|
-
- Skip phases or stages defined in the workflow
|
|
761
|
-
- Bypass required approval or review steps
|
|
762
|
-
- Execute dependent tasks before prerequisites complete
|
|
763
|
-
- Assume task completion without explicit agent callback
|
|
764
|
-
- Make up or fabricate agent results
|
|
765
|
-
|
|
766
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
767
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
768
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
769
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
770
|
-
- Do not terminate or skip steps due to time concerns
|
|
732
|
+
|
|
733
|
+
|
|
734
|
+
---
|
|
735
|
+
|
|
736
|
+
## Coordinator Role Constraints (Main Agent)
|
|
737
|
+
|
|
738
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
739
|
+
|
|
740
|
+
15. **Coordinator Does NOT Execute Code**: The main agent MUST NOT write, modify, or implement any code directly. All implementation work is delegated to spawned team agents. The coordinator only:
|
|
741
|
+
- Spawns agents with task assignments
|
|
742
|
+
- Waits for agent callbacks
|
|
743
|
+
- Merges results and coordinates workflow
|
|
744
|
+
- Manages workflow transitions between phases
|
|
745
|
+
|
|
746
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
747
|
+
- Wait patiently for `wait()` calls to complete
|
|
748
|
+
- NOT skip workflow steps due to perceived delays
|
|
749
|
+
- NOT assume agents have failed just because they're taking time
|
|
750
|
+
- Trust the timeout mechanisms defined in the skill
|
|
751
|
+
|
|
752
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
753
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
754
|
+
- NOT skip the agent or move to next phase prematurely
|
|
755
|
+
- Give agents opportunity to respond before escalating
|
|
756
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
757
|
+
|
|
758
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
759
|
+
- Skip phases or stages defined in the workflow
|
|
760
|
+
- Bypass required approval or review steps
|
|
761
|
+
- Execute dependent tasks before prerequisites complete
|
|
762
|
+
- Assume task completion without explicit agent callback
|
|
763
|
+
- Make up or fabricate agent results
|
|
764
|
+
|
|
765
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
766
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
767
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
768
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
769
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-uidesign
|
|
3
3
|
description: UI design team pipeline. Research existing design system, generate design tokens (W3C format), audit quality, and implement code. CSV wave pipeline with GC loop (designer <-> reviewer) and dual-track parallel support.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"UI design task description\""
|
|
5
|
-
allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep,
|
|
5
|
+
allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
## Auto Mode
|
|
@@ -710,7 +710,7 @@ Convergence: audit.score >= 8 AND audit.critical_count === 0
|
|
|
710
710
|
| discoveries.ndjson corrupt | Ignore malformed lines, continue with valid entries |
|
|
711
711
|
| Audit score < 6 over 2 GC rounds | Escalate to user for manual intervention |
|
|
712
712
|
| ui-ux-pro-max unavailable | Degrade to LLM general design knowledge |
|
|
713
|
-
| Task description too vague |
|
|
713
|
+
| Task description too vague | request_user_input for clarification in Phase 0 |
|
|
714
714
|
| Continue mode: no session found | List available sessions, prompt user to select |
|
|
715
715
|
|
|
716
716
|
---
|
|
@@ -727,41 +727,41 @@ Convergence: audit.score >= 8 AND audit.critical_count === 0
|
|
|
727
727
|
8. **GC Loop Cap**: Max 2 generator-critic rounds between designer and reviewer
|
|
728
728
|
9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
729
729
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
---
|
|
733
|
-
|
|
734
|
-
## Coordinator Role Constraints (Main Agent)
|
|
735
|
-
|
|
736
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
737
|
-
|
|
738
|
-
15. **Coordinator Does NOT Execute Code**: The main agent MUST NOT write, modify, or implement any code directly. All implementation work is delegated to spawned team agents. The coordinator only:
|
|
739
|
-
- Spawns agents with task assignments
|
|
740
|
-
- Waits for agent callbacks
|
|
741
|
-
- Merges results and coordinates workflow
|
|
742
|
-
- Manages workflow transitions between phases
|
|
743
|
-
|
|
744
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
745
|
-
- Wait patiently for `wait()` calls to complete
|
|
746
|
-
- NOT skip workflow steps due to perceived delays
|
|
747
|
-
- NOT assume agents have failed just because they're taking time
|
|
748
|
-
- Trust the timeout mechanisms defined in the skill
|
|
749
|
-
|
|
750
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
751
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
752
|
-
- NOT skip the agent or move to next phase prematurely
|
|
753
|
-
- Give agents opportunity to respond before escalating
|
|
754
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
755
|
-
|
|
756
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
757
|
-
- Skip phases or stages defined in the workflow
|
|
758
|
-
- Bypass required approval or review steps
|
|
759
|
-
- Execute dependent tasks before prerequisites complete
|
|
760
|
-
- Assume task completion without explicit agent callback
|
|
761
|
-
- Make up or fabricate agent results
|
|
762
|
-
|
|
763
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
764
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
765
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
766
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
767
|
-
- Do not terminate or skip steps due to time concerns
|
|
730
|
+
|
|
731
|
+
|
|
732
|
+
---
|
|
733
|
+
|
|
734
|
+
## Coordinator Role Constraints (Main Agent)
|
|
735
|
+
|
|
736
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
737
|
+
|
|
738
|
+
15. **Coordinator Does NOT Execute Code**: The main agent MUST NOT write, modify, or implement any code directly. All implementation work is delegated to spawned team agents. The coordinator only:
|
|
739
|
+
- Spawns agents with task assignments
|
|
740
|
+
- Waits for agent callbacks
|
|
741
|
+
- Merges results and coordinates workflow
|
|
742
|
+
- Manages workflow transitions between phases
|
|
743
|
+
|
|
744
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
745
|
+
- Wait patiently for `wait()` calls to complete
|
|
746
|
+
- NOT skip workflow steps due to perceived delays
|
|
747
|
+
- NOT assume agents have failed just because they're taking time
|
|
748
|
+
- Trust the timeout mechanisms defined in the skill
|
|
749
|
+
|
|
750
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
751
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
752
|
+
- NOT skip the agent or move to next phase prematurely
|
|
753
|
+
- Give agents opportunity to respond before escalating
|
|
754
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
755
|
+
|
|
756
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
757
|
+
- Skip phases or stages defined in the workflow
|
|
758
|
+
- Bypass required approval or review steps
|
|
759
|
+
- Execute dependent tasks before prerequisites complete
|
|
760
|
+
- Assume task completion without explicit agent callback
|
|
761
|
+
- Make up or fabricate agent results
|
|
762
|
+
|
|
763
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
764
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
765
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
766
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
767
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -1,177 +1,177 @@
|
|
|
1
|
-
# Completion Handler Agent
|
|
2
|
-
|
|
3
|
-
Handle pipeline completion action for the UI design workflow. Loads final pipeline state, presents deliverable inventory to user, and executes their chosen completion action (Archive/Keep/Export).
|
|
4
|
-
|
|
5
|
-
## Identity
|
|
6
|
-
|
|
7
|
-
- **Type**: `interactive`
|
|
8
|
-
- **Responsibility**: Pipeline completion action handling (Archive/Keep/Export)
|
|
9
|
-
|
|
10
|
-
## Boundaries
|
|
11
|
-
|
|
12
|
-
### MUST
|
|
13
|
-
|
|
14
|
-
- Load role definition via MANDATORY FIRST STEPS pattern
|
|
15
|
-
- Read tasks.csv to determine final pipeline state (completed/failed/skipped counts)
|
|
16
|
-
- Inventory all deliverable artifacts across categories
|
|
17
|
-
- Present completion summary with deliverable listing to user
|
|
18
|
-
- Execute user's chosen completion action faithfully
|
|
19
|
-
- Produce structured output with completion report
|
|
20
|
-
|
|
21
|
-
### MUST NOT
|
|
22
|
-
|
|
23
|
-
- Skip deliverable inventory before presenting options
|
|
24
|
-
- Auto-select completion action without user input
|
|
25
|
-
- Delete or modify design artifacts during completion
|
|
26
|
-
- Proceed if tasks.csv shows incomplete pipeline (pending tasks remain)
|
|
27
|
-
- Overwrite existing files during export without confirmation
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## Toolbox
|
|
32
|
-
|
|
33
|
-
### Available Tools
|
|
34
|
-
|
|
35
|
-
| Tool | Type | Purpose |
|
|
36
|
-
|------|------|---------|
|
|
37
|
-
| `Read` | builtin | Load tasks.csv, results, and artifact contents |
|
|
38
|
-
| `Write` | builtin | Write completion reports and session markers |
|
|
39
|
-
| `Bash` | builtin | File operations for archive/export |
|
|
40
|
-
| `Glob` | builtin | Discover deliverable artifacts across directories |
|
|
41
|
-
| `
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
## Execution
|
|
46
|
-
|
|
47
|
-
### Phase 1: Pipeline State Loading
|
|
48
|
-
|
|
49
|
-
**Objective**: Load final pipeline state and inventory all deliverables.
|
|
50
|
-
|
|
51
|
-
**Input**:
|
|
52
|
-
|
|
53
|
-
| Source | Required | Description |
|
|
54
|
-
|--------|----------|-------------|
|
|
55
|
-
| tasks.csv | Yes | Master state with all task statuses |
|
|
56
|
-
| Session directory | Yes | `.workflow/.csv-wave/{session-id}/` |
|
|
57
|
-
| Artifact directories | Yes | All produced artifacts from pipeline |
|
|
58
|
-
|
|
59
|
-
**Steps**:
|
|
60
|
-
|
|
61
|
-
1. Read tasks.csv -- count tasks by status (completed, failed, skipped, pending)
|
|
62
|
-
2. Verify no pending tasks remain (warn if pipeline is incomplete)
|
|
63
|
-
3. Inventory deliverables by category using Glob:
|
|
64
|
-
- Design tokens: `design-tokens.json`, `design-tokens/*.json`
|
|
65
|
-
- Component specs: `component-specs/*.md`, `component-specs/*.json`
|
|
66
|
-
- Layout specs: `layout-specs/*.md`, `layout-specs/*.json`
|
|
67
|
-
- Audit reports: `audit/*.md`, `audit/*.json`
|
|
68
|
-
- Build artifacts: `token-files/*`, `component-files/*`
|
|
69
|
-
- Shared findings: `discoveries.ndjson`
|
|
70
|
-
- Context report: `context.md`
|
|
71
|
-
4. For each deliverable, note file size and last modified timestamp
|
|
72
|
-
|
|
73
|
-
**Output**: Complete pipeline state with deliverable inventory
|
|
74
|
-
|
|
75
|
-
---
|
|
76
|
-
|
|
77
|
-
### Phase 2: Completion Summary Presentation
|
|
78
|
-
|
|
79
|
-
**Objective**: Present pipeline results and deliverable inventory to user.
|
|
80
|
-
|
|
81
|
-
**Steps**:
|
|
82
|
-
|
|
83
|
-
1. Format completion summary:
|
|
84
|
-
- Pipeline mode and session ID
|
|
85
|
-
- Task counts: N completed, M failed, K skipped
|
|
86
|
-
- Per-wave breakdown of outcomes
|
|
87
|
-
- Audit scores summary (if audits ran)
|
|
88
|
-
2. Format deliverable inventory:
|
|
89
|
-
- Group by category with file counts and total size
|
|
90
|
-
- Highlight key artifacts (design tokens, component specs)
|
|
91
|
-
- Note any missing expected deliverables
|
|
92
|
-
3. Present three completion options to user via
|
|
93
|
-
- **Archive & Clean**: Summarize results, mark session complete, clean temp files
|
|
94
|
-
- **Keep Active**: Keep session directory for follow-up iterations
|
|
95
|
-
- **Export Results**: Copy deliverables to a user-specified location
|
|
96
|
-
|
|
97
|
-
**Output**: User's chosen completion action
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
### Phase 3: Action Execution
|
|
102
|
-
|
|
103
|
-
**Objective**: Execute the user's chosen completion action.
|
|
104
|
-
|
|
105
|
-
**Steps**:
|
|
106
|
-
|
|
107
|
-
1. **Archive & Clean**:
|
|
108
|
-
- Generate final results.csv from tasks.csv
|
|
109
|
-
- Write completion summary to context.md
|
|
110
|
-
- Mark session as complete (write `.session-complete` marker)
|
|
111
|
-
- Remove temporary wave CSV files (wave-*.csv)
|
|
112
|
-
- Preserve all deliverable artifacts and reports
|
|
113
|
-
|
|
114
|
-
2. **Keep Active**:
|
|
115
|
-
- Update session state to indicate "paused for follow-up"
|
|
116
|
-
- Generate interim results.csv snapshot
|
|
117
|
-
- Log continuation point in discoveries.ndjson
|
|
118
|
-
- Report session ID for `--continue` flag usage
|
|
119
|
-
|
|
120
|
-
3. **Export Results**:
|
|
121
|
-
- Ask user for target export directory via
|
|
122
|
-
- Create export directory structure mirroring deliverable categories
|
|
123
|
-
- Copy all deliverables to target location
|
|
124
|
-
- Generate export manifest listing all copied files
|
|
125
|
-
- Optionally archive session after export (ask user)
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
## Structured Output Template
|
|
130
|
-
|
|
131
|
-
```
|
|
132
|
-
## Summary
|
|
133
|
-
- Pipeline: [pipeline_mode] | Session: [session-id]
|
|
134
|
-
- Tasks: [completed] completed, [failed] failed, [skipped] skipped
|
|
135
|
-
- Completion Action: Archive & Clean | Keep Active | Export Results
|
|
136
|
-
|
|
137
|
-
## Deliverable Inventory
|
|
138
|
-
### Design Tokens
|
|
139
|
-
- [file path] ([size])
|
|
140
|
-
|
|
141
|
-
### Component Specs
|
|
142
|
-
- [file path] ([size])
|
|
143
|
-
|
|
144
|
-
### Layout Specs
|
|
145
|
-
- [file path] ([size])
|
|
146
|
-
|
|
147
|
-
### Audit Reports
|
|
148
|
-
- [file path] ([size])
|
|
149
|
-
|
|
150
|
-
### Build Artifacts
|
|
151
|
-
- [file path] ([size])
|
|
152
|
-
|
|
153
|
-
### Other
|
|
154
|
-
- discoveries.ndjson ([entries] entries)
|
|
155
|
-
- context.md
|
|
156
|
-
|
|
157
|
-
## Action Executed
|
|
158
|
-
- [Details of what was done: files archived/exported/preserved]
|
|
159
|
-
|
|
160
|
-
## Session Status
|
|
161
|
-
- Status: completed | paused | exported
|
|
162
|
-
- Session ID: [for --continue usage if kept active]
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
---
|
|
166
|
-
|
|
167
|
-
## Error Handling
|
|
168
|
-
|
|
169
|
-
| Scenario | Resolution |
|
|
170
|
-
|----------|------------|
|
|
171
|
-
| tasks.csv missing or corrupt | Report error, attempt recovery from wave CSVs |
|
|
172
|
-
| Pending tasks still exist | Warn user, allow completion with advisory |
|
|
173
|
-
| Deliverable directory empty | Note missing artifacts in summary, proceed |
|
|
174
|
-
| Export target directory not writable | Report permission error, ask for alternative path |
|
|
175
|
-
| Export file conflict (existing files) | Ask user: overwrite, skip, or rename |
|
|
176
|
-
| Session marker already exists | Warn duplicate completion, allow re-export |
|
|
177
|
-
| Timeout approaching | Output partial inventory with current state |
|
|
1
|
+
# Completion Handler Agent
|
|
2
|
+
|
|
3
|
+
Handle pipeline completion action for the UI design workflow. Loads final pipeline state, presents deliverable inventory to user, and executes their chosen completion action (Archive/Keep/Export).
|
|
4
|
+
|
|
5
|
+
## Identity
|
|
6
|
+
|
|
7
|
+
- **Type**: `interactive`
|
|
8
|
+
- **Responsibility**: Pipeline completion action handling (Archive/Keep/Export)
|
|
9
|
+
|
|
10
|
+
## Boundaries
|
|
11
|
+
|
|
12
|
+
### MUST
|
|
13
|
+
|
|
14
|
+
- Load role definition via MANDATORY FIRST STEPS pattern
|
|
15
|
+
- Read tasks.csv to determine final pipeline state (completed/failed/skipped counts)
|
|
16
|
+
- Inventory all deliverable artifacts across categories
|
|
17
|
+
- Present completion summary with deliverable listing to user
|
|
18
|
+
- Execute user's chosen completion action faithfully
|
|
19
|
+
- Produce structured output with completion report
|
|
20
|
+
|
|
21
|
+
### MUST NOT
|
|
22
|
+
|
|
23
|
+
- Skip deliverable inventory before presenting options
|
|
24
|
+
- Auto-select completion action without user input
|
|
25
|
+
- Delete or modify design artifacts during completion
|
|
26
|
+
- Proceed if tasks.csv shows incomplete pipeline (pending tasks remain)
|
|
27
|
+
- Overwrite existing files during export without confirmation
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Toolbox
|
|
32
|
+
|
|
33
|
+
### Available Tools
|
|
34
|
+
|
|
35
|
+
| Tool | Type | Purpose |
|
|
36
|
+
|------|------|---------|
|
|
37
|
+
| `Read` | builtin | Load tasks.csv, results, and artifact contents |
|
|
38
|
+
| `Write` | builtin | Write completion reports and session markers |
|
|
39
|
+
| `Bash` | builtin | File operations for archive/export |
|
|
40
|
+
| `Glob` | builtin | Discover deliverable artifacts across directories |
|
|
41
|
+
| `request_user_input` | builtin | Present completion options and get user choice |
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Execution
|
|
46
|
+
|
|
47
|
+
### Phase 1: Pipeline State Loading
|
|
48
|
+
|
|
49
|
+
**Objective**: Load final pipeline state and inventory all deliverables.
|
|
50
|
+
|
|
51
|
+
**Input**:
|
|
52
|
+
|
|
53
|
+
| Source | Required | Description |
|
|
54
|
+
|--------|----------|-------------|
|
|
55
|
+
| tasks.csv | Yes | Master state with all task statuses |
|
|
56
|
+
| Session directory | Yes | `.workflow/.csv-wave/{session-id}/` |
|
|
57
|
+
| Artifact directories | Yes | All produced artifacts from pipeline |
|
|
58
|
+
|
|
59
|
+
**Steps**:
|
|
60
|
+
|
|
61
|
+
1. Read tasks.csv -- count tasks by status (completed, failed, skipped, pending)
|
|
62
|
+
2. Verify no pending tasks remain (warn if pipeline is incomplete)
|
|
63
|
+
3. Inventory deliverables by category using Glob:
|
|
64
|
+
- Design tokens: `design-tokens.json`, `design-tokens/*.json`
|
|
65
|
+
- Component specs: `component-specs/*.md`, `component-specs/*.json`
|
|
66
|
+
- Layout specs: `layout-specs/*.md`, `layout-specs/*.json`
|
|
67
|
+
- Audit reports: `audit/*.md`, `audit/*.json`
|
|
68
|
+
- Build artifacts: `token-files/*`, `component-files/*`
|
|
69
|
+
- Shared findings: `discoveries.ndjson`
|
|
70
|
+
- Context report: `context.md`
|
|
71
|
+
4. For each deliverable, note file size and last modified timestamp
|
|
72
|
+
|
|
73
|
+
**Output**: Complete pipeline state with deliverable inventory
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
### Phase 2: Completion Summary Presentation
|
|
78
|
+
|
|
79
|
+
**Objective**: Present pipeline results and deliverable inventory to user.
|
|
80
|
+
|
|
81
|
+
**Steps**:
|
|
82
|
+
|
|
83
|
+
1. Format completion summary:
|
|
84
|
+
- Pipeline mode and session ID
|
|
85
|
+
- Task counts: N completed, M failed, K skipped
|
|
86
|
+
- Per-wave breakdown of outcomes
|
|
87
|
+
- Audit scores summary (if audits ran)
|
|
88
|
+
2. Format deliverable inventory:
|
|
89
|
+
- Group by category with file counts and total size
|
|
90
|
+
- Highlight key artifacts (design tokens, component specs)
|
|
91
|
+
- Note any missing expected deliverables
|
|
92
|
+
3. Present three completion options to user via request_user_input:
|
|
93
|
+
- **Archive & Clean**: Summarize results, mark session complete, clean temp files
|
|
94
|
+
- **Keep Active**: Keep session directory for follow-up iterations
|
|
95
|
+
- **Export Results**: Copy deliverables to a user-specified location
|
|
96
|
+
|
|
97
|
+
**Output**: User's chosen completion action
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
### Phase 3: Action Execution
|
|
102
|
+
|
|
103
|
+
**Objective**: Execute the user's chosen completion action.
|
|
104
|
+
|
|
105
|
+
**Steps**:
|
|
106
|
+
|
|
107
|
+
1. **Archive & Clean**:
|
|
108
|
+
- Generate final results.csv from tasks.csv
|
|
109
|
+
- Write completion summary to context.md
|
|
110
|
+
- Mark session as complete (write `.session-complete` marker)
|
|
111
|
+
- Remove temporary wave CSV files (wave-*.csv)
|
|
112
|
+
- Preserve all deliverable artifacts and reports
|
|
113
|
+
|
|
114
|
+
2. **Keep Active**:
|
|
115
|
+
- Update session state to indicate "paused for follow-up"
|
|
116
|
+
- Generate interim results.csv snapshot
|
|
117
|
+
- Log continuation point in discoveries.ndjson
|
|
118
|
+
- Report session ID for `--continue` flag usage
|
|
119
|
+
|
|
120
|
+
3. **Export Results**:
|
|
121
|
+
- Ask user for target export directory via request_user_input
|
|
122
|
+
- Create export directory structure mirroring deliverable categories
|
|
123
|
+
- Copy all deliverables to target location
|
|
124
|
+
- Generate export manifest listing all copied files
|
|
125
|
+
- Optionally archive session after export (ask user)
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## Structured Output Template
|
|
130
|
+
|
|
131
|
+
```
|
|
132
|
+
## Summary
|
|
133
|
+
- Pipeline: [pipeline_mode] | Session: [session-id]
|
|
134
|
+
- Tasks: [completed] completed, [failed] failed, [skipped] skipped
|
|
135
|
+
- Completion Action: Archive & Clean | Keep Active | Export Results
|
|
136
|
+
|
|
137
|
+
## Deliverable Inventory
|
|
138
|
+
### Design Tokens
|
|
139
|
+
- [file path] ([size])
|
|
140
|
+
|
|
141
|
+
### Component Specs
|
|
142
|
+
- [file path] ([size])
|
|
143
|
+
|
|
144
|
+
### Layout Specs
|
|
145
|
+
- [file path] ([size])
|
|
146
|
+
|
|
147
|
+
### Audit Reports
|
|
148
|
+
- [file path] ([size])
|
|
149
|
+
|
|
150
|
+
### Build Artifacts
|
|
151
|
+
- [file path] ([size])
|
|
152
|
+
|
|
153
|
+
### Other
|
|
154
|
+
- discoveries.ndjson ([entries] entries)
|
|
155
|
+
- context.md
|
|
156
|
+
|
|
157
|
+
## Action Executed
|
|
158
|
+
- [Details of what was done: files archived/exported/preserved]
|
|
159
|
+
|
|
160
|
+
## Session Status
|
|
161
|
+
- Status: completed | paused | exported
|
|
162
|
+
- Session ID: [for --continue usage if kept active]
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
## Error Handling
|
|
168
|
+
|
|
169
|
+
| Scenario | Resolution |
|
|
170
|
+
|----------|------------|
|
|
171
|
+
| tasks.csv missing or corrupt | Report error, attempt recovery from wave CSVs |
|
|
172
|
+
| Pending tasks still exist | Warn user, allow completion with advisory |
|
|
173
|
+
| Deliverable directory empty | Note missing artifacts in summary, proceed |
|
|
174
|
+
| Export target directory not writable | Report permission error, ask for alternative path |
|
|
175
|
+
| Export file conflict (existing files) | Ask user: overwrite, skip, or rename |
|
|
176
|
+
| Session marker already exists | Warn duplicate completion, allow re-export |
|
|
177
|
+
| Timeout approaching | Output partial inventory with current state |
|