Skip to content

Commit f61a3da

Browse files
author
catlog22
committed
feat(dispatch): update task description template for improved clarity and structure
1 parent b0fb899 commit f61a3da

1 file changed

Lines changed: 57 additions & 17 deletions

File tree

  • .claude/skills/team-lifecycle-v5/roles/coordinator/commands

.claude/skills/team-lifecycle-v5/roles/coordinator/commands/dispatch.md

Lines changed: 57 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -80,18 +80,40 @@ GC loop (max 2 rounds): QA-FE verdict=NEEDS_FIX -> create DEV-FE-002 + QA-FE-002
8080

8181
### Task Description Template
8282

83-
Every task description includes session, scope, and metadata:
83+
Every task description uses structured format for clarity:
8484

8585
```
8686
TaskCreate({
8787
subject: "<TASK-ID>",
8888
owner: "<role>",
89-
description: "<task description>\nSession: <session-folder>\nScope: <scope>\nInlineDiscuss: <DISCUSS-NNN or none>\nInnerLoop: <true|false>",
89+
description: "PURPOSE: <what this task achieves> | Success: <measurable completion criteria>
90+
TASK:
91+
- <step 1: specific action>
92+
- <step 2: specific action>
93+
- <step 3: specific action>
94+
CONTEXT:
95+
- Session: <session-folder>
96+
- Scope: <scope>
97+
- Upstream artifacts: <artifact-1.md>, <artifact-2.md>
98+
- Key files: <file1>, <file2> (if applicable)
99+
- Shared memory: <session>/shared-memory.json
100+
EXPECTED: <deliverable path> + <quality criteria>
101+
CONSTRAINTS: <scope limits, focus areas>
102+
---
103+
InlineDiscuss: <DISCUSS-NNN or none>
104+
InnerLoop: <true|false>",
90105
blockedBy: [<dependency-list>],
91106
status: "pending"
92107
})
93108
```
94109

110+
**Field Guidelines**:
111+
- **PURPOSE**: Clear goal statement + success criteria
112+
- **TASK**: 2-5 actionable steps with specific verbs
113+
- **CONTEXT**: Session path, scope, upstream artifacts, relevant files
114+
- **EXPECTED**: Output artifact path + quality requirements
115+
- **CONSTRAINTS**: Scope boundaries, focus areas, exclusions
116+
95117
**InnerLoop Flag Rules**:
96118

97119
| Role | InnerLoop |
@@ -107,13 +129,22 @@ TaskCreate({
107129
TaskCreate({
108130
subject: "<ORIGINAL-ID>-R1",
109131
owner: "<same-role-as-original>",
110-
description: "<revision-type> revision of <ORIGINAL-ID>.\n
111-
Session: <session-folder>\n
112-
Original artifact: <artifact-path>\n
113-
User feedback: <feedback-text or 'system-initiated'>\n
114-
Revision scope: <targeted|full>\n
115-
InlineDiscuss: <same-discuss-round-as-original>\n
116-
InnerLoop: <true|false based on role>",
132+
description: "PURPOSE: <revision-type> revision of <ORIGINAL-ID> | Success: Address feedback and pass quality checks
133+
TASK:
134+
- Review original artifact and feedback
135+
- Apply targeted fixes to weak areas
136+
- Validate against quality criteria
137+
CONTEXT:
138+
- Session: <session-folder>
139+
- Original artifact: <artifact-path>
140+
- User feedback: <feedback-text or 'system-initiated'>
141+
- Revision scope: <targeted|full>
142+
- Shared memory: <session>/shared-memory.json
143+
EXPECTED: Updated artifact at <artifact-path> + revision summary
144+
CONSTRAINTS: <revision scope limits>
145+
---
146+
InlineDiscuss: <same-discuss-round-as-original>
147+
InnerLoop: <true|false based on role>",
117148
status: "pending",
118149
blockedBy: [<predecessor-R1 if cascaded>]
119150
})
@@ -138,14 +169,23 @@ TaskCreate({
138169
TaskCreate({
139170
subject: "IMPROVE-<dimension>-001",
140171
owner: "writer",
141-
description: "Quality improvement: <dimension>.\n
142-
Session: <session-folder>\n
143-
Current score: <X>%\n
144-
Target: 80%\n
145-
Readiness report: <session>/spec/readiness-report.md\n
146-
Weak areas: <extracted-from-report>\n
147-
Strategy: <from-dimension-strategy-table>\n
148-
InnerLoop: true",
172+
description: "PURPOSE: Improve <dimension> quality from <X>% to 80% | Success: Pass quality threshold
173+
TASK:
174+
- Review readiness report weak areas
175+
- Apply dimension-specific improvement strategy
176+
- Validate improvements against criteria
177+
CONTEXT:
178+
- Session: <session-folder>
179+
- Current score: <X>%
180+
- Target: 80%
181+
- Readiness report: <session>/spec/readiness-report.md
182+
- Weak areas: <extracted-from-report>
183+
- Strategy: <from-dimension-strategy-table>
184+
- Shared memory: <session>/shared-memory.json
185+
EXPECTED: Improved artifacts + quality improvement summary
186+
CONSTRAINTS: Focus on <dimension> only
187+
---
188+
InnerLoop: true",
149189
status: "pending"
150190
})
151191
```

0 commit comments

Comments
 (0)