nitm-ai-dev-toolkit 5.0.0 → 5.1.0

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 (224) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +30 -10
  3. package/bin/cli.js +635 -88
  4. package/package.json +1 -1
  5. package/src/monorepo/.agents/skills/factory/SKILL.md +123 -57
  6. package/src/monorepo/{.claude/agents-snippets/factory-approver.md → .agents/skills/factory/roles/approve.md} +3 -3
  7. package/src/monorepo/{.claude/agents-snippets/factory-builder.md → .agents/skills/factory/roles/build.md} +3 -3
  8. package/src/monorepo/{.claude/agents-snippets/factory-reviewer-code.md → .agents/skills/factory/roles/review-code.md} +5 -5
  9. package/src/{repo/.claude/agents-snippets/factory-reviewer-security.md → monorepo/.agents/skills/factory/roles/review-security.md} +4 -4
  10. package/src/monorepo/{.claude/agents-snippets/factory-reviewer-ui.md → .agents/skills/factory/roles/review-ui.md} +6 -6
  11. package/src/monorepo/{.claude/agents-snippets/factory-reviewer-ux.md → .agents/skills/factory/roles/review-ux.md} +6 -6
  12. package/src/monorepo/{.claude/agents-snippets/factory-spec-writer.md → .agents/skills/factory/roles/spec.md} +2 -2
  13. package/src/monorepo/.claude/agents/implementer.agent.md +1 -1
  14. package/src/monorepo/.claude/agents/planner.agent.md +1 -1
  15. package/src/monorepo/.claude/agents/reviewer.agent.md +1 -1
  16. package/src/monorepo/.claude/commands/assign-tasks.md +1 -0
  17. package/src/monorepo/.claude/commands/factory.md +9 -9
  18. package/src/monorepo/.claude/commands/ponytail-review.md +1 -1
  19. package/src/monorepo/.claude/prompt-snippets/assign-tasks.md +13 -3
  20. package/src/monorepo/.claude/prompt-snippets/bootstrap-patch.md +32 -25
  21. package/src/monorepo/.claude/prompt-snippets/bootstrap-upgrade.md +13 -14
  22. package/src/monorepo/.claude/prompt-snippets/bootstrap.md +12 -12
  23. package/src/monorepo/.claude/prompt-snippets/factory.md +5 -5
  24. package/src/monorepo/.claude/prompt-snippets/implement-feature.md +3 -1
  25. package/src/monorepo/.claude/rules-snippets/subagent-workflow.md +2 -2
  26. package/src/monorepo/.cursor/commands/factory.md +9 -9
  27. package/src/monorepo/.github/prompts/factory.prompt.md +9 -9
  28. package/src/monorepo/.opencode/agents/admin-portal.md +1 -4
  29. package/src/monorepo/.opencode/agents/api-specialist.md +1 -4
  30. package/src/monorepo/.opencode/agents/backend-architect.md +1 -4
  31. package/src/monorepo/.opencode/agents/documenter.md +1 -4
  32. package/src/monorepo/.opencode/agents/feature-builder.md +1 -4
  33. package/src/monorepo/.opencode/agents/frontend-developer.md +1 -4
  34. package/src/monorepo/.opencode/agents/green.md +1 -4
  35. package/src/monorepo/.opencode/agents/implementer.md +1 -4
  36. package/src/monorepo/.opencode/agents/planner.md +1 -4
  37. package/src/monorepo/.opencode/agents/red.md +1 -4
  38. package/src/monorepo/.opencode/agents/refactor.md +1 -4
  39. package/src/monorepo/.opencode/agents/researcher.md +1 -4
  40. package/src/monorepo/.opencode/agents/reviewer.md +1 -4
  41. package/src/monorepo/.opencode/agents/tdd.md +1 -4
  42. package/src/monorepo/.opencode/commands/assign-tasks.md +1 -1
  43. package/src/monorepo/.opencode/commands/bootstrap-patch.md +1 -1
  44. package/src/monorepo/.opencode/commands/bootstrap-upgrade.md +1 -1
  45. package/src/monorepo/.opencode/commands/bootstrap.md +1 -1
  46. package/src/monorepo/.opencode/commands/commit-push.md +1 -1
  47. package/src/monorepo/.opencode/commands/constitution.md +1 -1
  48. package/src/monorepo/.opencode/commands/create-skill.md +1 -1
  49. package/src/monorepo/.opencode/commands/factory.md +9 -9
  50. package/src/monorepo/.opencode/commands/implement-feature.md +1 -1
  51. package/src/monorepo/.opencode/commands/implement-fixes.md +1 -1
  52. package/src/monorepo/.opencode/commands/implement.md +1 -1
  53. package/src/monorepo/.opencode/commands/plan.md +1 -1
  54. package/src/monorepo/.opencode/commands/playwright-test.md +1 -1
  55. package/src/monorepo/.opencode/commands/ponytail-audit.md +1 -1
  56. package/src/monorepo/.opencode/commands/ponytail-debt.md +1 -1
  57. package/src/monorepo/.opencode/commands/ponytail-gain.md +1 -1
  58. package/src/monorepo/.opencode/commands/ponytail-help.md +1 -1
  59. package/src/monorepo/.opencode/commands/ponytail-review.md +1 -1
  60. package/src/monorepo/.opencode/commands/ponytail.md +1 -1
  61. package/src/monorepo/.opencode/commands/release-notes.md +1 -1
  62. package/src/monorepo/.opencode/commands/review-pr.md +1 -1
  63. package/src/monorepo/.opencode/commands/review.md +1 -1
  64. package/src/monorepo/.opencode/commands/specify.md +1 -1
  65. package/src/monorepo/.opencode/commands/tasks.md +1 -1
  66. package/src/monorepo/.opencode/opencode.jsonc +1 -2
  67. package/src/monorepo/.opencode/rules/agent-conduct.md +1 -1
  68. package/src/monorepo/.opencode/rules/api-server.md +1 -1
  69. package/src/monorepo/.opencode/rules/coding-standards.md +1 -1
  70. package/src/monorepo/.opencode/rules/component-structure.md +1 -1
  71. package/src/monorepo/.opencode/rules/core-libraries.md +1 -1
  72. package/src/monorepo/.opencode/rules/environment-tooling.md +1 -1
  73. package/src/monorepo/.opencode/rules/logging-comments.md +1 -1
  74. package/src/monorepo/.opencode/rules/logging.md +1 -1
  75. package/src/monorepo/.opencode/rules/prisma-migrations.md +1 -1
  76. package/src/monorepo/.opencode/rules/project-context.md +1 -1
  77. package/src/monorepo/.opencode/rules/server-client-separation.md +1 -1
  78. package/src/monorepo/.opencode/rules/subagent-workflow.md +1 -1
  79. package/src/monorepo/.opencode/rules/testing-quality.md +1 -1
  80. package/src/monorepo/.opencode/rules/ui-accessibility.md +1 -1
  81. package/src/monorepo/.opencode/rules/version-control.md +1 -1
  82. package/src/monorepo/.opencode/rules/what-to-avoid.md +1 -1
  83. package/src/monorepo/AGENTS.md +4 -4
  84. package/src/monorepo/README.md +5 -5
  85. package/src/monorepo/factory/README.md +51 -24
  86. package/src/monorepo/factory/worktree-bootstrap.md +32 -0
  87. package/src/repo/.agents/skills/factory/SKILL.md +122 -56
  88. package/src/repo/{.claude/agents-snippets/factory-approver.md → .agents/skills/factory/roles/approve.md} +3 -3
  89. package/src/repo/{.claude/agents-snippets/factory-builder.md → .agents/skills/factory/roles/build.md} +3 -3
  90. package/src/repo/{.claude/agents-snippets/factory-reviewer-code.md → .agents/skills/factory/roles/review-code.md} +5 -5
  91. package/src/{monorepo/.claude/agents-snippets/factory-reviewer-security.md → repo/.agents/skills/factory/roles/review-security.md} +4 -4
  92. package/src/repo/{.claude/agents-snippets/factory-reviewer-ui.md → .agents/skills/factory/roles/review-ui.md} +6 -6
  93. package/src/repo/{.claude/agents-snippets/factory-reviewer-ux.md → .agents/skills/factory/roles/review-ux.md} +6 -6
  94. package/src/repo/{.claude/agents-snippets/factory-spec-writer.md → .agents/skills/factory/roles/spec.md} +2 -2
  95. package/src/repo/.claude/agents/implementer.agent.md +1 -1
  96. package/src/repo/.claude/agents/planner.agent.md +1 -1
  97. package/src/repo/.claude/agents/reviewer.agent.md +1 -1
  98. package/src/repo/.claude/commands/assign-tasks.md +1 -0
  99. package/src/repo/.claude/commands/factory.md +9 -9
  100. package/src/repo/.claude/commands/ponytail-review.md +1 -1
  101. package/src/repo/.claude/prompt-snippets/assign-tasks.md +13 -3
  102. package/src/repo/.claude/prompt-snippets/bootstrap-patch.md +32 -25
  103. package/src/repo/.claude/prompt-snippets/bootstrap-upgrade.md +17 -17
  104. package/src/repo/.claude/prompt-snippets/bootstrap.md +12 -12
  105. package/src/repo/.claude/prompt-snippets/factory.md +5 -5
  106. package/src/repo/.claude/prompt-snippets/implement-feature.md +3 -1
  107. package/src/repo/.claude/rules-snippets/subagent-workflow.md +2 -2
  108. package/src/repo/.cursor/commands/factory.md +9 -9
  109. package/src/repo/.github/prompts/factory.prompt.md +9 -9
  110. package/src/repo/.opencode/agents/admin-portal.md +1 -4
  111. package/src/repo/.opencode/agents/api-specialist.md +1 -4
  112. package/src/repo/.opencode/agents/backend-architect.md +1 -4
  113. package/src/repo/.opencode/agents/documenter.md +1 -4
  114. package/src/repo/.opencode/agents/feature-builder.md +1 -4
  115. package/src/repo/.opencode/agents/frontend-developer.md +1 -4
  116. package/src/repo/.opencode/agents/green.md +1 -4
  117. package/src/repo/.opencode/agents/implementer.md +1 -4
  118. package/src/repo/.opencode/agents/planner.md +1 -4
  119. package/src/repo/.opencode/agents/red.md +1 -4
  120. package/src/repo/.opencode/agents/refactor.md +1 -4
  121. package/src/repo/.opencode/agents/researcher.md +1 -4
  122. package/src/repo/.opencode/agents/reviewer.md +1 -4
  123. package/src/repo/.opencode/agents/tdd.md +1 -4
  124. package/src/repo/.opencode/commands/assign-tasks.md +1 -1
  125. package/src/repo/.opencode/commands/bootstrap-patch.md +1 -1
  126. package/src/repo/.opencode/commands/bootstrap-upgrade.md +1 -1
  127. package/src/repo/.opencode/commands/bootstrap.md +1 -1
  128. package/src/repo/.opencode/commands/commit-push.md +1 -1
  129. package/src/repo/.opencode/commands/constitution.md +1 -1
  130. package/src/repo/.opencode/commands/create-skill.md +1 -1
  131. package/src/repo/.opencode/commands/factory.md +9 -9
  132. package/src/repo/.opencode/commands/implement-feature.md +1 -1
  133. package/src/repo/.opencode/commands/implement-fixes.md +1 -1
  134. package/src/repo/.opencode/commands/implement.md +1 -1
  135. package/src/repo/.opencode/commands/plan.md +1 -1
  136. package/src/repo/.opencode/commands/playwright-test.md +1 -1
  137. package/src/repo/.opencode/commands/ponytail-audit.md +1 -1
  138. package/src/repo/.opencode/commands/ponytail-debt.md +1 -1
  139. package/src/repo/.opencode/commands/ponytail-gain.md +1 -1
  140. package/src/repo/.opencode/commands/ponytail-help.md +1 -1
  141. package/src/repo/.opencode/commands/ponytail-review.md +1 -1
  142. package/src/repo/.opencode/commands/ponytail.md +1 -1
  143. package/src/repo/.opencode/commands/release-notes.md +1 -1
  144. package/src/repo/.opencode/commands/review-pr.md +1 -1
  145. package/src/repo/.opencode/commands/review.md +1 -1
  146. package/src/repo/.opencode/commands/specify.md +1 -1
  147. package/src/repo/.opencode/commands/tasks.md +1 -1
  148. package/src/repo/.opencode/opencode.jsonc +1 -2
  149. package/src/repo/.opencode/rules/agent-conduct.md +1 -1
  150. package/src/repo/.opencode/rules/api-server.md +1 -1
  151. package/src/repo/.opencode/rules/coding-standards.md +1 -1
  152. package/src/repo/.opencode/rules/component-structure.md +1 -1
  153. package/src/repo/.opencode/rules/core-libraries.md +1 -1
  154. package/src/repo/.opencode/rules/environment-tooling.md +1 -1
  155. package/src/repo/.opencode/rules/logging-comments.md +1 -1
  156. package/src/repo/.opencode/rules/logging.md +1 -1
  157. package/src/repo/.opencode/rules/prisma-migrations.md +1 -1
  158. package/src/repo/.opencode/rules/project-context.md +1 -1
  159. package/src/repo/.opencode/rules/server-client-separation.md +1 -1
  160. package/src/repo/.opencode/rules/subagent-workflow.md +1 -1
  161. package/src/repo/.opencode/rules/testing-quality.md +1 -1
  162. package/src/repo/.opencode/rules/ui-accessibility.md +1 -1
  163. package/src/repo/.opencode/rules/version-control.md +1 -1
  164. package/src/repo/.opencode/rules/what-to-avoid.md +1 -1
  165. package/src/repo/AGENTS.md +4 -4
  166. package/src/repo/README.md +5 -5
  167. package/src/repo/factory/README.md +44 -23
  168. package/src/repo/factory/worktree-bootstrap.md +32 -0
  169. package/src/monorepo/.claude/agents/factory-approver.agent.md +0 -12
  170. package/src/monorepo/.claude/agents/factory-builder.agent.md +0 -12
  171. package/src/monorepo/.claude/agents/factory-reviewer-code.agent.md +0 -12
  172. package/src/monorepo/.claude/agents/factory-reviewer-security.agent.md +0 -12
  173. package/src/monorepo/.claude/agents/factory-reviewer-ui.agent.md +0 -12
  174. package/src/monorepo/.claude/agents/factory-reviewer-ux.agent.md +0 -12
  175. package/src/monorepo/.claude/agents/factory-spec-writer.agent.md +0 -12
  176. package/src/monorepo/.cursor/agents/factory-approver.agent.md +0 -11
  177. package/src/monorepo/.cursor/agents/factory-builder.agent.md +0 -11
  178. package/src/monorepo/.cursor/agents/factory-reviewer-code.agent.md +0 -11
  179. package/src/monorepo/.cursor/agents/factory-reviewer-security.agent.md +0 -11
  180. package/src/monorepo/.cursor/agents/factory-reviewer-ui.agent.md +0 -11
  181. package/src/monorepo/.cursor/agents/factory-reviewer-ux.agent.md +0 -11
  182. package/src/monorepo/.cursor/agents/factory-spec-writer.agent.md +0 -11
  183. package/src/monorepo/.github/agents/factory-approver.agent.md +0 -11
  184. package/src/monorepo/.github/agents/factory-builder.agent.md +0 -11
  185. package/src/monorepo/.github/agents/factory-reviewer-code.agent.md +0 -11
  186. package/src/monorepo/.github/agents/factory-reviewer-security.agent.md +0 -11
  187. package/src/monorepo/.github/agents/factory-reviewer-ui.agent.md +0 -11
  188. package/src/monorepo/.github/agents/factory-reviewer-ux.agent.md +0 -11
  189. package/src/monorepo/.github/agents/factory-spec-writer.agent.md +0 -11
  190. package/src/monorepo/.opencode/agents/factory-approver.md +0 -20
  191. package/src/monorepo/.opencode/agents/factory-builder.md +0 -20
  192. package/src/monorepo/.opencode/agents/factory-reviewer-code.md +0 -20
  193. package/src/monorepo/.opencode/agents/factory-reviewer-security.md +0 -20
  194. package/src/monorepo/.opencode/agents/factory-reviewer-ui.md +0 -20
  195. package/src/monorepo/.opencode/agents/factory-reviewer-ux.md +0 -20
  196. package/src/monorepo/.opencode/agents/factory-spec-writer.md +0 -20
  197. package/src/repo/.claude/agents/factory-approver.agent.md +0 -12
  198. package/src/repo/.claude/agents/factory-builder.agent.md +0 -12
  199. package/src/repo/.claude/agents/factory-reviewer-code.agent.md +0 -12
  200. package/src/repo/.claude/agents/factory-reviewer-security.agent.md +0 -12
  201. package/src/repo/.claude/agents/factory-reviewer-ui.agent.md +0 -12
  202. package/src/repo/.claude/agents/factory-reviewer-ux.agent.md +0 -12
  203. package/src/repo/.claude/agents/factory-spec-writer.agent.md +0 -12
  204. package/src/repo/.cursor/agents/factory-approver.agent.md +0 -11
  205. package/src/repo/.cursor/agents/factory-builder.agent.md +0 -11
  206. package/src/repo/.cursor/agents/factory-reviewer-code.agent.md +0 -11
  207. package/src/repo/.cursor/agents/factory-reviewer-security.agent.md +0 -11
  208. package/src/repo/.cursor/agents/factory-reviewer-ui.agent.md +0 -11
  209. package/src/repo/.cursor/agents/factory-reviewer-ux.agent.md +0 -11
  210. package/src/repo/.cursor/agents/factory-spec-writer.agent.md +0 -11
  211. package/src/repo/.github/agents/factory-approver.agent.md +0 -11
  212. package/src/repo/.github/agents/factory-builder.agent.md +0 -11
  213. package/src/repo/.github/agents/factory-reviewer-code.agent.md +0 -11
  214. package/src/repo/.github/agents/factory-reviewer-security.agent.md +0 -11
  215. package/src/repo/.github/agents/factory-reviewer-ui.agent.md +0 -11
  216. package/src/repo/.github/agents/factory-reviewer-ux.agent.md +0 -11
  217. package/src/repo/.github/agents/factory-spec-writer.agent.md +0 -11
  218. package/src/repo/.opencode/agents/factory-approver.md +0 -20
  219. package/src/repo/.opencode/agents/factory-builder.md +0 -20
  220. package/src/repo/.opencode/agents/factory-reviewer-code.md +0 -20
  221. package/src/repo/.opencode/agents/factory-reviewer-security.md +0 -20
  222. package/src/repo/.opencode/agents/factory-reviewer-ui.md +0 -20
  223. package/src/repo/.opencode/agents/factory-reviewer-ux.md +0 -20
  224. package/src/repo/.opencode/agents/factory-spec-writer.md +0 -20
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, local merge"
2
+ description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, merge (local, or a merge request on the forge)"
3
3
  argument-hint: "[--in-place] <feature request> | start [--in-place] <request | KEY | slug | job-id> | approve <job-id> | rework <job-id> <note> | abandon <job-id> | status [--all] | watch [--all] | archive [--all] [--dry-run] | prune [--all] [--abandoned] [--dry-run]"
4
4
  ---
5
5
 
@@ -11,14 +11,14 @@ argument-hint: "[--in-place] <feature request> | start [--in-place] <request | K
11
11
 
12
12
  | Agent | When to use |
13
13
  |-------|-------------|
14
- | `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
15
- | `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location |
16
- | `factory-reviewer-code` | Review round, `code` lens |
17
- | `factory-reviewer-security` | Review round, `security` lens |
18
- | `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
19
- | `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
20
- | `factory-approver` | Approval gate: writes `decision.md` |
14
+ | `planner` | Spec writer. Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md`. Brief: `.agents/skills/factory/roles/spec.md` |
15
+ | `implementer` | Builder. Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location. Brief: `.agents/skills/factory/roles/build.md` |
16
+ | `reviewer` | Code reviewer. Review round, `code` lens. Brief: `.agents/skills/factory/roles/review-code.md` |
17
+ | `reviewer` | Security reviewer, fresh context. Review round, `security` lens. Brief: `.agents/skills/factory/roles/review-security.md` |
18
+ | `reviewer` | UX reviewer. Review round, `ux` lens (opt-in). Brief: `.agents/skills/factory/roles/review-ux.md` |
19
+ | `reviewer` | UI reviewer. Review round, `ui` lens (opt-in). Brief: `.agents/skills/factory/roles/review-ui.md` |
20
+ | `reviewer` | Approver, fresh context. Approval gate: returns the decision, which the orchestrator saves as `decision.md`. Brief: `.agents/skills/factory/roles/approve.md` |
21
21
 
22
- Dispatch each agent by its kebab-case name, as in the first column. Copilot may show a display name; pick the agent with that name.
22
+ Dispatch each native agent by the name in the first column, and tell it to read the brief in the last column first. Reviewers and the approver return their report, and the orchestrator saves it. Copilot may show a display name; pick the agent with that name.
23
23
 
24
24
  **CRITICAL: READ:** [.claude/prompt-snippets/factory.md](../../.claude/prompt-snippets/factory.md)
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, local merge"
2
+ description: "Run an opt-in factory job: intake, spec and plan gates, build in a worktree or in place, reviews, approval, merge (local, or a merge request on the forge)"
3
3
  tools: ["agent", "edit", "search", "read", "runInTerminal", "terminalLastCommand"]
4
4
  argument-hint: "[--in-place] <feature request> | start [--in-place] <request | KEY | slug | job-id> | approve <job-id> | rework <job-id> <note> | abandon <job-id> | status [--all] | watch [--all] | archive [--all] [--dry-run] | prune [--all] [--abandoned] [--dry-run]"
5
5
  ---
@@ -12,14 +12,14 @@ argument-hint: "[--in-place] <feature request> | start [--in-place] <request | K
12
12
 
13
13
  | Agent | When to use |
14
14
  |-------|-------------|
15
- | `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
16
- | `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location |
17
- | `factory-reviewer-code` | Review round, `code` lens |
18
- | `factory-reviewer-security` | Review round, `security` lens |
19
- | `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
20
- | `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
21
- | `factory-approver` | Approval gate: writes `decision.md` |
15
+ | `planner` | Spec writer. Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md`. Brief: `.agents/skills/factory/roles/spec.md` |
16
+ | `implementer` | Builder. Build, repair, and rework: writes `build.md` in the job folder; its code goes in the build location. Brief: `.agents/skills/factory/roles/build.md` |
17
+ | `reviewer` | Code reviewer. Review round, `code` lens. Brief: `.agents/skills/factory/roles/review-code.md` |
18
+ | `reviewer` | Security reviewer, fresh context. Review round, `security` lens. Brief: `.agents/skills/factory/roles/review-security.md` |
19
+ | `reviewer` | UX reviewer. Review round, `ux` lens (opt-in). Brief: `.agents/skills/factory/roles/review-ux.md` |
20
+ | `reviewer` | UI reviewer. Review round, `ui` lens (opt-in). Brief: `.agents/skills/factory/roles/review-ui.md` |
21
+ | `reviewer` | Approver, fresh context. Approval gate: returns the decision, which the orchestrator saves as `decision.md`. Brief: `.agents/skills/factory/roles/approve.md` |
22
22
 
23
- Dispatch each agent by its kebab-case name, as in the first column. Copilot may show a display name; pick the agent with that name.
23
+ Dispatch each native agent by the name in the first column, and tell it to read the brief in the last column first. Reviewers and the approver return their report, and the orchestrator saves it. Copilot may show a display name; pick the agent with that name.
24
24
 
25
25
  **CRITICAL: READ:** [.claude/prompt-snippets/factory.md](../../.claude/prompt-snippets/factory.md).
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling. Specializes in admin frameworks and monitoring ecosystem tools."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Build administrator portals with RBAC, system dashboards, reporting, analytics, and operational tooling.
19
16
 
20
- @.claude/agents-snippets/admin-portal.md
17
+ Read and follow `.claude/agents-snippets/admin-portal.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Design and implement API architecture, documentation, and developer experience. Use for REST design, GraphQL, OpenAPI specs, SDK generation, API versioning, and integration patterns."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Design and implement API architecture, documentation, and developer experience.
19
16
 
20
- @.claude/agents-snippets/api-specialist.md
17
+ Read and follow `.claude/agents-snippets/api-specialist.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Design APIs, databases, and server-side architecture. Use for scalable backend systems, data modeling, caching strategies, system design, and infrastructure decisions."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Design APIs, databases, and server-side architecture.
19
16
 
20
- @.claude/agents-snippets/backend-architect.md
17
+ Read and follow `.claude/agents-snippets/backend-architect.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Analyze codebases and create comprehensive documentation. Use for AGENTS.md, README files, API docs, architecture documentation, and onboarding guides."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Analyze codebases and create comprehensive documentation.
19
16
 
20
- @.claude/agents-snippets/documenter.md
17
+ Read and follow `.claude/agents-snippets/documenter.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Coordinate end-to-end feature development using subagents for planning, implementation, and review. Orchestrates the full development lifecycle."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.3
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -20,4 +17,4 @@ permissions:
20
17
 
21
18
  Coordinate end-to-end feature development using subagents for planning, implementation, and review.
22
19
 
23
- @.claude/agents-snippets/feature-builder.md
20
+ Read and follow `.claude/agents-snippets/feature-builder.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Build user interfaces, implement components, handle state management, and optimize frontend performance. Use for responsive, accessible, and performant web applications."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Build user interfaces, implement components, handle state management, and optimize frontend performance.
19
16
 
20
- @.claude/agents-snippets/frontend-developer.md
17
+ Read and follow `.claude/agents-snippets/frontend-developer.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Write minimal code to make failing tests pass. Part of the TDD red-green-refactor cycle."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Write minimal code to make failing tests pass. Part of the TDD red-green-refactor cycle.
19
16
 
20
- @.claude/agents-snippets/green.md
17
+ Read and follow `.claude/agents-snippets/green.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Implement code changes for a specific task. Follow TDD, write tests alongside code, and self-review before reporting completion."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Implement code changes for a specific task. Follow TDD, write tests alongside code, and self-review before reporting completion.
19
16
 
20
- @.claude/agents-snippets/implementer.md
17
+ Read and follow `.claude/agents-snippets/implementer.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Break down feature requests into implementation tasks. Read specifications, analyze codebase patterns, and produce structured plans with dependencies."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Break down feature requests into implementation tasks. Read specifications, analyze codebase patterns, and produce structured plans with dependencies.
19
16
 
20
- @.claude/agents-snippets/planner.md
17
+ Read and follow `.claude/agents-snippets/planner.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Write failing tests that define expected behavior. Part of the TDD red-green-refactor cycle."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Write failing tests that define expected behavior. Part of the TDD red-green-refactor cycle.
19
16
 
20
- @.claude/agents-snippets/red.md
17
+ Read and follow `.claude/agents-snippets/red.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Improve code quality and structure while keeping all tests passing. Part of the TDD red-green-refactor cycle."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Improve code quality and structure while keeping all tests passing. Part of the TDD red-green-refactor cycle.
19
16
 
20
- @.claude/agents-snippets/refactor.md
17
+ Read and follow `.claude/agents-snippets/refactor.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Research codebase patterns, dependencies, and technical context. Analyze code structure, find relevant examples, and report findings without making changes."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Research codebase patterns, dependencies, and technical context. Analyze code structure, find relevant examples, and report findings without making changes.
19
16
 
20
- @.claude/agents-snippets/researcher.md
17
+ Read and follow `.claude/agents-snippets/researcher.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Review code changes for correctness, code quality, security, and adherence to project patterns. Provide actionable feedback with specific file and line references. Use immediately after writing or modifying code, or as a quality gate in orchestrated workflows."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -17,4 +14,4 @@ permissions:
17
14
 
18
15
  Review code changes for correctness, code quality, security, and adherence to project patterns.
19
16
 
20
- @.claude/agents-snippets/reviewer.md
17
+ Read and follow `.claude/agents-snippets/reviewer.md` before performing this role.
@@ -1,9 +1,6 @@
1
1
  ---
2
2
  description: "Implement a feature using test-driven development with red-green-refactor cycle. Coordinates specialized subagents for writing failing tests, implementing code, and refactoring."
3
3
  mode: subagent
4
- request:
5
- body:
6
- temperature: 0.3
7
4
  permissions:
8
5
  - action: edit
9
6
  resource: "*"
@@ -20,4 +17,4 @@ permissions:
20
17
 
21
18
  Implement a feature using test-driven development with red-green-refactor cycle.
22
19
 
23
- @.claude/agents-snippets/tdd.md
20
+ Read and follow `.claude/agents-snippets/tdd.md` before performing this role.
@@ -13,4 +13,4 @@ description: "Create {{ISSUE_TRACKER}} tickets from requirements or task files"
13
13
 
14
14
  $ARGUMENTS
15
15
 
16
- @.claude/prompt-snippets/assign-tasks.md
16
+ Read and follow `.claude/prompt-snippets/assign-tasks.md` before executing this command.
@@ -15,4 +15,4 @@ description: "Patch AI instructions by fetching updates from the toolkit repo an
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/bootstrap-patch.md
18
+ Read and follow `.claude/prompt-snippets/bootstrap-patch.md` before executing this command.
@@ -15,4 +15,4 @@ description: "Upgrade AI instructions from pre-3.0 inline pattern to 3.0+ snippe
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/bootstrap-upgrade.md
18
+ Read and follow `.claude/prompt-snippets/bootstrap-upgrade.md` before executing this command.
@@ -15,4 +15,4 @@ description: "Bootstrap AI instructions by inferring project details and customi
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/bootstrap.md
18
+ Read and follow `.claude/prompt-snippets/bootstrap.md` before executing this command.
@@ -11,6 +11,6 @@ description: "Commit and push changes with conventional commit messages"
11
11
 
12
12
  Commit and push changes using conventional commit format.
13
13
 
14
- @.claude/prompt-snippets/commit-push.md
14
+ Read and follow `.claude/prompt-snippets/commit-push.md` before executing this command.
15
15
 
16
16
  $ARGUMENTS
@@ -15,4 +15,4 @@ description: "Create or update the project constitution defining core principles
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/constitution.md
18
+ Read and follow `.claude/prompt-snippets/constitution.md` before executing this command.
@@ -13,4 +13,4 @@ description: "Create a new agent skill following VS Code and agentskills.io spec
13
13
 
14
14
  $ARGUMENTS
15
15
 
16
- @.claude/prompt-snippets/create-skill.md
16
+ Read and follow `.claude/prompt-snippets/create-skill.md` before executing this command.
@@ -10,15 +10,15 @@ description: "Run an opt-in factory job: intake, spec and plan gates, build in a
10
10
 
11
11
  | Agent | When to use |
12
12
  |-------|-------------|
13
- | `factory-spec-writer` | Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md` |
14
- | `factory-builder` | Build, repair, and rework: writes `build.md` in the job folder; edits code at the build location |
15
- | `factory-reviewer-code` | Review round, `code` lens |
16
- | `factory-reviewer-security` | Review round, `security` lens |
17
- | `factory-reviewer-ux` | Review round, `ux` lens (opt-in) |
18
- | `factory-reviewer-ui` | Review round, `ui` lens (opt-in) |
19
- | `factory-approver` | Approval gate: writes `decision.md` |
13
+ | `planner` | Spec writer. Spec stage (`spec` mode) writes `spec.md`; plan stage (`plan` mode) writes `plan.md` and `tasks.md`. Brief: `.agents/skills/factory/roles/spec.md` |
14
+ | `implementer` | Builder. Build, repair, and rework: writes `build.md` in the job folder; edits code at the build location. Brief: `.agents/skills/factory/roles/build.md` |
15
+ | `reviewer` | Code reviewer. Review round, `code` lens. Brief: `.agents/skills/factory/roles/review-code.md` |
16
+ | `reviewer` | Security reviewer, fresh context. Review round, `security` lens. Brief: `.agents/skills/factory/roles/review-security.md` |
17
+ | `reviewer` | UX reviewer. Review round, `ux` lens (opt-in). Brief: `.agents/skills/factory/roles/review-ux.md` |
18
+ | `reviewer` | UI reviewer. Review round, `ui` lens (opt-in). Brief: `.agents/skills/factory/roles/review-ui.md` |
19
+ | `reviewer` | Approver, fresh context. Approval gate: returns the decision, which the orchestrator saves as `decision.md`. Brief: `.agents/skills/factory/roles/approve.md` |
20
20
 
21
- Dispatch each agent by its kebab-case name, as in the first column. Copilot may show a display name; pick the agent with that name.
21
+ Dispatch each native agent by the name in the first column, and tell it to read the brief in the last column first. Reviewers and the approver return their report, and the orchestrator saves it. Copilot may show a display name; pick the agent with that name.
22
22
 
23
23
  ## Arguments
24
24
 
@@ -26,4 +26,4 @@ Subcommands: `[--in-place] <feature request>` · `start [--in-place] <request |
26
26
 
27
27
  $ARGUMENTS
28
28
 
29
- @.claude/prompt-snippets/factory.md
29
+ Read and follow `.claude/prompt-snippets/factory.md` before executing this command.
@@ -15,4 +15,4 @@ description: "Implement a feature by completing tasks sequentially"
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/implement-feature.md
18
+ Read and follow `.claude/prompt-snippets/implement-feature.md` before executing this command.
@@ -17,4 +17,4 @@ argument-hint: "bug description or fix requirements"
17
17
 
18
18
  $ARGUMENTS
19
19
 
20
- @.claude/prompt-snippets/implement-fixes.md
20
+ Read and follow `.claude/prompt-snippets/implement-fixes.md` before executing this command.
@@ -15,4 +15,4 @@ description: "Execute implementation tasks from a task list or specification"
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/implement.md
18
+ Read and follow `.claude/prompt-snippets/implement.md` before executing this command.
@@ -15,4 +15,4 @@ description: "Create an implementation plan from a feature specification or requ
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/plan.md
18
+ Read and follow `.claude/prompt-snippets/plan.md` before executing this command.
@@ -13,4 +13,4 @@ description: "Run or create E2E tests using Playwright"
13
13
 
14
14
  $ARGUMENTS
15
15
 
16
- @.claude/prompt-snippets/playwright-test.md
16
+ Read and follow `.claude/prompt-snippets/playwright-test.md` before executing this command.
@@ -7,4 +7,4 @@ description: "Whole-repo audit for over-engineering. Scans entire codebase for w
7
7
  > **Recommended agent:** `oracle`
8
8
  > Whole-repo over-engineering analysis
9
9
 
10
- @.claude/prompt-snippets/ponytail-audit.md
10
+ Read and follow `.claude/prompt-snippets/ponytail-audit.md` before executing this command.
@@ -7,4 +7,4 @@
7
7
  > **Recommended agent:** `fixer`
8
8
  > Debt ledger harvesting
9
9
 
10
- @.claude/prompt-snippets/ponytail-debt.md
10
+ Read and follow `.claude/prompt-snippets/ponytail-debt.md` before executing this command.
@@ -7,4 +7,4 @@
7
7
  > **Recommended agent:** `fixer`
8
8
  > Impact scoreboard display
9
9
 
10
- @.claude/prompt-snippets/ponytail-gain.md
10
+ Read and follow `.claude/prompt-snippets/ponytail-gain.md` before executing this command.
@@ -7,4 +7,4 @@
7
7
  > **Recommended agent:** `fixer`
8
8
  > Quick-reference display
9
9
 
10
- @.claude/prompt-snippets/ponytail-help.md
10
+ Read and follow `.claude/prompt-snippets/ponytail-help.md` before executing this command.
@@ -7,4 +7,4 @@
7
7
  > **Recommended agent:** `oracle`
8
8
  > Diff-level over-engineering review
9
9
 
10
- @.claude/prompt-snippets/ponytail-review.md
10
+ Read and follow `.claude/prompt-snippets/ponytail-review.md` before executing this command.
@@ -7,4 +7,4 @@ description: "Forces the laziest solution that actually works — YAGNI, stdlib,
7
7
  > **Recommended agent:** `fixer`
8
8
  > Apply YAGNI/stdlib discipline
9
9
 
10
- @.claude/prompt-snippets/ponytail.md
10
+ Read and follow `.claude/prompt-snippets/ponytail.md` before executing this command.
@@ -13,4 +13,4 @@ description: "Generate release notes from git commits (web, git tag, or document
13
13
 
14
14
  $ARGUMENTS
15
15
 
16
- @.claude/prompt-snippets/release-notes.md
16
+ Read and follow `.claude/prompt-snippets/release-notes.md` before executing this command.
@@ -13,6 +13,6 @@ description: "Review pull request for code quality and best practices"
13
13
 
14
14
  Conduct comprehensive code review for pull requests.
15
15
 
16
- @.claude/prompt-snippets/review-pr.md
16
+ Read and follow `.claude/prompt-snippets/review-pr.md` before executing this command.
17
17
 
18
18
  $ARGUMENTS
@@ -13,6 +13,6 @@ description: "Review code for quality, consistency, and adherence to project pat
13
13
 
14
14
  Review code for quality, security, and adherence to project patterns.
15
15
 
16
- @.claude/prompt-snippets/review.md
16
+ Read and follow `.claude/prompt-snippets/review.md` before executing this command.
17
17
 
18
18
  $ARGUMENTS
@@ -15,4 +15,4 @@ description: "Create a feature specification from a natural language description
15
15
 
16
16
  $ARGUMENTS
17
17
 
18
- @.claude/prompt-snippets/specify.md
18
+ Read and follow `.claude/prompt-snippets/specify.md` before executing this command.
@@ -13,4 +13,4 @@ description: "Generate an actionable task list from a specification or plan"
13
13
 
14
14
  $ARGUMENTS
15
15
 
16
- @.claude/prompt-snippets/tasks.md
16
+ Read and follow `.claude/prompt-snippets/tasks.md` before executing this command.
@@ -11,8 +11,7 @@
11
11
  ],
12
12
  "plugins": [
13
13
  "opencode-mem",
14
- "@tarquinen/opencode-dcp@latest",
15
- "@dietrichgebert/ponytail@4.12.0"
14
+ "@tarquinen/opencode-dcp@latest"
16
15
  // "opentmux": V1-only; enable only after it supports V2.
17
16
  ],
18
17
  "lsp": true
@@ -2,7 +2,7 @@
2
2
 
3
3
  Agent conduct and clarification rules for ambiguous requirements.
4
4
 
5
- @.claude/rules-snippets/agent-conduct.md
5
+ Read and follow `.claude/rules-snippets/agent-conduct.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  API and server-side development standards.
4
4
 
5
- @.claude/rules-snippets/api-server.md
5
+ Read and follow `.claude/rules-snippets/api-server.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Coding standards and language conventions.
4
4
 
5
- @.claude/rules-snippets/coding-standards.md
5
+ Read and follow `.claude/rules-snippets/coding-standards.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Component structure and composition patterns.
4
4
 
5
- @.claude/rules-snippets/component-structure.md
5
+ Read and follow `.claude/rules-snippets/component-structure.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Core library and framework usage conventions.
4
4
 
5
- @.claude/rules-snippets/core-libraries.md
5
+ Read and follow `.claude/rules-snippets/core-libraries.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Environment and tooling configuration.
4
4
 
5
- @.claude/rules-snippets/environment-tooling.md
5
+ Read and follow `.claude/rules-snippets/environment-tooling.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Logging identifiers and code comment conventions.
4
4
 
5
- @.claude/rules-snippets/logging-comments.md
5
+ Read and follow `.claude/rules-snippets/logging-comments.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Structured logging standards and best practices.
4
4
 
5
- @.claude/rules-snippets/logging.md
5
+ Read and follow `.claude/rules-snippets/logging.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Database migration and schema management.
4
4
 
5
- @.claude/rules-snippets/prisma-migrations.md
5
+ Read and follow `.claude/rules-snippets/prisma-migrations.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Project context and documentation references.
4
4
 
5
- @.claude/rules-snippets/project-context.md
5
+ Read and follow `.claude/rules-snippets/project-context.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Server and client code boundary enforcement.
4
4
 
5
- @.claude/rules-snippets/server-client-separation.md
5
+ Read and follow `.claude/rules-snippets/server-client-separation.md` when these standards apply.
6
6
 
7
7
  ## Key points
8
8