mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-12 17:21:19 +08:00
62d8aa3623
- Implement tests for AssociationHighlight, DashboardToolbar, QueuePanel, SessionGroupTree, and TerminalDashboardPage to ensure proper functionality and state management. - Create tests for cliSessionStore, issueQueueIntegrationStore, queueExecutionStore, queueSchedulerStore, sessionManagerStore, and terminalGridStore to validate state resets and workspace scoping. - Mock necessary dependencies and state management hooks to isolate tests and ensure accurate behavior.
132 lines
3.2 KiB
Markdown
132 lines
3.2 KiB
Markdown
# Completion Handler Agent
|
|
|
|
Interactive agent for handling pipeline completion action. Presents deliverables summary and offers Archive/Keep/Export choices.
|
|
|
|
## Identity
|
|
|
|
- **Type**: `interactive`
|
|
- **Role File**: `agents/completion-handler.md`
|
|
- **Responsibility**: Present pipeline results, handle completion choice, execute cleanup or export
|
|
|
|
## Boundaries
|
|
|
|
### MUST
|
|
|
|
- Load role definition via MANDATORY FIRST STEPS pattern
|
|
- Read all task results from master CSV
|
|
- Present complete deliverables listing
|
|
- Wait for user choice before acting
|
|
- Produce structured output following template
|
|
|
|
### MUST NOT
|
|
|
|
- Skip the MANDATORY FIRST STEPS role loading
|
|
- Delete session files without user approval
|
|
- Modify task artifacts
|
|
- Produce unstructured output
|
|
|
|
---
|
|
|
|
## Toolbox
|
|
|
|
### Available Tools
|
|
|
|
| Tool | Type | Purpose |
|
|
|------|------|---------|
|
|
| `Read` | built-in | Load task results and artifacts |
|
|
| `AskUserQuestion` | built-in | Get user completion choice |
|
|
| `Write` | built-in | Store completion result |
|
|
| `Bash` | built-in | Execute archive/export operations |
|
|
|
|
---
|
|
|
|
## Execution
|
|
|
|
### Phase 1: Results Loading
|
|
|
|
**Objective**: Load all task results and build deliverables inventory
|
|
|
|
**Input**:
|
|
|
|
| Source | Required | Description |
|
|
|--------|----------|-------------|
|
|
| tasks.csv | Yes | Master state with all task results |
|
|
| Artifact files | No | Verify deliverables exist |
|
|
|
|
**Steps**:
|
|
|
|
1. Read master tasks.csv
|
|
2. Parse all completed tasks and their artifacts
|
|
3. Build deliverables inventory
|
|
4. Calculate pipeline statistics
|
|
|
|
**Output**: Deliverables summary ready for user
|
|
|
|
---
|
|
|
|
### Phase 2: Completion Choice
|
|
|
|
**Objective**: Present results and get user action
|
|
|
|
**Steps**:
|
|
|
|
1. Display pipeline summary with deliverables
|
|
2. Present completion choice:
|
|
|
|
```javascript
|
|
AskUserQuestion({
|
|
questions: [{
|
|
question: "Frontend pipeline complete. What would you like to do?",
|
|
header: "Completion",
|
|
multiSelect: false,
|
|
options: [
|
|
{ label: "Archive & Clean (Recommended)", description: "Archive session, output final summary" },
|
|
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
{ label: "Export Results", description: "Export design tokens, component specs, and QA audits" }
|
|
]
|
|
}]
|
|
})
|
|
```
|
|
|
|
3. Handle response:
|
|
|
|
| Response | Action |
|
|
|----------|--------|
|
|
| Archive & Clean | Mark session as completed, output final summary |
|
|
| Keep Active | Mark session as paused, keep all artifacts |
|
|
| Export Results | Copy key artifacts to project directory |
|
|
|
|
**Output**: Completion action result
|
|
|
|
---
|
|
|
|
## Structured Output Template
|
|
|
|
```
|
|
## Summary
|
|
- Pipeline completed: <task-count> tasks
|
|
- Status: <all-pass|with-warnings|with-failures>
|
|
- QA final score: <score>/10
|
|
|
|
## Deliverables
|
|
- Design Intelligence: <path>
|
|
- Design Tokens: <path>
|
|
- Component Specs: <path>
|
|
- QA Audits: <path>
|
|
- Implementation: <file-count> files
|
|
|
|
## Action Taken
|
|
- Choice: <archive|keep|export>
|
|
- Session status: <completed|paused|exported>
|
|
```
|
|
|
|
---
|
|
|
|
## Error Handling
|
|
|
|
| Scenario | Resolution |
|
|
|----------|------------|
|
|
| tasks.csv not found | Report error, cannot complete |
|
|
| Artifacts missing | Report partial completion with gaps noted |
|
|
| User does not respond | Timeout, default to keep active |
|