codex-workflows 0.6.8 → 0.6.9

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 (28) hide show
  1. package/.agents/skills/ai-development-guide/SKILL.md +5 -3
  2. package/.agents/skills/ai-development-guide/references/frontend.md +11 -19
  3. package/.agents/skills/coding-rules/references/typescript.md +17 -12
  4. package/.agents/skills/documentation-criteria/references/plan-template.md +1 -1
  5. package/.agents/skills/documentation-criteria/references/task-template.md +8 -0
  6. package/.agents/skills/testing/SKILL.md +5 -5
  7. package/.agents/skills/testing/references/typescript.md +2 -6
  8. package/.codex/agents/acceptance-test-generator.toml +2 -44
  9. package/.codex/agents/code-reviewer.toml +4 -57
  10. package/.codex/agents/code-verifier.toml +1 -47
  11. package/.codex/agents/codebase-analyzer.toml +1 -106
  12. package/.codex/agents/design-sync.toml +2 -64
  13. package/.codex/agents/document-reviewer.toml +3 -78
  14. package/.codex/agents/integration-test-reviewer.toml +1 -26
  15. package/.codex/agents/investigator.toml +1 -73
  16. package/.codex/agents/quality-fixer-frontend.toml +4 -105
  17. package/.codex/agents/quality-fixer.toml +4 -122
  18. package/.codex/agents/requirement-analyzer.toml +1 -29
  19. package/.codex/agents/rule-advisor.toml +1 -79
  20. package/.codex/agents/scope-discoverer.toml +1 -70
  21. package/.codex/agents/security-reviewer.toml +1 -19
  22. package/.codex/agents/solver.toml +5 -54
  23. package/.codex/agents/task-decomposer.toml +18 -0
  24. package/.codex/agents/task-executor-frontend.toml +16 -142
  25. package/.codex/agents/task-executor.toml +16 -142
  26. package/.codex/agents/ui-analyzer.toml +1 -157
  27. package/.codex/agents/verifier.toml +2 -65
  28. package/package.json +1 -1
@@ -156,6 +156,15 @@ When the task file, Dependencies, or Investigation Targets reference `docs/proje
156
156
  3. **Cross-check against Investigation Notes**: Ensure planned implementation is consistent with the observations recorded in the task file
157
157
  4. **Execute determination**: Determine continue/escalation per "Mandatory Judgment Criteria" above
158
158
 
159
+ #### Adjacent Case Sweep (Required when the task file has a `Change Category` field set to one or more of `bug-fix`, `regression`, `state-change`, `boundary-change`)
160
+
161
+ Run this check after Pre-implementation Verification and before the Binding Decision Check. Treat the task file's field value as authoritative for whether the sweep applies.
162
+
163
+ 1. From Investigation Targets, identify cases sharing the same path, contract, persisted state, or external boundary as the change.
164
+ 2. Check each adjacent case for the same class of defect this task corrects.
165
+ 3. Fold adjacent residuals within Target Files into this task's failing tests and implementation.
166
+ 4. Record residuals outside Target Files in Investigation Notes so downstream review can detect them.
167
+
159
168
  #### Binding Decision Check (Required when the task file has a Binding Decisions section)
160
169
 
161
170
  Run this check after Pre-implementation Verification and before the TDD cycle when the task file contains a Binding Decisions section with one or more rows.
@@ -222,29 +231,7 @@ Return one of the following as the final response (see Structured Response Speci
222
231
  Report in the following JSON format upon task completion (**without executing quality checks or commits**, delegating to quality assurance process):
223
232
 
224
233
  ```json
225
- {
226
- "status": "completed",
227
- "taskName": "[Exact name of executed task]",
228
- "changeSummary": "[Specific summary of implementation content/changes]",
229
- "filesModified": ["specific/file/path1", "specific/file/path2"],
230
- "testsAdded": ["created/test/file/path"],
231
- "requiresTestReview": true,
232
- "newTestsPassed": true,
233
- "progressUpdated": {
234
- "taskFile": "5/8 items completed",
235
- "workPlan": "Relevant sections updated",
236
- "designDoc": "Progress section updated or N/A"
237
- },
238
- "runnableCheck": {
239
- "level": "L1: Unit test / L2: Integration test / L3: E2E test",
240
- "executed": true,
241
- "command": "Executed test command",
242
- "result": "passed / failed / skipped",
243
- "reason": "Test execution reason/verification content"
244
- },
245
- "readyForQualityCheck": true,
246
- "nextActions": "Overall quality verification by quality assurance process"
247
- }
234
+ {"status":"completed","taskName":"[Exact name of executed task]","changeSummary":"[Specific summary of implementation content/changes]","filesModified":["specific/file/path1","specific/file/path2"],"testsAdded":["created/test/file/path"],"requiresTestReview":true,"newTestsPassed":true,"progressUpdated":{"taskFile":"5/8 items completed","workPlan":"Relevant sections updated","designDoc":"Progress section updated or N/A"},"runnableCheck":{"level":"L1: Unit test / L2: Integration test / L3: E2E test","executed":true,"command":"Executed test command","result":"passed / failed / skipped","reason":"Test execution reason/verification content"},"readyForQualityCheck":true,"nextActions":"Overall quality verification by quality assurance process"}
248
235
  ```
249
236
 
250
237
  ### 2. Escalation Response
@@ -257,139 +244,35 @@ For task/AC/reference core-mechanism sources, set `details.design_doc_expectatio
257
244
  For core-mechanism violations, put the substitute in `details.actual_situation`, the behavior change in `details.why_cannot_implement`, and the unblock condition in `recommendation`.
258
245
 
259
246
  ```json
260
- {
261
- "status": "escalation_needed",
262
- "reason": "Design Doc deviation",
263
- "taskName": "[Task name being executed]",
264
- "details": {
265
- "design_doc_expectation": "[Exact quote from relevant Design Doc section]",
266
- "actual_situation": "[Details of situation actually encountered]",
267
- "why_cannot_implement": "[Technical reason why cannot implement per Design Doc]",
268
- "attempted_approaches": ["List of solution methods considered for trial"]
269
- },
270
- "escalation_type": "design_compliance_violation",
271
- "user_decision_required": true,
272
- "suggested_options": [
273
- "Modify Design Doc to match reality",
274
- "Implement missing components first",
275
- "Reconsider requirements and change implementation approach"
276
- ],
277
- "recommendation": "[Specific proposal for most appropriate solution direction]"
278
- }
247
+ {"status":"escalation_needed","reason":"Design Doc deviation","taskName":"[Task name being executed]","details":{"design_doc_expectation":"[Exact quote from relevant Design Doc section]","actual_situation":"[Details of situation actually encountered]","why_cannot_implement":"[Technical reason why cannot implement per Design Doc]","attempted_approaches":["List of solution methods considered for trial"]},"escalation_type":"design_compliance_violation","user_decision_required":true,"suggested_options":["Modify Design Doc to match reality","Implement missing components first","Reconsider requirements and change implementation approach"],"recommendation":"[Specific proposal for most appropriate solution direction]"}
279
248
  ```
280
249
 
281
250
  #### 2-2. Similar Function Discovery Escalation
282
251
  When discovering similar functions during existing code investigation, escalate in following JSON format:
283
252
 
284
253
  ```json
285
- {
286
- "status": "escalation_needed",
287
- "reason": "Similar function discovered",
288
- "taskName": "[Task name being executed]",
289
- "similar_functions": [
290
- {
291
- "file_path": "[path to existing implementation]",
292
- "function_name": "existingFunction",
293
- "similarity_reason": "Same domain, same responsibility",
294
- "code_snippet": "[Excerpt of relevant code]",
295
- "technical_debt_assessment": "high/medium/low/unknown"
296
- }
297
- ],
298
- "search_details": {
299
- "keywords_used": ["domain keywords", "responsibility keywords"],
300
- "files_searched": 15,
301
- "matches_found": 3
302
- },
303
- "escalation_type": "similar_function_found",
304
- "user_decision_required": true,
305
- "suggested_options": [
306
- "Extend and use existing function",
307
- "Refactor existing function then use",
308
- "New implementation as technical debt (create ADR)",
309
- "New implementation (clarify differentiation from existing)"
310
- ],
311
- "recommendation": "[Recommended approach based on existing code analysis]"
312
- }
254
+ {"status":"escalation_needed","reason":"Similar function discovered","taskName":"[Task name being executed]","similar_functions":[{"file_path":"[path to existing implementation]","function_name":"existingFunction","similarity_reason":"Same domain, same responsibility","code_snippet":"[Excerpt of relevant code]","technical_debt_assessment":"high/medium/low/unknown"}],"search_details":{"keywords_used":["domain keywords","responsibility keywords"],"files_searched":15,"matches_found":3},"escalation_type":"similar_function_found","user_decision_required":true,"suggested_options":["Extend and use existing function","Refactor existing function then use","New implementation as technical debt (create ADR)","New implementation (clarify differentiation from existing)"],"recommendation":"[Recommended approach based on existing code analysis]"}
313
255
  ```
314
256
 
315
257
  #### 2-3. Investigation Target Not Found Escalation
316
258
  When an Investigation Target file does not exist or the path is stale, escalate in following JSON format:
317
259
 
318
260
  ```json
319
- {
320
- "status": "escalation_needed",
321
- "reason": "Investigation target not found",
322
- "taskName": "[Task name being executed]",
323
- "escalation_type": "investigation_target_not_found",
324
- "missingTargets": [
325
- {
326
- "path": "[path specified in task file]",
327
- "searchHint": "[section/function hint if provided, or null]",
328
- "searchAttempts": ["Checked path directly", "Searched nearby files with similar names", "Reviewed task dependencies for renamed or moved files"]
329
- }
330
- ],
331
- "user_decision_required": true,
332
- "suggested_options": [
333
- "Provide the correct file path",
334
- "Remove this Investigation Target and proceed",
335
- "Update the task file with current paths"
336
- ],
337
- "recommendation": "[Recommended next step based on what was found]"
338
- }
261
+ {"status":"escalation_needed","reason":"Investigation target not found","taskName":"[Task name being executed]","escalation_type":"investigation_target_not_found","missingTargets":[{"path":"[path specified in task file]","searchHint":"[section/function hint if provided, or null]","searchAttempts":["Checked path directly","Searched nearby files with similar names","Reviewed task dependencies for renamed or moved files"]}],"user_decision_required":true,"suggested_options":["Provide the correct file path","Remove this Investigation Target and proceed","Update the task file with current paths"],"recommendation":"[Recommended next step based on what was found]"}
339
262
  ```
340
263
 
341
264
  #### 2-4. Dependency Version Uncertain Escalation
342
265
  When repository-wide verification is insufficient to determine the appropriate dependency version, escalate in following JSON format:
343
266
 
344
267
  ```json
345
- {
346
- "status": "escalation_needed",
347
- "reason": "Dependency version uncertain",
348
- "taskName": "[Task name being executed]",
349
- "escalation_type": "dependency_version_uncertain",
350
- "dependency": {
351
- "name": "[dependency name]",
352
- "versionsFound": ["list of versions found in repository"],
353
- "filesChecked": ["file paths where the dependency usage was found"],
354
- "ambiguityReason": "[why repository state alone is insufficient]"
355
- },
356
- "user_decision_required": true,
357
- "suggested_options": [
358
- "Use the majority version already in the repository",
359
- "Use a different version with explicit rationale",
360
- "Research the latest stable version and decide after review"
361
- ]
362
- }
268
+ {"status":"escalation_needed","reason":"Dependency version uncertain","taskName":"[Task name being executed]","escalation_type":"dependency_version_uncertain","dependency":{"name":"[dependency name]","versionsFound":["list of versions found in repository"],"filesChecked":["file paths where the dependency usage was found"],"ambiguityReason":"[why repository state alone is insufficient]"},"user_decision_required":true,"suggested_options":["Use the majority version already in the repository","Use a different version with explicit rationale","Research the latest stable version and decide after review"]}
363
269
  ```
364
270
 
365
271
  #### 2-5. Binding Decision Violation Escalation
366
272
  When one or more Compliance Checks in the task's Binding Decisions section evaluate to `N` during pre-implementation, or to `N` or `Unknown` during completion, escalate in following JSON format:
367
273
 
368
274
  ```json
369
- {
370
- "status": "escalation_needed",
371
- "reason": "Binding decision violation",
372
- "taskName": "[Task name being executed]",
373
- "escalation_type": "binding_decision_violation",
374
- "phase": "pre_implementation | completion_gate",
375
- "implementationApproach": "[1-2 sentence summary of the planned or final implementation approach]",
376
- "failures": [
377
- {
378
- "source": "[ADR file path with section hint, copied from Source column]",
379
- "axis": "[Axis value copied from the Axis column]",
380
- "decision": "[Decision text copied from Decision column]",
381
- "complianceCheck": "[Compliance Check predicate copied from Compliance Check column]",
382
- "evaluation": "N | Unknown",
383
- "rationale": "[One line explaining why the implementation does not satisfy the check, or why it cannot be evaluated]"
384
- }
385
- ],
386
- "user_decision_required": true,
387
- "suggested_options": [
388
- "Adjust the implementation plan to satisfy the binding decision",
389
- "Update the ADR, then update the work plan ADR Bindings and task Binding Decisions",
390
- "Provide additional context that resolves the Unknown evaluation"
391
- ]
392
- }
275
+ {"status":"escalation_needed","reason":"Binding decision violation","taskName":"[Task name being executed]","escalation_type":"binding_decision_violation","phase":"pre_implementation | completion_gate","implementationApproach":"[1-2 sentence summary of the planned or final implementation approach]","failures":[{"source":"[ADR file path with section hint, copied from Source column]","axis":"[Axis value copied from the Axis column]","decision":"[Decision text copied from Decision column]","complianceCheck":"[Compliance Check predicate copied from Compliance Check column]","evaluation":"N | Unknown","rationale":"[One line explaining why the implementation does not satisfy the check, or why it cannot be evaluated]"}],"user_decision_required":true,"suggested_options":["Adjust the implementation plan to satisfy the binding decision","Update the ADR, then update the work plan ADR Bindings and task Binding Decisions","Provide additional context that resolves the Unknown evaluation"]}
393
276
  ```
394
277
 
395
278
  #### 2-6. Test Environment Not Ready Escalation
@@ -397,16 +280,7 @@ When one or more Compliance Checks in the task's Binding Decisions section evalu
397
280
  Triggered when the Test Environment Check finds the project-configured test toolchain unavailable or unrunnable.
398
281
 
399
282
  ```json
400
- {
401
- "status": "escalation_needed",
402
- "reason": "Test environment not ready",
403
- "taskName": "[Task name]",
404
- "escalation_type": "test_environment_not_ready",
405
- "missingComponent": "test runner | fixtures | mock server | setup file | other",
406
- "description": "[why the missing component blocks tests]",
407
- "user_decision_required": true,
408
- "suggested_options": ["Install or configure the missing component, then re-run the task", "Reassign the task once the environment is ready"]
409
- }
283
+ {"status":"escalation_needed","reason":"Test environment not ready","taskName":"[Task name]","escalation_type":"test_environment_not_ready","missingComponent":"test runner | fixtures | mock server | setup file | other","description":"[why the missing component blocks tests]","user_decision_required":true,"suggested_options":["Install or configure the missing component, then re-run the task","Reassign the task once the environment is ready"]}
410
284
  ```
411
285
 
412
286
  ## Execution Principles
@@ -126,163 +126,7 @@ Produce `candidateWriteSet[]` with likely modified files:
126
126
  Return a single JSON object as the final response:
127
127
 
128
128
  ```json
129
- {
130
- "analysisScope": {
131
- "filesAnalyzed": ["path/to/component.tsx"],
132
- "stylesAnalyzed": ["path/to/styles.module.css"],
133
- "uiConventions": {
134
- "componentExtension": ".tsx",
135
- "styleStrategy": "css-modules|vanilla-css|css-in-js|utility-classes|unknown",
136
- "storybook": true,
137
- "testRunner": "vitest|jest|other|unknown"
138
- }
139
- },
140
- "externalResources": {
141
- "status": "resolved|partial|not_recorded",
142
- "designOrigin": {
143
- "resource_status": "present|existing-implementation|not_applicable",
144
- "resolution_status": "fetched|inspected_local|recorded_for_manual_confirmation|unavailable|not_applicable",
145
- "accessMethod": "MCP name | URL | file path | existing implementation",
146
- "summary": "brief description of resolved content"
147
- },
148
- "designSystem": {
149
- "resource_status": "present|existing-package|not_applicable",
150
- "resolution_status": "fetched|inspected_local|unavailable|not_applicable",
151
- "accessMethod": "MCP name | URL | file path | package imports | local docs",
152
- "summary": "components, tokens, and variants captured"
153
- },
154
- "guidelines": {
155
- "resource_status": "present|project-conventions|not_applicable",
156
- "resolution_status": "fetched|inspected_local|unavailable|not_applicable",
157
- "accessMethod": "URL | file path | local docs | project conventions",
158
- "summary": "rule categories captured"
159
- },
160
- "visualVerification": {
161
- "resource_status": "present|manual-confirmation|not_applicable",
162
- "resolution_status": "available|recorded_for_manual_confirmation|unavailable|not_applicable",
163
- "accessMethod": "MCP name | URL | command | manual confirmation",
164
- "notes": "rendering verification path"
165
- },
166
- "generatedUiArtifacts": {
167
- "resource_status": "present|not_applicable",
168
- "resolution_status": "inspected_local|available|unavailable|not_applicable",
169
- "accessMethod": "command | config path | file path | package script",
170
- "summary": "generated UI artifact source, trigger, and verification path"
171
- },
172
- "additionalResources": [
173
- {
174
- "label": "resource-label",
175
- "description": "resource description",
176
- "accessMethod": "URL | MCP name | file path | command | notes",
177
- "resource_status": "present|existing-implementation|existing-package|project-conventions|manual-confirmation",
178
- "resolution_status": "fetched|inspected_local|recorded_for_manual_confirmation|unavailable",
179
- "summary": "facts relevant to the requested UI scope"
180
- }
181
- ]
182
- },
183
- "componentStructure": [
184
- {
185
- "name": "ComponentName",
186
- "filePath": "path/to/file:line",
187
- "propsInterface": "name and brief shape",
188
- "topLevelElement": "tag or component name",
189
- "domOrder": ["child1", "child2"],
190
- "conditionalBranches": [
191
- {"predicate": "condition", "renderedSubtree": "brief description"}
192
- ],
193
- "callSites": ["path/to/consumer:line"]
194
- }
195
- ],
196
- "propsPatterns": [
197
- {
198
- "component": "ComponentName",
199
- "callSite": "path/to/file:line",
200
- "props": {"variant": "primary"},
201
- "computedProps": ["onClick"],
202
- "groupKey": "primary"
203
- }
204
- ],
205
- "cssLayout": [
206
- {
207
- "filePath": "path/to/styles.module.css",
208
- "classNamingConvention": "camelCase|kebab-case|BEM|unknown",
209
- "baseClass": "root",
210
- "layouts": [
211
- {
212
- "selector": ".root",
213
- "display": "flex|grid|block|unknown",
214
- "direction": "row|column|grid-template|unknown",
215
- "gap": "8px|none|unknown",
216
- "wrap": "wrap|nowrap|absent|unknown",
217
- "logicalProperties": true,
218
- "stateSelectors": ["[data-state=active]"]
219
- }
220
- ],
221
- "responsiveBreakpoints": ["768px"]
222
- }
223
- ],
224
- "stateDisplay": [
225
- {
226
- "component": "ComponentName",
227
- "states": [
228
- {"name": "loading|empty|partial|error|ready|disabled", "trigger": "what causes this state", "renders": "brief description"}
229
- ],
230
- "unsupportedStates": ["state absent from current component"]
231
- }
232
- ],
233
- "displayConditions": [
234
- {
235
- "component": "ComponentName",
236
- "condition": "feature_flag|role|route|region|tenant|page_context",
237
- "predicateLocation": "path/to/file:line",
238
- "predicate": "expression",
239
- "gatedSubtree": "brief description"
240
- }
241
- ],
242
- "i18n": {
243
- "format": "csv|json|code-catalog|other|none",
244
- "structuralConventions": {},
245
- "keyNamingConvention": "",
246
- "locales": [],
247
- "localeGaps": [],
248
- "generatedTypings": {"command": "", "outputPath": ""}
249
- },
250
- "accessibility": [
251
- {
252
- "component": "ComponentName",
253
- "ariaAttributes": ["role=button", "aria-label from prop"],
254
- "keyboardHandling": "Enter and Space trigger action",
255
- "focusStyling": "focus-visible outline",
256
- "testCoverage": "axe checks present|absent|unknown"
257
- }
258
- ],
259
- "generatedArtifacts": [
260
- {
261
- "kind": "css-module-typings|message-catalog-typings|route-typings|other",
262
- "command": "generator command",
263
- "trigger": "on source change|manual|unknown",
264
- "consumers": ["typecheck", "test", "build", "runtime"],
265
- "resourceRef": "externalResources.generatedUiArtifacts"
266
- }
267
- ],
268
- "focusAreas": [
269
- {
270
- "fact_id": "path:identifier",
271
- "area": "Brief UI area name",
272
- "evidence": "componentStructure[name=...]",
273
- "factsToAddress": "Concrete UI facts to respect",
274
- "risk": "What inconsistency results if omitted"
275
- }
276
- ],
277
- "candidateWriteSet": [
278
- {
279
- "path": "src/components/Card.tsx",
280
- "reasonRef": "focusAreas[fact_id=...]",
281
- "confidence": "high|medium|low"
282
- }
283
- ],
284
- "limitations": []
285
- }
129
+ {"analysisScope":{"filesAnalyzed":["path/to/component.tsx"],"stylesAnalyzed":["path/to/styles.module.css"],"uiConventions":{"componentExtension":".tsx","styleStrategy":"css-modules|vanilla-css|css-in-js|utility-classes|unknown","storybook":true,"testRunner":"vitest|jest|other|unknown"}},"externalResources":{"status":"resolved|partial|not_recorded","designOrigin":{"resource_status":"present|existing-implementation|not_applicable","resolution_status":"fetched|inspected_local|recorded_for_manual_confirmation|unavailable|not_applicable","accessMethod":"MCP name | URL | file path | existing implementation","summary":"brief description of resolved content"},"designSystem":{"resource_status":"present|existing-package|not_applicable","resolution_status":"fetched|inspected_local|unavailable|not_applicable","accessMethod":"MCP name | URL | file path | package imports | local docs","summary":"components, tokens, and variants captured"},"guidelines":{"resource_status":"present|project-conventions|not_applicable","resolution_status":"fetched|inspected_local|unavailable|not_applicable","accessMethod":"URL | file path | local docs | project conventions","summary":"rule categories captured"},"visualVerification":{"resource_status":"present|manual-confirmation|not_applicable","resolution_status":"available|recorded_for_manual_confirmation|unavailable|not_applicable","accessMethod":"MCP name | URL | command | manual confirmation","notes":"rendering verification path"},"generatedUiArtifacts":{"resource_status":"present|not_applicable","resolution_status":"inspected_local|available|unavailable|not_applicable","accessMethod":"command | config path | file path | package script","summary":"generated UI artifact source, trigger, and verification path"},"additionalResources":[{"label":"resource-label","description":"resource description","accessMethod":"URL | MCP name | file path | command | notes","resource_status":"present|existing-implementation|existing-package|project-conventions|manual-confirmation","resolution_status":"fetched|inspected_local|recorded_for_manual_confirmation|unavailable","summary":"facts relevant to the requested UI scope"}]},"componentStructure":[{"name":"ComponentName","filePath":"path/to/file:line","propsInterface":"name and brief shape","topLevelElement":"tag or component name","domOrder":["child1","child2"],"conditionalBranches":[{"predicate":"condition","renderedSubtree":"brief description"}],"callSites":["path/to/consumer:line"]}],"propsPatterns":[{"component":"ComponentName","callSite":"path/to/file:line","props":{"variant":"primary"},"computedProps":["onClick"],"groupKey":"primary"}],"cssLayout":[{"filePath":"path/to/styles.module.css","classNamingConvention":"camelCase|kebab-case|BEM|unknown","baseClass":"root","layouts":[{"selector":".root","display":"flex|grid|block|unknown","direction":"row|column|grid-template|unknown","gap":"8px|none|unknown","wrap":"wrap|nowrap|absent|unknown","logicalProperties":true,"stateSelectors":["[data-state=active]"]}],"responsiveBreakpoints":["768px"]}],"stateDisplay":[{"component":"ComponentName","states":[{"name":"loading|empty|partial|error|ready|disabled","trigger":"what causes this state","renders":"brief description"}],"unsupportedStates":["state absent from current component"]}],"displayConditions":[{"component":"ComponentName","condition":"feature_flag|role|route|region|tenant|page_context","predicateLocation":"path/to/file:line","predicate":"expression","gatedSubtree":"brief description"}],"i18n":{"format":"csv|json|code-catalog|other|none","structuralConventions":{},"keyNamingConvention":"","locales":[],"localeGaps":[],"generatedTypings":{"command":"","outputPath":""}},"accessibility":[{"component":"ComponentName","ariaAttributes":["role=button","aria-label from prop"],"keyboardHandling":"Enter and Space trigger action","focusStyling":"focus-visible outline","testCoverage":"axe checks present|absent|unknown"}],"generatedArtifacts":[{"kind":"css-module-typings|message-catalog-typings|route-typings|other","command":"generator command","trigger":"on source change|manual|unknown","consumers":["typecheck","test","build","runtime"],"resourceRef":"externalResources.generatedUiArtifacts"}],"focusAreas":[{"fact_id":"path:identifier","area":"Brief UI area name","evidence":"componentStructure[name=...]","factsToAddress":"Concrete UI facts to respect","risk":"What inconsistency results if omitted"}],"candidateWriteSet":[{"path":"src/components/Card.tsx","reasonRef":"focusAreas[fact_id=...]","confidence":"high|medium|low"}],"limitations":[]}
286
130
  ```
287
131
 
288
132
  ## Quality Checklist
@@ -80,6 +80,7 @@ Record each supplementary finding and its impact on the existing failure points
80
80
  - Check whether the mapped execution path adequately covers the observed symptom from entry to failure
81
81
  - Identify uncovered boundaries or unverified nodes that could hide additional failure points
82
82
  - Evaluate at least 2 additional path segments or boundaries beyond the investigator's original failure-point list
83
+ - When the investigated incident is a bug or regression, or when a failure point affects a state transition, persisted state, or external boundary, trace adjacent cases sharing the same path, contract, persisted state, or external boundary and evaluate whether they carry the same class of defect
83
84
  - Evaluate each failure point independently:
84
85
  - Is the supporting evidence sufficient?
85
86
  - Is there direct counter-evidence?
@@ -125,71 +126,7 @@ Return the JSON result as the final response. See Output Format for the schema.
125
126
  **JSON format is mandatory.**
126
127
 
127
128
  ```json
128
- {
129
- "investigationReview": {
130
- "originalFailurePointCount": 3,
131
- "coverageAssessment": "sufficient|partial|insufficient",
132
- "identifiedGaps": ["Perspectives overlooked in investigation"]
133
- },
134
- "triangulationSupplements": [
135
- {
136
- "source": "Additional information source investigated",
137
- "findings": "Content discovered",
138
- "impactOnFailurePoints": "Impact on existing failure points"
139
- }
140
- ],
141
- "scopeValidation": {
142
- "verified": true,
143
- "concerns": ["Concerns"]
144
- },
145
- "externalResearch": [
146
- {
147
- "query": "Search query used",
148
- "source": "Information source",
149
- "findings": "Related information discovered",
150
- "impactOnFailurePoints": "Impact on failure points"
151
- }
152
- ],
153
- "additionalFailurePoints": [
154
- {
155
- "id": "AFP1",
156
- "description": "Additional failure point description",
157
- "rationale": "Why this failure point was considered",
158
- "evidence": {"supporting": [], "contradicting": []},
159
- "plausibility": "high|medium|low"
160
- }
161
- ],
162
- "pathCoverageFindings": [
163
- {
164
- "nodeId": "N1",
165
- "status": "covered|partially_covered|uncovered",
166
- "findings": "Coverage finding",
167
- "followUpNeeded": ["Needed follow-up"]
168
- }
169
- ],
170
- "failurePointsEvaluation": [
171
- {
172
- "failurePointId": "FP1 or AFP1",
173
- "description": "Failure point description",
174
- "verificationLevel": "speculation|indirect|direct|verified",
175
- "refutationStatus": "unrefuted|partially_refuted|refuted",
176
- "remainingUncertainty": ["Remaining uncertainty"]
177
- }
178
- ],
179
- "conclusion": {
180
- "confirmedFailurePoints": [
181
- {"failurePointId": "FP1", "status": "confirmed|probable|possible", "originalCheckStatus": "retained|added_by_verifier|null"}
182
- ],
183
- "failurePointRelationships": [
184
- {"from": "FP1", "to": "FP2", "relationship": "independent|upstream_of|downstream_of|amplifies|same_boundary"}
185
- ],
186
- "finalStatus": "ready_for_solution|needs_more_investigation",
187
- "coverageAssessment": "sufficient|partial|insufficient",
188
- "statusRationale": "Rationale for status and coverage level",
189
- "recommendedVerification": ["Additional verification needed to confirm conclusion"]
190
- },
191
- "verificationLimitations": ["Limitations of this verification process"]
192
- }
129
+ {"investigationReview":{"originalFailurePointCount":3,"coverageAssessment":"sufficient|partial|insufficient","identifiedGaps":["Perspectives overlooked in investigation"]},"triangulationSupplements":[{"source":"Additional information source investigated","findings":"Content discovered","impactOnFailurePoints":"Impact on existing failure points"}],"scopeValidation":{"verified":true,"concerns":["Concerns"]},"externalResearch":[{"query":"Search query used","source":"Information source","findings":"Related information discovered","impactOnFailurePoints":"Impact on failure points"}],"additionalFailurePoints":[{"id":"AFP1","description":"Additional failure point description","rationale":"Why this failure point was considered","evidence":{"supporting":[],"contradicting":[]},"plausibility":"high|medium|low"}],"pathCoverageFindings":[{"nodeId":"N1","status":"covered|partially_covered|uncovered","findings":"Coverage finding","followUpNeeded":["Needed follow-up"]}],"failurePointsEvaluation":[{"failurePointId":"FP1 or AFP1","description":"Failure point description","verificationLevel":"speculation|indirect|direct|verified","refutationStatus":"unrefuted|partially_refuted|refuted","remainingUncertainty":["Remaining uncertainty"]}],"conclusion":{"confirmedFailurePoints":[{"failurePointId":"FP1","status":"confirmed|probable|possible","originalCheckStatus":"retained|added_by_verifier|null"}],"failurePointRelationships":[{"from":"FP1","to":"FP2","relationship":"independent|upstream_of|downstream_of|amplifies|same_boundary"}],"finalStatus":"ready_for_solution|needs_more_investigation","coverageAssessment":"sufficient|partial|insufficient","statusRationale":"Rationale for status and coverage level","recommendedVerification":["Additional verification needed to confirm conclusion"]},"verificationLimitations":["Limitations of this verification process"]}
193
130
  ```
194
131
 
195
132
  ## Completion Criteria
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codex-workflows",
3
- "version": "0.6.8",
3
+ "version": "0.6.9",
4
4
  "description": "Task-oriented agentic coding framework for OpenAI Codex CLI — skills, recipes, and subagents for structured development workflows",
5
5
  "license": "MIT",
6
6
  "author": "Shinsuke Kagawa",