@mrciphersmith/keryx 0.2.97 → 0.2.98

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 (165) hide show
  1. package/dist/cli.js +569 -235
  2. package/dist/core.js +1 -1
  3. package/package.json +1 -1
  4. package/src/gdskills/bundled/rules/core/api-contracts.mdc +1 -0
  5. package/src/gdskills/bundled/rules/core/code-style-patterns.mdc +1 -0
  6. package/src/gdskills/bundled/rules/core/database-patterns.mdc +1 -0
  7. package/src/gdskills/bundled/rules/core/documentation-management.mdc +33 -38
  8. package/src/gdskills/bundled/rules/core/error-handling.mdc +1 -11
  9. package/src/gdskills/bundled/rules/core/execution-metrics.md +1 -2
  10. package/src/gdskills/bundled/rules/core/frontend-assistant.mdc +1 -0
  11. package/src/gdskills/bundled/rules/core/git-concurrency.mdc +101 -0
  12. package/src/gdskills/bundled/rules/core/implementation-plans.mdc +23 -11
  13. package/src/gdskills/bundled/rules/core/mobx-store-template.mdc +1 -0
  14. package/src/gdskills/bundled/rules/core/nestjs-dto.mdc +1 -0
  15. package/src/gdskills/bundled/rules/core/playwright-testing.mdc +1 -0
  16. package/src/gdskills/bundled/rules/core/requirements-management.mdc +15 -11
  17. package/src/gdskills/bundled/rules/core/rule-management-workflow.mdc +29 -14
  18. package/src/gdskills/bundled/rules/core/shared-definitions.mdc +1 -1
  19. package/src/gdskills/bundled/rules/core/skill-lifecycle.mdc +9 -5
  20. package/src/gdskills/bundled/rules/core/skills-storage-workflow.mdc +59 -16
  21. package/src/gdskills/bundled/rules/core/storybook-guidelines.mdc +1 -0
  22. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.codex.md +48 -71
  23. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.cursor.md +48 -71
  24. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.md +48 -71
  25. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.opencode.md +48 -71
  26. package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.zed.md +48 -71
  27. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.codex.md +4 -4
  28. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.cursor.md +4 -4
  29. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.md +4 -4
  30. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.opencode.md +4 -4
  31. package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.zed.md +4 -4
  32. package/src/gdskills/bundled/skills/orchestration/context-collector/orchestrator-prompt.md +2 -2
  33. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.codex.md +12 -22
  34. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.cursor.md +12 -22
  35. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.detail.md +12 -22
  36. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.md +12 -22
  37. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.opencode.md +12 -22
  38. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.zed.md +12 -22
  39. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/analysis-request.md +2 -2
  40. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/analysis-request.template.md +1 -1
  41. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/input-contract.schema.json +4 -4
  42. package/src/gdskills/bundled/skills/orchestration/feature-analyzer/orchestrator-prompt.md +2 -2
  43. package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.codex.md +2 -2
  44. package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.cursor.md +2 -2
  45. package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.md +2 -2
  46. package/src/gdskills/bundled/skills/orchestration/flow-orchestrator/SKILL.md +46 -4
  47. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.codex.md +2 -2
  48. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.cursor.md +2 -2
  49. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.md +2 -2
  50. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.opencode.md +2 -2
  51. package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.zed.md +2 -2
  52. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.codex.md +3 -3
  53. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.cursor.md +3 -3
  54. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.md +3 -3
  55. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.opencode.md +3 -3
  56. package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.zed.md +3 -3
  57. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.codex.md +65 -23
  58. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.cursor.md +65 -23
  59. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.md +65 -23
  60. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.opencode.md +65 -23
  61. package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.zed.md +65 -23
  62. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.codex.md +19 -10
  63. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.cursor.md +19 -10
  64. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.md +19 -10
  65. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.opencode.md +19 -10
  66. package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.zed.md +19 -10
  67. package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.codex.md +1 -1
  68. package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.cursor.md +1 -1
  69. package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.md +1 -1
  70. package/src/gdskills/bundled/skills/planning/interview/SKILL.codex.md +1 -1
  71. package/src/gdskills/bundled/skills/planning/interview/SKILL.cursor.md +1 -1
  72. package/src/gdskills/bundled/skills/planning/interview/SKILL.md +1 -1
  73. package/src/gdskills/bundled/skills/planning/interviewer/SKILL.codex.md +1 -1
  74. package/src/gdskills/bundled/skills/planning/interviewer/SKILL.cursor.md +1 -1
  75. package/src/gdskills/bundled/skills/planning/interviewer/SKILL.md +1 -1
  76. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.codex.md +7 -7
  77. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.cursor.md +7 -7
  78. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.md +7 -7
  79. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.opencode.md +7 -7
  80. package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.zed.md +7 -7
  81. package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.codex.md +1 -1
  82. package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.cursor.md +1 -1
  83. package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.md +1 -1
  84. package/src/gdskills/bundled/skills/platform/hookify/SKILL.codex.md +1 -1
  85. package/src/gdskills/bundled/skills/platform/hookify/SKILL.cursor.md +1 -1
  86. package/src/gdskills/bundled/skills/platform/hookify/SKILL.md +1 -1
  87. package/src/gdskills/bundled/skills/quality/changelog/SKILL.codex.md +1 -1
  88. package/src/gdskills/bundled/skills/quality/changelog/SKILL.cursor.md +1 -1
  89. package/src/gdskills/bundled/skills/quality/changelog/SKILL.md +1 -1
  90. package/src/gdskills/bundled/skills/quality/commit/SKILL.codex.md +2 -2
  91. package/src/gdskills/bundled/skills/quality/commit/SKILL.cursor.md +2 -2
  92. package/src/gdskills/bundled/skills/quality/commit/SKILL.md +2 -2
  93. package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.codex.md +1 -1
  94. package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.cursor.md +1 -1
  95. package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.md +1 -1
  96. package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.codex.md +1 -1
  97. package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.cursor.md +1 -1
  98. package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.md +1 -1
  99. package/src/gdskills/bundled/skills/quality/deploy/SKILL.codex.md +1 -1
  100. package/src/gdskills/bundled/skills/quality/deploy/SKILL.cursor.md +1 -1
  101. package/src/gdskills/bundled/skills/quality/deploy/SKILL.md +1 -1
  102. package/src/gdskills/bundled/skills/quality/perf-check/SKILL.codex.md +1 -1
  103. package/src/gdskills/bundled/skills/quality/perf-check/SKILL.cursor.md +1 -1
  104. package/src/gdskills/bundled/skills/quality/perf-check/SKILL.md +1 -1
  105. package/src/gdskills/bundled/skills/quality/pr/SKILL.codex.md +1 -1
  106. package/src/gdskills/bundled/skills/quality/pr/SKILL.cursor.md +1 -1
  107. package/src/gdskills/bundled/skills/quality/pr/SKILL.md +1 -1
  108. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.codex.md +2 -2
  109. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.cursor.md +2 -2
  110. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.md +2 -2
  111. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.opencode.md +2 -2
  112. package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.zed.md +2 -2
  113. package/src/gdskills/bundled/skills/quality/push/SKILL.codex.md +1 -1
  114. package/src/gdskills/bundled/skills/quality/push/SKILL.cursor.md +1 -1
  115. package/src/gdskills/bundled/skills/quality/push/SKILL.md +1 -1
  116. package/src/gdskills/bundled/skills/quality/test-gen/SKILL.codex.md +7 -2
  117. package/src/gdskills/bundled/skills/quality/test-gen/SKILL.cursor.md +7 -2
  118. package/src/gdskills/bundled/skills/quality/test-gen/SKILL.md +7 -2
  119. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.codex.md +15 -9
  120. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.cursor.md +15 -9
  121. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.md +15 -9
  122. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.opencode.md +15 -9
  123. package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.zed.md +15 -9
  124. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.codex.md +2 -2
  125. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.cursor.md +2 -2
  126. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.md +2 -2
  127. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.opencode.md +2 -2
  128. package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.zed.md +2 -2
  129. package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.codex.md +2 -2
  130. package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.cursor.md +2 -2
  131. package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.md +2 -2
  132. package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.opencode.md +2 -2
  133. package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.zed.md +2 -2
  134. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.codex.md +2 -2
  135. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.cursor.md +2 -2
  136. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.md +2 -2
  137. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.opencode.md +2 -2
  138. package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.zed.md +2 -2
  139. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.codex.md +2 -2
  140. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.cursor.md +2 -2
  141. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.md +2 -2
  142. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.opencode.md +2 -2
  143. package/src/gdskills/bundled/skills/review/code-style-review/SKILL.zed.md +2 -2
  144. package/src/gdskills/bundled/skills/review/review-architecture/SKILL.md +2 -2
  145. package/src/gdskills/bundled/skills/review/review-backend/SKILL.md +3 -3
  146. package/src/gdskills/bundled/skills/review/review-clean-code/SKILL.md +2 -2
  147. package/src/gdskills/bundled/skills/review/review-core-boundaries/SKILL.md +1 -1
  148. package/src/gdskills/bundled/skills/review/review-flow-graph/SKILL.md +1 -1
  149. package/src/gdskills/bundled/skills/review/review-frontend/SKILL.md +2 -2
  150. package/src/gdskills/bundled/skills/review/review-frontend-conventions/SKILL.md +1 -1
  151. package/src/gdskills/bundled/skills/review/review-highload/SKILL.md +2 -2
  152. package/src/gdskills/bundled/skills/review/review-layout/SKILL.md +1 -1
  153. package/src/gdskills/bundled/skills/review/review-logic/SKILL.md +2 -2
  154. package/src/gdskills/bundled/skills/review/review-orchestrator/SKILL.md +40 -35
  155. package/src/gdskills/bundled/skills/review/review-orchestrator/input-contract.schema.json +1 -2
  156. package/src/gdskills/bundled/skills/review/review-orchestrator/review-context.schema.json +1 -5
  157. package/src/gdskills/bundled/skills/review/review-orchestrator/reviewer-input.schema.json +53 -9
  158. package/src/gdskills/bundled/skills/review/review-performance/SKILL.md +2 -2
  159. package/src/gdskills/bundled/skills/review/review-pr-feedback/SKILL.md +6 -6
  160. package/src/gdskills/bundled/skills/review/review-security-code/SKILL.md +2 -2
  161. package/src/gdskills/bundled/skills/review/review-style/SKILL.md +3 -3
  162. package/src/gdskills/bundled/skills/review/review-testing-practices/SKILL.md +1 -1
  163. package/src/gdskills/bundled/skills/review/review-verifier/SKILL.md +1 -1
  164. package/src/gdskills/bundled/rules/core/review-agent-profile.mdc +0 -49
  165. package/src/gdskills/bundled/rules/core/review-strict-profile.mdc +0 -48
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.3.1"
14
- category: "implementation"
14
+ category: "orchestration"
15
15
  agent_worthy: true
16
16
  compatible_harnesses: "claude,cursor,codex,zed,opencode"
17
17
  license: "MIT"
@@ -222,8 +222,6 @@ Based on what you're implementing, load and follow the relevant project rules.
222
222
 
223
223
  Rules live at `.metaproject/rules/core/<rule>.mdc` on every harness — that is the
224
224
  one tree `keryx init` installs and the one every build of this skill reads.
225
- Cursor additionally mirrors them under `.cursor/rules/core/<rule>.mdc`; when both
226
- are present they are copies of the same file, so read either.
227
225
 
228
226
  **Output of Phase 2:** Mental model of the implementation:
229
227
  ```
@@ -317,15 +315,21 @@ Execute the change plan. Write production-quality code.
317
315
 
318
316
  **4.5 Commit after implementation:**
319
317
 
320
- When auto-commit is enabled, create a conventional commit with the changes. Include the `refs #<issue_number>` line below only when a positive real issue number was supplied; otherwise omit that entire line:
318
+ When auto-commit is enabled, create a conventional commit with the changes. Stage explicit paths only — never `-A`/`--all`/`.` — and run every git command as `git -C "<codebase_path>"` (`rules/core/git-concurrency.mdc`). Include the `refs #<issue_number>` line below only when a positive real issue number was supplied; otherwise omit that entire line:
321
319
  ```bash
322
- git add <modified files>
323
- git commit -m "<type>(<scope>): <description>
320
+ git -C "<codebase_path>" add <modified files, explicit paths>
321
+ git -C "<codebase_path>" commit -m "<type>(<scope>): <description>
324
322
 
325
323
  refs #<issue_number>
326
324
  task: <task_id>"
327
325
  ```
328
326
 
327
+ When auto-commit is disabled, do not commit. Report the exact list of files you
328
+ changed — nothing inferred — in the Phase 6 STATUS response and the result
329
+ file's `files_modified`/`files_created`/`files_deleted`; the orchestrator stages
330
+ and commits those exact paths at the task boundary (`rules/core/git-concurrency.mdc`,
331
+ "Reporting Back").
332
+
329
333
  Commit type mapping:
330
334
  | Task Type | Commit Type |
331
335
  |-----------|-------------|
@@ -396,20 +400,25 @@ identical outputs cost the whole budget to learn what the second one already
396
400
  said. Report the block instead, naming what repeated.
397
401
 
398
402
 
399
- **ROLLBACK POLICY**: If implementation fatally fails (tests still failing after 3 attempts, or unresolvable compilation errors), restore ONLY the files this task changed — `git checkout -- <your files>` for tracked ones, delete the untracked ones you created — then report the failure in Phase 6.
403
+ **ROLLBACK POLICY**: If implementation fatally fails (tests still failing after 3 attempts, or unresolvable compilation errors), restore ONLY the files this task changed — `git -C "<codebase_path>" checkout -- <your files>` for tracked ones, delete the untracked ones you created — then report the failure in Phase 6.
400
404
 
401
405
  **Never run `git reset --hard`, `git clean`, or any unscoped revert.** You do not own the worktree. `job-orchestrator` dispatches implementers in PARALLEL WAVES sharing a single worktree, so an unscoped reset destroys a wave-mate's uncommitted work — work that is not yours, cannot be recovered, and whose loss is invisible to you because the other agent's failure surfaces somewhere else entirely. If you cannot identify which files are yours, leave the tree exactly as it is and say so in the report: a dirty tree is recoverable, a destroyed one is not.
402
406
 
407
+ **Same reasoning bans `git stash` and unscoped `git add`.** Never `git stash` — the stash stack is shared by every worktree, so even a scoped `push -- <file>` can be popped by another lane. Stage only the files this task changed (`git -C "<codebase_path>" add <path> <path>`), never `-A`/`--all`/`.`. Every git command runs as `git -C <this worktree's absolute path>`. See `rules/core/git-concurrency.mdc`.
408
+
403
409
  **5.5 Re-commit fixes if any:**
404
- When auto-commit is enabled, use the template below. Include `refs #<issue_number>` only for a supplied positive real issue number; otherwise omit that entire line.
410
+ When auto-commit is enabled, use the template below — explicit paths only, `git -C "<codebase_path>"` for every command (`rules/core/git-concurrency.mdc`). Include `refs #<issue_number>` only for a supplied positive real issue number; otherwise omit that entire line.
405
411
  ```bash
406
- git add <fixed files>
407
- git commit -m "fix(<scope>): resolve lint/type/test issues
412
+ git -C "<codebase_path>" add <fixed files, explicit paths>
413
+ git -C "<codebase_path>" commit -m "fix(<scope>): resolve lint/type/test issues
408
414
 
409
415
  refs #<issue_number>
410
416
  task: <task_id>"
411
417
  ```
412
418
 
419
+ When auto-commit is disabled, do not commit; report the exact fixed-file list in
420
+ Phase 6 as in 4.5 — the orchestrator commits it at the task boundary.
421
+
413
422
  ### Phase 6: REPORT
414
423
 
415
424
  Write the full result to a file, then emit a compact STATUS response to the orchestrator.
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.3.1"
14
- category: "implementation"
14
+ category: "orchestration"
15
15
  agent_worthy: true
16
16
  compatible_harnesses: "claude,cursor,codex,zed,opencode"
17
17
  license: "MIT"
@@ -222,8 +222,6 @@ Based on what you're implementing, load and follow the relevant project rules.
222
222
 
223
223
  Rules live at `.metaproject/rules/core/<rule>.mdc` on every harness — that is the
224
224
  one tree `keryx init` installs and the one every build of this skill reads.
225
- Cursor additionally mirrors them under `.cursor/rules/core/<rule>.mdc`; when both
226
- are present they are copies of the same file, so read either.
227
225
 
228
226
  **Output of Phase 2:** Mental model of the implementation:
229
227
  ```
@@ -317,15 +315,21 @@ Execute the change plan. Write production-quality code.
317
315
 
318
316
  **4.5 Commit after implementation:**
319
317
 
320
- When auto-commit is enabled, create a conventional commit with the changes. Include the `refs #<issue_number>` line below only when a positive real issue number was supplied; otherwise omit that entire line:
318
+ When auto-commit is enabled, create a conventional commit with the changes. Stage explicit paths only — never `-A`/`--all`/`.` — and run every git command as `git -C "<codebase_path>"` (`rules/core/git-concurrency.mdc`). Include the `refs #<issue_number>` line below only when a positive real issue number was supplied; otherwise omit that entire line:
321
319
  ```bash
322
- git add <modified files>
323
- git commit -m "<type>(<scope>): <description>
320
+ git -C "<codebase_path>" add <modified files, explicit paths>
321
+ git -C "<codebase_path>" commit -m "<type>(<scope>): <description>
324
322
 
325
323
  refs #<issue_number>
326
324
  task: <task_id>"
327
325
  ```
328
326
 
327
+ When auto-commit is disabled, do not commit. Report the exact list of files you
328
+ changed — nothing inferred — in the Phase 6 STATUS response and the result
329
+ file's `files_modified`/`files_created`/`files_deleted`; the orchestrator stages
330
+ and commits those exact paths at the task boundary (`rules/core/git-concurrency.mdc`,
331
+ "Reporting Back").
332
+
329
333
  Commit type mapping:
330
334
  | Task Type | Commit Type |
331
335
  |-----------|-------------|
@@ -396,20 +400,25 @@ identical outputs cost the whole budget to learn what the second one already
396
400
  said. Report the block instead, naming what repeated.
397
401
 
398
402
 
399
- **ROLLBACK POLICY**: If implementation fatally fails (tests still failing after 3 attempts, or unresolvable compilation errors), restore ONLY the files this task changed — `git checkout -- <your files>` for tracked ones, delete the untracked ones you created — then report the failure in Phase 6.
403
+ **ROLLBACK POLICY**: If implementation fatally fails (tests still failing after 3 attempts, or unresolvable compilation errors), restore ONLY the files this task changed — `git -C "<codebase_path>" checkout -- <your files>` for tracked ones, delete the untracked ones you created — then report the failure in Phase 6.
400
404
 
401
405
  **Never run `git reset --hard`, `git clean`, or any unscoped revert.** You do not own the worktree. `job-orchestrator` dispatches implementers in PARALLEL WAVES sharing a single worktree, so an unscoped reset destroys a wave-mate's uncommitted work — work that is not yours, cannot be recovered, and whose loss is invisible to you because the other agent's failure surfaces somewhere else entirely. If you cannot identify which files are yours, leave the tree exactly as it is and say so in the report: a dirty tree is recoverable, a destroyed one is not.
402
406
 
407
+ **Same reasoning bans `git stash` and unscoped `git add`.** Never `git stash` — the stash stack is shared by every worktree, so even a scoped `push -- <file>` can be popped by another lane. Stage only the files this task changed (`git -C "<codebase_path>" add <path> <path>`), never `-A`/`--all`/`.`. Every git command runs as `git -C <this worktree's absolute path>`. See `rules/core/git-concurrency.mdc`.
408
+
403
409
  **5.5 Re-commit fixes if any:**
404
- When auto-commit is enabled, use the template below. Include `refs #<issue_number>` only for a supplied positive real issue number; otherwise omit that entire line.
410
+ When auto-commit is enabled, use the template below — explicit paths only, `git -C "<codebase_path>"` for every command (`rules/core/git-concurrency.mdc`). Include `refs #<issue_number>` only for a supplied positive real issue number; otherwise omit that entire line.
405
411
  ```bash
406
- git add <fixed files>
407
- git commit -m "fix(<scope>): resolve lint/type/test issues
412
+ git -C "<codebase_path>" add <fixed files, explicit paths>
413
+ git -C "<codebase_path>" commit -m "fix(<scope>): resolve lint/type/test issues
408
414
 
409
415
  refs #<issue_number>
410
416
  task: <task_id>"
411
417
  ```
412
418
 
419
+ When auto-commit is disabled, do not commit; report the exact fixed-file list in
420
+ Phase 6 as in 4.5 — the orchestrator commits it at the task boundary.
421
+
413
422
  ### Phase 6: REPORT
414
423
 
415
424
  Write the full result to a file, then emit a compact STATUS response to the orchestrator.
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
- category: "ideation"
14
+ category: "planning"
15
15
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
16
16
  license: "MIT"
17
17
  ---
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
- category: "ideation"
14
+ category: "planning"
15
15
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
16
16
  license: "MIT"
17
17
  ---
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
- category: "ideation"
14
+ category: "planning"
15
15
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
16
16
  license: "MIT"
17
17
  ---
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
- category: "analysis"
14
+ category: "planning"
15
15
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
16
16
  license: "MIT"
17
17
  ---
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
- category: "analysis"
14
+ category: "planning"
15
15
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
16
16
  license: "MIT"
17
17
  ---
@@ -11,7 +11,7 @@ triggers:
11
11
  metadata:
12
12
  author: "MrCipherSmith"
13
13
  version: "1.0.0"
14
- category: "analysis"
14
+ category: "planning"
15
15
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
16
16
  license: "MIT"
17
17
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "meta"
13
+ category: "planning"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "meta"
13
+ category: "planning"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "meta"
13
+ category: "planning"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -11,7 +11,7 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
- compatible_harnesses: "cursor,codex,zed,opencode"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
17
17
 
@@ -93,6 +93,8 @@ When generating the final PRD, follow this exact structure:
93
93
  ```markdown
94
94
  # PRD: {Feature Name}
95
95
 
96
+ Version: 0.1.0
97
+
96
98
  ## 1. Overview
97
99
  Brief summary of the feature.
98
100
 
@@ -145,13 +147,11 @@ Then
145
147
  ## 6. Output Location & Format
146
148
 
147
149
  **Direct Mode:**
148
- - You MUST follow `rules/core/documentation-management.mdc` for the `requirements` category.
150
+ - You MUST follow `rules/core/requirements-package-standard.mdc` (via `rules/core/documentation-management.mdc` for the `requirements` category).
149
151
  - Before saving, ASK the user to confirm the feature name (`<name>`) or to suggest a custom path.
150
- - The default target path is: `<current_project_root>/docs/requirements/<name>-<YYYY-MM-DD>/`
151
- - You MUST generate 3 synchronized language variants:
152
- - `ru/<name>.md` (Russian for humans)
153
- - `en/<name>.md` (English for humans)
154
- - `ai/<name>.md` (AI-readable format, heavily using Gherkin)
152
+ - The default target path is: `<current_project_root>/docs/requirements/<name>/prd.md` — no date-stamped folder.
153
+ - If the requirements package (`README.md`, `prd.md`, `specification.md`) does not exist yet, create it; otherwise update `prd.md` in place and bump its `Version` field rather than creating a parallel copy.
154
+ - Default to a single document in the project's documentation language (`en` unless the project states otherwise). Generate additional language variants only when the user explicitly asks for them, and keep any variants you create synchronized.
155
155
  - You MUST NOT create a single file in the generic `docs/` root.
156
156
 
157
157
  **Orchestrated Mode:**
@@ -11,7 +11,7 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
- compatible_harnesses: "cursor,codex,zed,opencode"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
17
17
 
@@ -93,6 +93,8 @@ When generating the final PRD, follow this exact structure:
93
93
  ```markdown
94
94
  # PRD: {Feature Name}
95
95
 
96
+ Version: 0.1.0
97
+
96
98
  ## 1. Overview
97
99
  Brief summary of the feature.
98
100
 
@@ -145,13 +147,11 @@ Then
145
147
  ## 6. Output Location & Format
146
148
 
147
149
  **Direct Mode:**
148
- - You MUST follow `rules/core/documentation-management.mdc` for the `requirements` category.
150
+ - You MUST follow `rules/core/requirements-package-standard.mdc` (via `rules/core/documentation-management.mdc` for the `requirements` category).
149
151
  - Before saving, ASK the user to confirm the feature name (`<name>`) or to suggest a custom path.
150
- - The default target path is: `<current_project_root>/docs/requirements/<name>-<YYYY-MM-DD>/`
151
- - You MUST generate 3 synchronized language variants:
152
- - `ru/<name>.md` (Russian for humans)
153
- - `en/<name>.md` (English for humans)
154
- - `ai/<name>.md` (AI-readable format, heavily using Gherkin)
152
+ - The default target path is: `<current_project_root>/docs/requirements/<name>/prd.md` — no date-stamped folder.
153
+ - If the requirements package (`README.md`, `prd.md`, `specification.md`) does not exist yet, create it; otherwise update `prd.md` in place and bump its `Version` field rather than creating a parallel copy.
154
+ - Default to a single document in the project's documentation language (`en` unless the project states otherwise). Generate additional language variants only when the user explicitly asks for them, and keep any variants you create synchronized.
155
155
  - You MUST NOT create a single file in the generic `docs/` root.
156
156
 
157
157
  **Orchestrated Mode:**
@@ -11,7 +11,7 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
- compatible_harnesses: "cursor,codex,zed,opencode"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
17
17
 
@@ -93,6 +93,8 @@ When generating the final PRD, follow this exact structure:
93
93
  ```markdown
94
94
  # PRD: {Feature Name}
95
95
 
96
+ Version: 0.1.0
97
+
96
98
  ## 1. Overview
97
99
  Brief summary of the feature.
98
100
 
@@ -145,13 +147,11 @@ Then
145
147
  ## 6. Output Location & Format
146
148
 
147
149
  **Direct Mode:**
148
- - You MUST follow `rules/core/documentation-management.mdc` for the `requirements` category.
150
+ - You MUST follow `rules/core/requirements-package-standard.mdc` (via `rules/core/documentation-management.mdc` for the `requirements` category).
149
151
  - Before saving, ASK the user to confirm the feature name (`<name>`) or to suggest a custom path.
150
- - The default target path is: `<current_project_root>/docs/requirements/<name>-<YYYY-MM-DD>/`
151
- - You MUST generate 3 synchronized language variants:
152
- - `ru/<name>.md` (Russian for humans)
153
- - `en/<name>.md` (English for humans)
154
- - `ai/<name>.md` (AI-readable format, heavily using Gherkin)
152
+ - The default target path is: `<current_project_root>/docs/requirements/<name>/prd.md` — no date-stamped folder.
153
+ - If the requirements package (`README.md`, `prd.md`, `specification.md`) does not exist yet, create it; otherwise update `prd.md` in place and bump its `Version` field rather than creating a parallel copy.
154
+ - Default to a single document in the project's documentation language (`en` unless the project states otherwise). Generate additional language variants only when the user explicitly asks for them, and keep any variants you create synchronized.
155
155
  - You MUST NOT create a single file in the generic `docs/` root.
156
156
 
157
157
  **Orchestrated Mode:**
@@ -11,7 +11,7 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
- compatible_harnesses: "cursor,codex,zed,opencode"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
17
17
 
@@ -93,6 +93,8 @@ When generating the final PRD, follow this exact structure:
93
93
  ```markdown
94
94
  # PRD: {Feature Name}
95
95
 
96
+ Version: 0.1.0
97
+
96
98
  ## 1. Overview
97
99
  Brief summary of the feature.
98
100
 
@@ -145,13 +147,11 @@ Then
145
147
  ## 6. Output Location & Format
146
148
 
147
149
  **Direct Mode:**
148
- - You MUST follow `rules/core/documentation-management.mdc` for the `requirements` category.
150
+ - You MUST follow `rules/core/requirements-package-standard.mdc` (via `rules/core/documentation-management.mdc` for the `requirements` category).
149
151
  - Before saving, ASK the user to confirm the feature name (`<name>`) or to suggest a custom path.
150
- - The default target path is: `<current_project_root>/docs/requirements/<name>-<YYYY-MM-DD>/`
151
- - You MUST generate 3 synchronized language variants:
152
- - `ru/<name>.md` (Russian for humans)
153
- - `en/<name>.md` (English for humans)
154
- - `ai/<name>.md` (AI-readable format, heavily using Gherkin)
152
+ - The default target path is: `<current_project_root>/docs/requirements/<name>/prd.md` — no date-stamped folder.
153
+ - If the requirements package (`README.md`, `prd.md`, `specification.md`) does not exist yet, create it; otherwise update `prd.md` in place and bump its `Version` field rather than creating a parallel copy.
154
+ - Default to a single document in the project's documentation language (`en` unless the project states otherwise). Generate additional language variants only when the user explicitly asks for them, and keep any variants you create synchronized.
155
155
  - You MUST NOT create a single file in the generic `docs/` root.
156
156
 
157
157
  **Orchestrated Mode:**
@@ -11,7 +11,7 @@ metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
13
  category: "planning"
14
- compatible_harnesses: "cursor,codex,zed,opencode"
14
+ compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
17
17
 
@@ -93,6 +93,8 @@ When generating the final PRD, follow this exact structure:
93
93
  ```markdown
94
94
  # PRD: {Feature Name}
95
95
 
96
+ Version: 0.1.0
97
+
96
98
  ## 1. Overview
97
99
  Brief summary of the feature.
98
100
 
@@ -145,13 +147,11 @@ Then
145
147
  ## 6. Output Location & Format
146
148
 
147
149
  **Direct Mode:**
148
- - You MUST follow `rules/core/documentation-management.mdc` for the `requirements` category.
150
+ - You MUST follow `rules/core/requirements-package-standard.mdc` (via `rules/core/documentation-management.mdc` for the `requirements` category).
149
151
  - Before saving, ASK the user to confirm the feature name (`<name>`) or to suggest a custom path.
150
- - The default target path is: `<current_project_root>/docs/requirements/<name>-<YYYY-MM-DD>/`
151
- - You MUST generate 3 synchronized language variants:
152
- - `ru/<name>.md` (Russian for humans)
153
- - `en/<name>.md` (English for humans)
154
- - `ai/<name>.md` (AI-readable format, heavily using Gherkin)
152
+ - The default target path is: `<current_project_root>/docs/requirements/<name>/prd.md` — no date-stamped folder.
153
+ - If the requirements package (`README.md`, `prd.md`, `specification.md`) does not exist yet, create it; otherwise update `prd.md` in place and bump its `Version` field rather than creating a parallel copy.
154
+ - Default to a single document in the project's documentation language (`en` unless the project states otherwise). Generate additional language variants only when the user explicitly asks for them, and keep any variants you create synchronized.
155
155
  - You MUST NOT create a single file in the generic `docs/` root.
156
156
 
157
157
  **Orchestrated Mode:**
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "configuration"
13
+ category: "platform"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "configuration"
13
+ category: "platform"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "configuration"
13
+ category: "platform"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "configuration"
13
+ category: "platform"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "configuration"
13
+ category: "platform"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "configuration"
13
+ category: "platform"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "workflow"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "workflow"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "workflow"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -9,7 +9,7 @@ triggers:
9
9
  metadata:
10
10
  author: "MrCipherSmith"
11
11
  version: "1.0.0"
12
- category: "workflow"
12
+ category: "quality"
13
13
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
14
  license: "MIT"
15
15
  ---
@@ -29,7 +29,7 @@ Create well-structured git commits from current changes.
29
29
  If nothing is staged, intelligently stage relevant files:
30
30
  - Stage modified and new files that are part of the logical change
31
31
  - **NEVER** stage `.env`, credentials, secrets, or large binary files
32
- - Prefer `git add <specific files>` over `git add -A`
32
+ - Stage explicit pathspecs (`git add <specific files>`); **NEVER** `git add -A`, `--all`, or `.`
33
33
  - Ask the user before staging untracked files that look unrelated to recent work
34
34
 
35
35
  ### Phase 3: Generate Commit Message
@@ -9,7 +9,7 @@ triggers:
9
9
  metadata:
10
10
  author: "MrCipherSmith"
11
11
  version: "1.0.0"
12
- category: "workflow"
12
+ category: "quality"
13
13
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
14
  license: "MIT"
15
15
  ---
@@ -29,7 +29,7 @@ Create well-structured git commits from current changes.
29
29
  If nothing is staged, intelligently stage relevant files:
30
30
  - Stage modified and new files that are part of the logical change
31
31
  - **NEVER** stage `.env`, credentials, secrets, or large binary files
32
- - Prefer `git add <specific files>` over `git add -A`
32
+ - Stage explicit pathspecs (`git add <specific files>`); **NEVER** `git add -A`, `--all`, or `.`
33
33
  - Ask the user before staging untracked files that look unrelated to recent work
34
34
 
35
35
  ### Phase 3: Generate Commit Message
@@ -9,7 +9,7 @@ triggers:
9
9
  metadata:
10
10
  author: "MrCipherSmith"
11
11
  version: "1.0.0"
12
- category: "workflow"
12
+ category: "quality"
13
13
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
14
14
  license: "MIT"
15
15
  ---
@@ -29,7 +29,7 @@ Create well-structured git commits from current changes.
29
29
  If nothing is staged, intelligently stage relevant files:
30
30
  - Stage modified and new files that are part of the logical change
31
31
  - **NEVER** stage `.env`, credentials, secrets, or large binary files
32
- - Prefer `git add <specific files>` over `git add -A`
32
+ - Stage explicit pathspecs (`git add <specific files>`); **NEVER** `git add -A`, `--all`, or `.`
33
33
  - Ask the user before staging untracked files that look unrelated to recent work
34
34
 
35
35
  ### Phase 3: Generate Commit Message
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "database"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "database"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "database"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "maintenance"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "maintenance"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---
@@ -10,7 +10,7 @@ triggers:
10
10
  metadata:
11
11
  author: "MrCipherSmith"
12
12
  version: "1.0.0"
13
- category: "maintenance"
13
+ category: "quality"
14
14
  compatible_harnesses: "cursor,codex,zed,opencode,claude"
15
15
  license: "MIT"
16
16
  ---