@mrciphersmith/keryx 0.2.69 → 0.2.71

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 (183) hide show
  1. package/dist/cli.js +11136 -4863
  2. package/docs/README.md +54 -0
  3. package/docs/requirements/shared-agent-context/README.md +104 -0
  4. package/package.json +3 -2
  5. package/src/gdgraph/build-lang.test.ts +10 -3
  6. package/src/gdgraph/build.ts +54 -9
  7. package/src/gdgraph/import-kind.test.ts +205 -0
  8. package/src/gdgraph/query.ts +6 -1
  9. package/src/gdgraph/types.ts +34 -0
  10. package/src/gdskills/bundled/rules/core/model-selection.mdc +184 -31
  11. package/src/gdskills/bundled/rules/core/skills-storage-workflow.mdc +36 -0
  12. package/src/gdskills/bundled/rules/core/subagent-status-protocol.md +27 -1
  13. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.codex.md +1 -1
  14. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.cursor.md +1 -1
  15. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.md +2 -1
  16. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.opencode.md +1 -1
  17. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.zed.md +1 -1
  18. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.codex.md +1 -1
  19. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.cursor.md +1 -1
  20. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.md +1 -1
  21. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.opencode.md +1 -1
  22. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.zed.md +1 -1
  23. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.codex.md +1 -1
  24. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.cursor.md +1 -1
  25. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.md +1 -1
  26. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.opencode.md +1 -1
  27. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.zed.md +1 -1
  28. package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.codex.md +1 -1
  29. package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.cursor.md +1 -1
  30. package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.md +1 -1
  31. package/src/gdskills/bundled/skills/orchestration/flow-orchestrator/SKILL.md +159 -20
  32. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.codex.md +1 -1
  33. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.cursor.md +1 -1
  34. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.md +1 -1
  35. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.opencode.md +1 -1
  36. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.zed.md +1 -1
  37. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.codex.md +1 -1
  38. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.cursor.md +1 -1
  39. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.md +2 -1
  40. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.opencode.md +1 -1
  41. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.zed.md +1 -1
  42. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.codex.md +28 -3
  43. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.cursor.md +28 -3
  44. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.md +28 -3
  45. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.opencode.md +28 -3
  46. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.zed.md +28 -3
  47. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.codex.md +20 -2
  48. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.cursor.md +20 -2
  49. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.md +22 -3
  50. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.opencode.md +20 -2
  51. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.zed.md +20 -2
  52. package/src/gdskills/bundled/skills/planning/autodoc-analyst/SKILL.md +2 -1
  53. package/src/gdskills/bundled/skills/planning/autodoc-architect/SKILL.md +3 -1
  54. package/src/gdskills/bundled/skills/planning/autodoc-assembler/SKILL.md +2 -1
  55. package/src/gdskills/bundled/skills/planning/autodoc-orchestrator/SKILL.md +2 -1
  56. package/src/gdskills/bundled/skills/planning/autodoc-scanner/SKILL.md +2 -1
  57. package/src/gdskills/bundled/skills/planning/autodoc-writer/SKILL.md +2 -1
  58. package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.codex.md +1 -1
  59. package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.cursor.md +1 -1
  60. package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.md +1 -1
  61. package/src/gdskills/bundled/skills/planning/consistency-checker/SKILL.codex.md +1 -1
  62. package/src/gdskills/bundled/skills/planning/consistency-checker/SKILL.cursor.md +1 -1
  63. package/src/gdskills/bundled/skills/planning/consistency-checker/SKILL.md +2 -1
  64. package/src/gdskills/bundled/skills/planning/docpack-orchestrator/SKILL.md +1 -1
  65. package/src/gdskills/bundled/skills/planning/docpack-review/SKILL.md +1 -1
  66. package/src/gdskills/bundled/skills/planning/interview/SKILL.codex.md +1 -1
  67. package/src/gdskills/bundled/skills/planning/interview/SKILL.cursor.md +1 -1
  68. package/src/gdskills/bundled/skills/planning/interview/SKILL.md +1 -1
  69. package/src/gdskills/bundled/skills/planning/interviewer/SKILL.codex.md +1 -1
  70. package/src/gdskills/bundled/skills/planning/interviewer/SKILL.cursor.md +1 -1
  71. package/src/gdskills/bundled/skills/planning/interviewer/SKILL.md +1 -1
  72. package/src/gdskills/bundled/skills/planning/patterns-researcher/SKILL.codex.md +1 -1
  73. package/src/gdskills/bundled/skills/planning/patterns-researcher/SKILL.cursor.md +1 -1
  74. package/src/gdskills/bundled/skills/planning/patterns-researcher/SKILL.md +2 -1
  75. package/src/gdskills/bundled/skills/planning/planner/SKILL.codex.md +1 -1
  76. package/src/gdskills/bundled/skills/planning/planner/SKILL.cursor.md +1 -1
  77. package/src/gdskills/bundled/skills/planning/planner/SKILL.md +2 -1
  78. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.codex.md +1 -1
  79. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.cursor.md +1 -1
  80. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.md +1 -1
  81. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.opencode.md +1 -1
  82. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.zed.md +1 -1
  83. package/src/gdskills/bundled/skills/planning/problem-definer/SKILL.codex.md +1 -1
  84. package/src/gdskills/bundled/skills/planning/problem-definer/SKILL.cursor.md +1 -1
  85. package/src/gdskills/bundled/skills/planning/problem-definer/SKILL.md +2 -1
  86. package/src/gdskills/bundled/skills/planning/project-discovery/SKILL.codex.md +1 -1
  87. package/src/gdskills/bundled/skills/planning/project-discovery/SKILL.cursor.md +1 -1
  88. package/src/gdskills/bundled/skills/planning/project-discovery/SKILL.md +2 -1
  89. package/src/gdskills/bundled/skills/planning/spec-writer/SKILL.codex.md +1 -1
  90. package/src/gdskills/bundled/skills/planning/spec-writer/SKILL.cursor.md +1 -1
  91. package/src/gdskills/bundled/skills/planning/spec-writer/SKILL.md +2 -1
  92. package/src/gdskills/bundled/skills/planning/stack-advisor/SKILL.codex.md +1 -1
  93. package/src/gdskills/bundled/skills/planning/stack-advisor/SKILL.cursor.md +1 -1
  94. package/src/gdskills/bundled/skills/planning/stack-advisor/SKILL.md +2 -1
  95. package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.codex.md +1 -1
  96. package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.cursor.md +1 -1
  97. package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.md +1 -1
  98. package/src/gdskills/bundled/skills/platform/hookify/SKILL.codex.md +1 -1
  99. package/src/gdskills/bundled/skills/platform/hookify/SKILL.cursor.md +1 -1
  100. package/src/gdskills/bundled/skills/platform/hookify/SKILL.md +1 -1
  101. package/src/gdskills/bundled/skills/quality/changelog/SKILL.codex.md +1 -1
  102. package/src/gdskills/bundled/skills/quality/changelog/SKILL.cursor.md +1 -1
  103. package/src/gdskills/bundled/skills/quality/changelog/SKILL.md +1 -1
  104. package/src/gdskills/bundled/skills/quality/commit/SKILL.codex.md +1 -1
  105. package/src/gdskills/bundled/skills/quality/commit/SKILL.cursor.md +1 -1
  106. package/src/gdskills/bundled/skills/quality/commit/SKILL.md +1 -1
  107. package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.codex.md +1 -1
  108. package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.cursor.md +1 -1
  109. package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.md +1 -1
  110. package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.codex.md +1 -1
  111. package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.cursor.md +1 -1
  112. package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.md +1 -1
  113. package/src/gdskills/bundled/skills/quality/deploy/SKILL.codex.md +1 -1
  114. package/src/gdskills/bundled/skills/quality/deploy/SKILL.cursor.md +1 -1
  115. package/src/gdskills/bundled/skills/quality/deploy/SKILL.md +1 -1
  116. package/src/gdskills/bundled/skills/quality/metaproject-security/SKILL.md +1 -1
  117. package/src/gdskills/bundled/skills/quality/perf-check/SKILL.codex.md +1 -1
  118. package/src/gdskills/bundled/skills/quality/perf-check/SKILL.cursor.md +1 -1
  119. package/src/gdskills/bundled/skills/quality/perf-check/SKILL.md +1 -1
  120. package/src/gdskills/bundled/skills/quality/pr/SKILL.codex.md +1 -1
  121. package/src/gdskills/bundled/skills/quality/pr/SKILL.cursor.md +1 -1
  122. package/src/gdskills/bundled/skills/quality/pr/SKILL.md +1 -1
  123. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.codex.md +1 -1
  124. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.cursor.md +1 -1
  125. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.md +1 -1
  126. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.opencode.md +1 -1
  127. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.zed.md +1 -1
  128. package/src/gdskills/bundled/skills/quality/push/SKILL.codex.md +1 -1
  129. package/src/gdskills/bundled/skills/quality/push/SKILL.cursor.md +1 -1
  130. package/src/gdskills/bundled/skills/quality/push/SKILL.md +1 -1
  131. package/src/gdskills/bundled/skills/quality/security-audit/SKILL.codex.md +1 -1
  132. package/src/gdskills/bundled/skills/quality/security-audit/SKILL.cursor.md +1 -1
  133. package/src/gdskills/bundled/skills/quality/security-audit/SKILL.md +1 -1
  134. package/src/gdskills/bundled/skills/quality/test-gen/SKILL.codex.md +1 -1
  135. package/src/gdskills/bundled/skills/quality/test-gen/SKILL.cursor.md +1 -1
  136. package/src/gdskills/bundled/skills/quality/test-gen/SKILL.md +1 -1
  137. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.codex.md +1 -1
  138. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.cursor.md +1 -1
  139. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.md +1 -1
  140. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.opencode.md +1 -1
  141. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.zed.md +1 -1
  142. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.codex.md +1 -1
  143. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.cursor.md +1 -1
  144. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.md +1 -1
  145. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.opencode.md +1 -1
  146. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.zed.md +1 -1
  147. package/src/gdskills/bundled/skills/review/code-b091-review/SKILL.codex.md +1 -1
  148. package/src/gdskills/bundled/skills/review/code-b091-review/SKILL.cursor.md +1 -1
  149. package/src/gdskills/bundled/skills/review/code-b091-review/SKILL.md +1 -1
  150. package/src/gdskills/bundled/skills/review/code-b091-review/SKILL.opencode.md +1 -1
  151. package/src/gdskills/bundled/skills/review/code-b091-review/SKILL.zed.md +1 -1
  152. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.codex.md +1 -1
  153. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.cursor.md +1 -1
  154. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.md +2 -1
  155. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.opencode.md +1 -1
  156. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.zed.md +1 -1
  157. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.codex.md +1 -1
  158. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.cursor.md +1 -1
  159. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.md +1 -1
  160. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.opencode.md +1 -1
  161. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.zed.md +1 -1
  162. package/src/gdskills/bundled/skills/review/review-architecture/SKILL.md +37 -10
  163. package/src/gdskills/bundled/skills/review/review-backend/SKILL.md +48 -14
  164. package/src/gdskills/bundled/skills/review/review-clean-code/SKILL.md +49 -12
  165. package/src/gdskills/bundled/skills/review/review-core-boundaries/SKILL.md +34 -2
  166. package/src/gdskills/bundled/skills/review/review-flow-graph/SKILL.md +33 -2
  167. package/src/gdskills/bundled/skills/review/review-frontend/SKILL.md +70 -29
  168. package/src/gdskills/bundled/skills/review/review-frontend-conventions/SKILL.md +34 -3
  169. package/src/gdskills/bundled/skills/review/review-highload/SKILL.md +49 -15
  170. package/src/gdskills/bundled/skills/review/review-logic/SKILL.md +39 -11
  171. package/src/gdskills/bundled/skills/review/review-orchestrator/SKILL.md +659 -64
  172. package/src/gdskills/bundled/skills/review/review-orchestrator/reviewer-finding.schema.json +7 -0
  173. package/src/gdskills/bundled/skills/review/review-orchestrator/verification-claim.schema.json +78 -0
  174. package/src/gdskills/bundled/skills/review/review-performance/SKILL.md +43 -13
  175. package/src/gdskills/bundled/skills/review/review-pr-feedback/SKILL.md +8 -2
  176. package/src/gdskills/bundled/skills/review/review-regression/SKILL.md +185 -0
  177. package/src/gdskills/bundled/skills/review/review-security-code/SKILL.md +44 -13
  178. package/src/gdskills/bundled/skills/review/review-style/SKILL.md +26 -6
  179. package/src/gdskills/bundled/skills/review/review-testing-practices/SKILL.md +35 -3
  180. package/src/gdskills/bundled/skills/review/review-verifier/SKILL.md +276 -0
  181. package/src/gdskills/contracts/review-finding.schema.json +119 -1
  182. package/src/gdskills/contracts/subagent-dispatch.schema.json +59 -3
  183. package/src/gdskills/bundled/skills/review/review-strict/SKILL.md +0 -328
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "implementation"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # Task Implementer
@@ -284,7 +284,25 @@ npm run build-storybook # Verify stories compile
284
284
  | Test failures | Fix failing tests, re-commit |
285
285
  | Story build failure | Fix story code, re-commit |
286
286
 
287
- Maximum 3 self-fix attempts per verification step.
287
+ Maximum 3 self-fix attempts per verification step.
288
+
289
+ Three, and it is the same three `job-orchestrator` and `flow-orchestrator`
290
+ use: one round bound, not four. *"The first three to four repair iterations
291
+ account for most achievable gains"*
292
+ ([arXiv:2607.05197](https://arxiv.org/abs/2607.05197)); correctness falls
293
+ **0.820 -> 0.673** across two forced revisions while cumulative ever-correct is
294
+ **0.847** ([arXiv:2607.24604](https://arxiv.org/abs/2607.24604)) — the agent
295
+ finds the fix and then destroys it. Aider hardcodes `max_reflections = 3`;
296
+ OpenHands' critic uses 3.
297
+
298
+ **Stop earlier on repetition, whatever the count says.** If an attempt produces
299
+ the same failure output as the previous attempt — the same failing test with the
300
+ same message, the same type error at the same site — do NOT spend the remaining
301
+ attempts. The counter cannot tell "converging slowly" from "stuck", and three
302
+ identical outputs cost the whole budget to learn what the second one already
303
+ said. Report the block instead, naming what repeated.
304
+
305
+
288
306
  **ROLLBACK POLICY**: If implementation fatally fails (e.g. tests still failing after 3 attempts or unresolvable compilation errors), you MUST run `git reset --hard` to clean the worktree before reporting the failure in Phase 6, unless explicitly instructed to leave it dirty.
289
307
 
290
308
  **5.5 Re-commit fixes if any:**
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "implementation"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # Task Implementer
@@ -284,7 +284,25 @@ npm run build-storybook # Verify stories compile
284
284
  | Test failures | Fix failing tests, re-commit |
285
285
  | Story build failure | Fix story code, re-commit |
286
286
 
287
- Maximum 3 self-fix attempts per verification step.
287
+ Maximum 3 self-fix attempts per verification step.
288
+
289
+ Three, and it is the same three `job-orchestrator` and `flow-orchestrator`
290
+ use: one round bound, not four. *"The first three to four repair iterations
291
+ account for most achievable gains"*
292
+ ([arXiv:2607.05197](https://arxiv.org/abs/2607.05197)); correctness falls
293
+ **0.820 -> 0.673** across two forced revisions while cumulative ever-correct is
294
+ **0.847** ([arXiv:2607.24604](https://arxiv.org/abs/2607.24604)) — the agent
295
+ finds the fix and then destroys it. Aider hardcodes `max_reflections = 3`;
296
+ OpenHands' critic uses 3.
297
+
298
+ **Stop earlier on repetition, whatever the count says.** If an attempt produces
299
+ the same failure output as the previous attempt — the same failing test with the
300
+ same message, the same type error at the same site — do NOT spend the remaining
301
+ attempts. The counter cannot tell "converging slowly" from "stuck", and three
302
+ identical outputs cost the whole budget to learn what the second one already
303
+ said. Report the block instead, naming what repeated.
304
+
305
+
288
306
  **ROLLBACK POLICY**: If implementation fatally fails (e.g. tests still failing after 3 attempts or unresolvable compilation errors), you MUST run `git reset --hard` to clean the worktree before reporting the failure in Phase 6, unless explicitly instructed to leave it dirty.
289
307
 
290
308
  **5.5 Re-commit fixes if any:**
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: task-implementer
3
+ model_tier: standard
3
4
  description: "Use when implementing a single decomposed task from issue-analyzer end-to-end, or executing autonomous code changes from a JSON task object."
4
5
  triggers:
5
6
  - "Implement task"
@@ -12,8 +13,8 @@ metadata:
12
13
  version: "1.2.0"
13
14
  category: "implementation"
14
15
  agent_worthy: true
16
+ compatible_harnesses: "cursor,codex,zed,opencode"
15
17
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode"
17
18
  ---
18
19
 
19
20
  # Task Implementer
@@ -333,7 +334,25 @@ npm run build-storybook # Verify stories compile
333
334
  | Test failures | Fix failing tests, re-commit |
334
335
  | Story build failure | Fix story code, re-commit |
335
336
 
336
- Maximum 3 self-fix attempts per verification step.
337
+ Maximum 3 self-fix attempts per verification step.
338
+
339
+ Three, and it is the same three `job-orchestrator` and `flow-orchestrator`
340
+ use: one round bound, not four. *"The first three to four repair iterations
341
+ account for most achievable gains"*
342
+ ([arXiv:2607.05197](https://arxiv.org/abs/2607.05197)); correctness falls
343
+ **0.820 -> 0.673** across two forced revisions while cumulative ever-correct is
344
+ **0.847** ([arXiv:2607.24604](https://arxiv.org/abs/2607.24604)) — the agent
345
+ finds the fix and then destroys it. Aider hardcodes `max_reflections = 3`;
346
+ OpenHands' critic uses 3.
347
+
348
+ **Stop earlier on repetition, whatever the count says.** If an attempt produces
349
+ the same failure output as the previous attempt — the same failing test with the
350
+ same message, the same type error at the same site — do NOT spend the remaining
351
+ attempts. The counter cannot tell "converging slowly" from "stuck", and three
352
+ identical outputs cost the whole budget to learn what the second one already
353
+ said. Report the block instead, naming what repeated.
354
+
355
+
337
356
  **ROLLBACK POLICY**: If implementation fatally fails (e.g. tests still failing after 3 attempts or unresolvable compilation errors), you MUST run `git reset --hard` to clean the worktree before reporting the failure in Phase 6, unless explicitly instructed to leave it dirty.
338
357
 
339
358
  **5.5 Re-commit fixes if any:**
@@ -531,7 +550,7 @@ Run task-1 (which creates pipeline.ts) before re-dispatching this task, or provi
531
550
  - (nothing — blocked before implementation could start)
532
551
  ```
533
552
 
534
- See `rules/core/subagent-status-protocol.md` for full format specification and all four status types.
553
+ See `rules/core/subagent-status-protocol.md` for the full format specification. Four statuses are yours as a skill worker; the fifth, `FAILED`, belongs to harness child workers and you must never emit it — report `BLOCKED` instead.
535
554
 
536
555
  ---
537
556
 
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "implementation"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # Task Implementer
@@ -284,7 +284,25 @@ npm run build-storybook # Verify stories compile
284
284
  | Test failures | Fix failing tests, re-commit |
285
285
  | Story build failure | Fix story code, re-commit |
286
286
 
287
- Maximum 3 self-fix attempts per verification step.
287
+ Maximum 3 self-fix attempts per verification step.
288
+
289
+ Three, and it is the same three `job-orchestrator` and `flow-orchestrator`
290
+ use: one round bound, not four. *"The first three to four repair iterations
291
+ account for most achievable gains"*
292
+ ([arXiv:2607.05197](https://arxiv.org/abs/2607.05197)); correctness falls
293
+ **0.820 -> 0.673** across two forced revisions while cumulative ever-correct is
294
+ **0.847** ([arXiv:2607.24604](https://arxiv.org/abs/2607.24604)) — the agent
295
+ finds the fix and then destroys it. Aider hardcodes `max_reflections = 3`;
296
+ OpenHands' critic uses 3.
297
+
298
+ **Stop earlier on repetition, whatever the count says.** If an attempt produces
299
+ the same failure output as the previous attempt — the same failing test with the
300
+ same message, the same type error at the same site — do NOT spend the remaining
301
+ attempts. The counter cannot tell "converging slowly" from "stuck", and three
302
+ identical outputs cost the whole budget to learn what the second one already
303
+ said. Report the block instead, naming what repeated.
304
+
305
+
288
306
  **ROLLBACK POLICY**: If implementation fatally fails (e.g. tests still failing after 3 attempts or unresolvable compilation errors), you MUST run `git reset --hard` to clean the worktree before reporting the failure in Phase 6, unless explicitly instructed to leave it dirty.
289
307
 
290
308
  **5.5 Re-commit fixes if any:**
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "implementation"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # Task Implementer
@@ -284,7 +284,25 @@ npm run build-storybook # Verify stories compile
284
284
  | Test failures | Fix failing tests, re-commit |
285
285
  | Story build failure | Fix story code, re-commit |
286
286
 
287
- Maximum 3 self-fix attempts per verification step.
287
+ Maximum 3 self-fix attempts per verification step.
288
+
289
+ Three, and it is the same three `job-orchestrator` and `flow-orchestrator`
290
+ use: one round bound, not four. *"The first three to four repair iterations
291
+ account for most achievable gains"*
292
+ ([arXiv:2607.05197](https://arxiv.org/abs/2607.05197)); correctness falls
293
+ **0.820 -> 0.673** across two forced revisions while cumulative ever-correct is
294
+ **0.847** ([arXiv:2607.24604](https://arxiv.org/abs/2607.24604)) — the agent
295
+ finds the fix and then destroys it. Aider hardcodes `max_reflections = 3`;
296
+ OpenHands' critic uses 3.
297
+
298
+ **Stop earlier on repetition, whatever the count says.** If an attempt produces
299
+ the same failure output as the previous attempt — the same failing test with the
300
+ same message, the same type error at the same site — do NOT spend the remaining
301
+ attempts. The counter cannot tell "converging slowly" from "stuck", and three
302
+ identical outputs cost the whole budget to learn what the second one already
303
+ said. Report the block instead, naming what repeated.
304
+
305
+
288
306
  **ROLLBACK POLICY**: If implementation fatally fails (e.g. tests still failing after 3 attempts or unresolvable compilation errors), you MUST run `git reset --hard` to clean the worktree before reporting the failure in Phase 6, unless explicitly instructed to leave it dirty.
289
307
 
290
308
  **5.5 Re-commit fixes if any:**
@@ -5,7 +5,8 @@ description: >
5
5
  to extract purpose, structure, public API surface, patterns, and key dependencies.
6
6
  Use when: dispatched by autodoc-orchestrator Phase 2 (one instance per module).
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # autodoc-analyst
@@ -1,12 +1,14 @@
1
1
  ---
2
2
  name: autodoc-architect
3
+ model_tier: deep
3
4
  description: >
4
5
  Phase 3 subagent for autodoc-orchestrator. Synthesizes all module analyses
5
6
  into a system-level architecture description: layers, data flows, integration
6
7
  points, and cross-cutting concerns.
7
8
  Use when: dispatched by autodoc-orchestrator Phase 3.
8
9
  NOT for: direct user invocation.
9
- version: 1.0.0
10
+ metadata:
11
+ version: 1.0.0
10
12
  ---
11
13
 
12
14
  # autodoc-architect
@@ -5,7 +5,8 @@ description: >
5
5
  into a cohesive package: main README.md and navigation index.
6
6
  Use when: dispatched by autodoc-orchestrator Phase 5.
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # autodoc-assembler
@@ -10,7 +10,8 @@ description: >
10
10
  Trigger on: user provides a repo path, asks to document existing code, wants
11
11
  onboarding docs, API reference, or architecture overview generated automatically.
12
12
  NOT for: writing new PRDs or planning new features (use gproject-orchestrator).
13
- version: 1.0.0
13
+ metadata:
14
+ version: 1.0.0
14
15
  ---
15
16
 
16
17
  <!-- SUBAGENT-STOP: If you are a subagent dispatched by another orchestrator, HALT.
@@ -5,7 +5,8 @@ description: >
5
5
  detects stack, identifies module boundaries, entry points, and dependencies.
6
6
  Use when: dispatched by autodoc-orchestrator Phase 1.
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # autodoc-scanner
@@ -5,7 +5,8 @@ description: >
5
5
  from analysis artifacts. Dispatched in parallel — one instance per section.
6
6
  Use when: dispatched by autodoc-orchestrator Phase 4.
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # autodoc-writer
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "ideation"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  # Brainstorm
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "ideation"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  # Brainstorm
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "ideation"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  # Brainstorm
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -5,7 +5,8 @@ description: >
5
5
  and best practices constraints. Catches contradictions, gaps, and violations.
6
6
  Use when: dispatched by gproject-orchestrator Phase 5.
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # gproject-consistency-checker
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "planning"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  # docpack-orchestrator
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode,claude"
16
16
  ---
17
17
 
18
18
  # docpack-review
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "analysis"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  # Interview
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "analysis"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  # Interview
@@ -12,8 +12,8 @@ metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
14
  category: "analysis"
15
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
16
  license: "MIT"
16
- compatibility: "cursor,codex,zed,opencode,claude"
17
17
  ---
18
18
 
19
19
  <SUBAGENT-STOP>
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "meta"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode,claude"
16
16
  ---
17
17
 
18
18
  # Interviewer
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "meta"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode,claude"
16
16
  ---
17
17
 
18
18
  # Interviewer
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "meta"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode,claude"
16
16
  ---
17
17
 
18
18
  <SUBAGENT-STOP>
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -5,7 +5,8 @@ description: >
5
5
  application architecture patterns. Produces constraints that PRD must follow.
6
6
  Use when: dispatched by gproject-orchestrator Phase 3.
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # gproject-patterns-researcher
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -4,7 +4,8 @@ description: >
4
4
  Generates roadmap, milestones, task breakdown, and dependency graph from PRD.
5
5
  Use when: dispatched by gproject-orchestrator Phase 6.
6
6
  NOT for: direct user invocation.
7
- version: 1.0.0
7
+ metadata:
8
+ version: 1.0.0
8
9
  ---
9
10
 
10
11
  # gproject-planner
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # PRD-Creator Sub-Agent
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # PRD-Creator Sub-Agent
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # PRD-Creator Sub-Agent
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # PRD-Creator Sub-Agent
@@ -11,8 +11,8 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
+ compatible_harnesses: "cursor,codex,zed,opencode"
14
15
  license: "MIT"
15
- compatibility: "cursor,codex,zed,opencode"
16
16
  ---
17
17
 
18
18
  # PRD-Creator Sub-Agent
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -4,7 +4,8 @@ description: >
4
4
  Defines core problems, goals, non-goals, and success metrics from discovery data.
5
5
  Use when: dispatched by gproject-orchestrator Phase 1.
6
6
  NOT for: direct user invocation.
7
- version: 1.0.0
7
+ metadata:
8
+ version: 1.0.0
8
9
  ---
9
10
 
10
11
  # gproject-problem-definer
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -4,7 +4,8 @@ description: >
4
4
  Collects and structures initial project information from multiple sources.
5
5
  Use when: dispatched by gproject-orchestrator Phase 0.
6
6
  NOT for: direct user invocation — always called through orchestrator.
7
- version: 1.0.0
7
+ metadata:
8
+ version: 1.0.0
8
9
  ---
9
10
 
10
11
  # gproject-discovery
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -8,8 +8,8 @@ metadata:
8
8
  author: "MrCipherSmith"
9
9
  version: "1.0.0"
10
10
  category: "planning"
11
+ compatible_harnesses: "cursor,codex,zed,opencode"
11
12
  license: "MIT"
12
- compatibility: "cursor,codex,zed,opencode"
13
13
  ---
14
14
 
15
15
 
@@ -5,7 +5,8 @@ description: >
5
5
  architecture doc, and best practices. Does NOT invent new architectural decisions.
6
6
  Use when: dispatched by gproject-orchestrator Phase 4.
7
7
  NOT for: direct user invocation.
8
- version: 1.0.0
8
+ metadata:
9
+ version: 1.0.0
9
10
  ---
10
11
 
11
12
  # gproject-spec-writer