@@ -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```
8686TaskCreate({
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({
107129TaskCreate({
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({
138169TaskCreate({
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