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.
Files changed (75) hide show
  1. package/.claude/commands/workflow/analyze-with-file.md +7 -0
  2. package/.codex/skills/analyze-with-file/SKILL.md +1181 -1182
  3. package/.codex/skills/brainstorm/SKILL.md +723 -725
  4. package/.codex/skills/brainstorm-with-file/SKILL.md +10 -5
  5. package/.codex/skills/clean/SKILL.md +33 -26
  6. package/.codex/skills/collaborative-plan-with-file/SKILL.md +830 -831
  7. package/.codex/skills/csv-wave-pipeline/SKILL.md +906 -906
  8. package/.codex/skills/issue-discover/SKILL.md +57 -50
  9. package/.codex/skills/issue-discover/phases/01-issue-new.md +18 -11
  10. package/.codex/skills/issue-discover/phases/02-discover.md +31 -26
  11. package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +13 -11
  12. package/.codex/skills/issue-discover/phases/04-quick-execute.md +32 -27
  13. package/.codex/skills/parallel-dev-cycle/SKILL.md +402 -402
  14. package/.codex/skills/project-documentation-workflow/SKILL.md +13 -3
  15. package/.codex/skills/roadmap-with-file/SKILL.md +901 -897
  16. package/.codex/skills/session-sync/SKILL.md +222 -212
  17. package/.codex/skills/spec-add/SKILL.md +620 -613
  18. package/.codex/skills/spec-generator/SKILL.md +2 -2
  19. package/.codex/skills/spec-generator/phases/01-5-requirement-clarification.md +10 -10
  20. package/.codex/skills/spec-generator/phases/01-discovery.md +11 -18
  21. package/.codex/skills/spec-generator/phases/02-product-brief.md +5 -5
  22. package/.codex/skills/spec-generator/phases/03-requirements.md +7 -7
  23. package/.codex/skills/spec-generator/phases/04-architecture.md +4 -4
  24. package/.codex/skills/spec-generator/phases/05-epics-stories.md +5 -6
  25. package/.codex/skills/spec-generator/phases/06-readiness-check.md +10 -17
  26. package/.codex/skills/spec-generator/phases/07-issue-export.md +326 -329
  27. package/.codex/skills/spec-setup/SKILL.md +669 -657
  28. package/.codex/skills/team-arch-opt/SKILL.md +50 -50
  29. package/.codex/skills/team-arch-opt/agents/completion-handler.md +3 -3
  30. package/.codex/skills/team-brainstorm/SKILL.md +724 -725
  31. package/.codex/skills/team-coordinate/SKILL.md +51 -51
  32. package/.codex/skills/team-coordinate/agents/completion-handler.md +3 -3
  33. package/.codex/skills/team-coordinate/agents/plan-reviewer.md +4 -4
  34. package/.codex/skills/team-designer/SKILL.md +691 -691
  35. package/.codex/skills/team-designer/agents/requirement-clarifier.md +11 -12
  36. package/.codex/skills/team-executor/SKILL.md +45 -45
  37. package/.codex/skills/team-frontend/SKILL.md +45 -45
  38. package/.codex/skills/team-frontend/agents/completion-handler.md +3 -3
  39. package/.codex/skills/team-frontend/agents/qa-gate-reviewer.md +4 -4
  40. package/.codex/skills/team-frontend-debug/SKILL.md +50 -50
  41. package/.codex/skills/team-frontend-debug/agents/completion-handler.md +3 -3
  42. package/.codex/skills/team-frontend-debug/agents/conditional-skip-gate.md +4 -4
  43. package/.codex/skills/team-issue/SKILL.md +751 -740
  44. package/.codex/skills/team-iterdev/SKILL.md +825 -826
  45. package/.codex/skills/team-lifecycle-v4/SKILL.md +775 -775
  46. package/.codex/skills/team-lifecycle-v4/agents/quality-gate.md +165 -165
  47. package/.codex/skills/team-lifecycle-v4/agents/requirement-clarifier.md +163 -163
  48. package/.codex/skills/team-perf-opt/SKILL.md +50 -50
  49. package/.codex/skills/team-perf-opt/agents/completion-handler.md +3 -3
  50. package/.codex/skills/team-planex-v2/SKILL.md +652 -637
  51. package/.codex/skills/team-quality-assurance/SKILL.md +51 -52
  52. package/.codex/skills/team-review/SKILL.md +40 -40
  53. package/.codex/skills/team-roadmap-dev/SKILL.md +51 -51
  54. package/.codex/skills/team-roadmap-dev/agents/roadmap-discusser.md +8 -8
  55. package/.codex/skills/team-tech-debt/SKILL.md +50 -50
  56. package/.codex/skills/team-tech-debt/agents/plan-approver.md +5 -5
  57. package/.codex/skills/team-testing/SKILL.md +51 -52
  58. package/.codex/skills/team-uidesign/SKILL.md +40 -40
  59. package/.codex/skills/team-uidesign/agents/completion-handler.md +177 -177
  60. package/.codex/skills/team-ultra-analyze/SKILL.md +786 -787
  61. package/.codex/skills/team-ultra-analyze/agents/discussion-feedback.md +8 -8
  62. package/.codex/skills/team-ux-improve/SKILL.md +51 -52
  63. package/.codex/skills/team-ux-improve/agents/ux-designer.md +2 -2
  64. package/.codex/skills/team-ux-improve/agents/ux-explorer.md +1 -1
  65. package/.codex/skills/unified-execute-with-file/SKILL.md +797 -796
  66. package/.codex/skills/workflow-execute/SKILL.md +1117 -1118
  67. package/.codex/skills/workflow-lite-planex/SKILL.md +1144 -1141
  68. package/.codex/skills/workflow-plan/SKILL.md +631 -636
  69. package/.codex/skills/workflow-tdd-plan/SKILL.md +753 -759
  70. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -392
  71. package/README.md +25 -0
  72. package/ccw/dist/commands/install.d.ts.map +1 -1
  73. package/ccw/dist/commands/install.js +12 -0
  74. package/ccw/dist/commands/install.js.map +1 -1
  75. 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, AskUserQuestion
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
- AskUserQuestion({
277
+ request_user_input({
278
278
  questions: [{
279
- question: "Detected scope suggests the '" + pipeline + "' pipeline. Confirm?",
280
- header: "Pipeline Selection",
281
- multiSelect: false,
279
+ question: `Detected scope suggests '${pipeline}' pipeline. Approve or override?`,
280
+ header: "Pipeline",
281
+ id: "pipeline_select",
282
282
  options: [
283
- { label: "Proceed with " + pipeline, description: "Detected pipeline is appropriate" },
284
- { label: "Use targeted", description: "Minimal: L1 only" },
285
- { label: "Use standard", description: "Progressive: L1 + L2 + analysis" },
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
- AskUserQuestion({
527
+ request_user_input({
529
528
  questions: [{
530
- question: "Testing pipeline complete. What would you like to do?",
531
- header: "Completion",
532
- multiSelect: false,
529
+ question: "Testing pipeline complete. Choose next action.",
530
+ header: "Done",
531
+ id: "completion",
533
532
  options: [
534
- { label: "Archive & Clean (Recommended)", description: "Archive session, output final summary" },
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, AskUserQuestion
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 | AskUserQuestion for clarification in Phase 0 |
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
- | `AskUserQuestion` | 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 AskUserQuestion:
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 AskUserQuestion
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 |