nitm-ai-dev-toolkit 5.0.1 → 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 (132) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +4 -4
  3. package/bin/cli.js +38 -1
  4. package/package.json +1 -1
  5. package/src/monorepo/.agents/skills/factory/SKILL.md +48 -32
  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/factory.md +8 -8
  17. package/src/monorepo/.claude/prompt-snippets/bootstrap-patch.md +2 -2
  18. package/src/monorepo/.claude/prompt-snippets/bootstrap-upgrade.md +2 -2
  19. package/src/monorepo/.claude/prompt-snippets/bootstrap.md +2 -2
  20. package/src/monorepo/.claude/prompt-snippets/factory.md +2 -2
  21. package/src/monorepo/.cursor/commands/factory.md +8 -8
  22. package/src/monorepo/.github/prompts/factory.prompt.md +8 -8
  23. package/src/monorepo/.opencode/agents/admin-portal.md +0 -3
  24. package/src/monorepo/.opencode/agents/api-specialist.md +0 -3
  25. package/src/monorepo/.opencode/agents/backend-architect.md +0 -3
  26. package/src/monorepo/.opencode/agents/documenter.md +0 -3
  27. package/src/monorepo/.opencode/agents/feature-builder.md +0 -3
  28. package/src/monorepo/.opencode/agents/frontend-developer.md +0 -3
  29. package/src/monorepo/.opencode/agents/green.md +0 -3
  30. package/src/monorepo/.opencode/agents/implementer.md +0 -3
  31. package/src/monorepo/.opencode/agents/planner.md +0 -3
  32. package/src/monorepo/.opencode/agents/red.md +0 -3
  33. package/src/monorepo/.opencode/agents/refactor.md +0 -3
  34. package/src/monorepo/.opencode/agents/researcher.md +0 -3
  35. package/src/monorepo/.opencode/agents/reviewer.md +0 -3
  36. package/src/monorepo/.opencode/agents/tdd.md +0 -3
  37. package/src/monorepo/.opencode/commands/factory.md +9 -9
  38. package/src/monorepo/AGENTS.md +3 -3
  39. package/src/monorepo/README.md +2 -2
  40. package/src/monorepo/factory/README.md +12 -10
  41. package/src/repo/.agents/skills/factory/SKILL.md +48 -32
  42. package/src/repo/{.claude/agents-snippets/factory-approver.md → .agents/skills/factory/roles/approve.md} +3 -3
  43. package/src/repo/{.claude/agents-snippets/factory-builder.md → .agents/skills/factory/roles/build.md} +3 -3
  44. package/src/repo/{.claude/agents-snippets/factory-reviewer-code.md → .agents/skills/factory/roles/review-code.md} +5 -5
  45. package/src/{monorepo/.claude/agents-snippets/factory-reviewer-security.md → repo/.agents/skills/factory/roles/review-security.md} +4 -4
  46. package/src/repo/{.claude/agents-snippets/factory-reviewer-ui.md → .agents/skills/factory/roles/review-ui.md} +6 -6
  47. package/src/repo/{.claude/agents-snippets/factory-reviewer-ux.md → .agents/skills/factory/roles/review-ux.md} +6 -6
  48. package/src/repo/{.claude/agents-snippets/factory-spec-writer.md → .agents/skills/factory/roles/spec.md} +2 -2
  49. package/src/repo/.claude/agents/implementer.agent.md +1 -1
  50. package/src/repo/.claude/agents/planner.agent.md +1 -1
  51. package/src/repo/.claude/agents/reviewer.agent.md +1 -1
  52. package/src/repo/.claude/commands/factory.md +8 -8
  53. package/src/repo/.claude/prompt-snippets/bootstrap-patch.md +2 -2
  54. package/src/repo/.claude/prompt-snippets/bootstrap-upgrade.md +2 -2
  55. package/src/repo/.claude/prompt-snippets/bootstrap.md +2 -2
  56. package/src/repo/.claude/prompt-snippets/factory.md +2 -2
  57. package/src/repo/.cursor/commands/factory.md +8 -8
  58. package/src/repo/.github/prompts/factory.prompt.md +8 -8
  59. package/src/repo/.opencode/agents/admin-portal.md +0 -3
  60. package/src/repo/.opencode/agents/api-specialist.md +0 -3
  61. package/src/repo/.opencode/agents/backend-architect.md +0 -3
  62. package/src/repo/.opencode/agents/documenter.md +0 -3
  63. package/src/repo/.opencode/agents/feature-builder.md +0 -3
  64. package/src/repo/.opencode/agents/frontend-developer.md +0 -3
  65. package/src/repo/.opencode/agents/green.md +0 -3
  66. package/src/repo/.opencode/agents/implementer.md +0 -3
  67. package/src/repo/.opencode/agents/planner.md +0 -3
  68. package/src/repo/.opencode/agents/red.md +0 -3
  69. package/src/repo/.opencode/agents/refactor.md +0 -3
  70. package/src/repo/.opencode/agents/researcher.md +0 -3
  71. package/src/repo/.opencode/agents/reviewer.md +0 -3
  72. package/src/repo/.opencode/agents/tdd.md +0 -3
  73. package/src/repo/.opencode/commands/factory.md +9 -9
  74. package/src/repo/AGENTS.md +3 -3
  75. package/src/repo/README.md +2 -2
  76. package/src/repo/factory/README.md +12 -10
  77. package/src/monorepo/.claude/agents/factory-approver.agent.md +0 -12
  78. package/src/monorepo/.claude/agents/factory-builder.agent.md +0 -12
  79. package/src/monorepo/.claude/agents/factory-reviewer-code.agent.md +0 -12
  80. package/src/monorepo/.claude/agents/factory-reviewer-security.agent.md +0 -12
  81. package/src/monorepo/.claude/agents/factory-reviewer-ui.agent.md +0 -12
  82. package/src/monorepo/.claude/agents/factory-reviewer-ux.agent.md +0 -12
  83. package/src/monorepo/.claude/agents/factory-spec-writer.agent.md +0 -12
  84. package/src/monorepo/.cursor/agents/factory-approver.agent.md +0 -11
  85. package/src/monorepo/.cursor/agents/factory-builder.agent.md +0 -11
  86. package/src/monorepo/.cursor/agents/factory-reviewer-code.agent.md +0 -11
  87. package/src/monorepo/.cursor/agents/factory-reviewer-security.agent.md +0 -11
  88. package/src/monorepo/.cursor/agents/factory-reviewer-ui.agent.md +0 -11
  89. package/src/monorepo/.cursor/agents/factory-reviewer-ux.agent.md +0 -11
  90. package/src/monorepo/.cursor/agents/factory-spec-writer.agent.md +0 -11
  91. package/src/monorepo/.github/agents/factory-approver.agent.md +0 -11
  92. package/src/monorepo/.github/agents/factory-builder.agent.md +0 -11
  93. package/src/monorepo/.github/agents/factory-reviewer-code.agent.md +0 -11
  94. package/src/monorepo/.github/agents/factory-reviewer-security.agent.md +0 -11
  95. package/src/monorepo/.github/agents/factory-reviewer-ui.agent.md +0 -11
  96. package/src/monorepo/.github/agents/factory-reviewer-ux.agent.md +0 -11
  97. package/src/monorepo/.github/agents/factory-spec-writer.agent.md +0 -11
  98. package/src/monorepo/.opencode/agents/factory-approver.md +0 -20
  99. package/src/monorepo/.opencode/agents/factory-builder.md +0 -20
  100. package/src/monorepo/.opencode/agents/factory-reviewer-code.md +0 -20
  101. package/src/monorepo/.opencode/agents/factory-reviewer-security.md +0 -20
  102. package/src/monorepo/.opencode/agents/factory-reviewer-ui.md +0 -20
  103. package/src/monorepo/.opencode/agents/factory-reviewer-ux.md +0 -20
  104. package/src/monorepo/.opencode/agents/factory-spec-writer.md +0 -20
  105. package/src/repo/.claude/agents/factory-approver.agent.md +0 -12
  106. package/src/repo/.claude/agents/factory-builder.agent.md +0 -12
  107. package/src/repo/.claude/agents/factory-reviewer-code.agent.md +0 -12
  108. package/src/repo/.claude/agents/factory-reviewer-security.agent.md +0 -12
  109. package/src/repo/.claude/agents/factory-reviewer-ui.agent.md +0 -12
  110. package/src/repo/.claude/agents/factory-reviewer-ux.agent.md +0 -12
  111. package/src/repo/.claude/agents/factory-spec-writer.agent.md +0 -12
  112. package/src/repo/.cursor/agents/factory-approver.agent.md +0 -11
  113. package/src/repo/.cursor/agents/factory-builder.agent.md +0 -11
  114. package/src/repo/.cursor/agents/factory-reviewer-code.agent.md +0 -11
  115. package/src/repo/.cursor/agents/factory-reviewer-security.agent.md +0 -11
  116. package/src/repo/.cursor/agents/factory-reviewer-ui.agent.md +0 -11
  117. package/src/repo/.cursor/agents/factory-reviewer-ux.agent.md +0 -11
  118. package/src/repo/.cursor/agents/factory-spec-writer.agent.md +0 -11
  119. package/src/repo/.github/agents/factory-approver.agent.md +0 -11
  120. package/src/repo/.github/agents/factory-builder.agent.md +0 -11
  121. package/src/repo/.github/agents/factory-reviewer-code.agent.md +0 -11
  122. package/src/repo/.github/agents/factory-reviewer-security.agent.md +0 -11
  123. package/src/repo/.github/agents/factory-reviewer-ui.agent.md +0 -11
  124. package/src/repo/.github/agents/factory-reviewer-ux.agent.md +0 -11
  125. package/src/repo/.github/agents/factory-spec-writer.agent.md +0 -11
  126. package/src/repo/.opencode/agents/factory-approver.md +0 -20
  127. package/src/repo/.opencode/agents/factory-builder.md +0 -20
  128. package/src/repo/.opencode/agents/factory-reviewer-code.md +0 -20
  129. package/src/repo/.opencode/agents/factory-reviewer-security.md +0 -20
  130. package/src/repo/.opencode/agents/factory-reviewer-ui.md +0 -20
  131. package/src/repo/.opencode/agents/factory-reviewer-ux.md +0 -20
  132. package/src/repo/.opencode/agents/factory-spec-writer.md +0 -20
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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: "*"
@@ -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` |
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.
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
+
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
 
@@ -94,9 +94,9 @@ When stopping to ask a question, do not just post an open-ended block of text. F
94
94
 
95
95
  OpenCode use with toolkit 4.0.0 and later requires native V2; Slim >=3.0.0 requires OpenCode >=2.0.7. Read [native setup](README.md#native-opencode-v2) before migration. All bootstrap flows run `opencode --version` before changes for confirmed OpenCode use: V1 must stop and upgrade OpenCode or remain on toolkit 3.x; missing/unparseable versions block OpenCode steps and marking the installed toolkit version (4.0.0 or later). Directory presence is not harness proof; other-harness-only setup is unaffected.
96
96
 
97
- Use `agents`/`system`, `request.body.temperature`, ordered `permissions` (`action`/`resource`/`effect`, `shell`/`subagent`), `commands`, `plugins`, directory-based `skills`, and `mcp.servers`. Preserve user models/providers/plugins and Slim's separate strict schema; do not host-migrate its `prompt`/`permission`/`variant` fields or silently upgrade the separate external starter. The OpenCode Ponytail plugin (`@dietrichgebert/ponytail`) is installed globally by the operator; the toolkit does not register it. Bootstrap may check for it and tell the operator to install it globally, but must never add it to project config. `opentmux` stays commented as V1-only. Remove only known obsolete toolkit Ponytail `.js`/`.mjs`/`.ts` copies after backup and approval, and preserve unrelated local plugins. No local API port or bridge is used; plugin/runtime integration is untested. The Claude Code hooks in `hooks/*.json` use `${CLAUDE_PLUGIN_ROOT}` and are plugin-only: they fire only when installed through the Ponytail plugin, not from project settings.
97
+ Use `agents`/`system`, ordered `permissions` (`action`/`resource`/`effect`, `shell`/`subagent`), `commands`, `plugins`, directory-based `skills`, and `mcp.servers`. Preserve user models/providers/plugins and Slim's separate strict schema; do not host-migrate its `prompt`/`permission`/`variant` fields or silently upgrade the separate external starter. The OpenCode Ponytail plugin (`@dietrichgebert/ponytail`) is installed globally by the operator; the toolkit does not register it. Bootstrap may check for it and tell the operator to install it globally, but must never add it to project config. `opentmux` stays commented as V1-only. Remove only known obsolete toolkit Ponytail `.js`/`.mjs`/`.ts` copies after backup and approval, and preserve unrelated local plugins. No local API port or bridge is used; plugin/runtime integration is untested. The Claude Code hooks in `hooks/*.json` use `${CLAUDE_PLUGIN_ROOT}` and are plugin-only: they fire only when installed through the Ponytail plugin, not from project settings.
98
98
 
99
- Ambient `AGENTS.md` works. Config `instructions` entries load only when the runtime injects them (OpenChamber does; other hosts may not), so do not rely on them: write explicit "Read and follow" wrappers regardless. `@refs` are ordinary text: explicitly read linked snippets. `request.body.temperature` remains in config, but the current runner does not send it. Preserve `lsp: true`; use project lint/typecheck/compiler commands, not unavailable V2 LSP diagnostics. Back up V1 before native conversion; converted files are incompatible with V1. Activate on the next run/restart.
99
+ Ambient `AGENTS.md` works. Config `instructions` entries load only when the runtime injects them (OpenChamber does; other hosts may not), so do not rely on them: write explicit "Read and follow" wrappers regardless. `@refs` are ordinary text: explicitly read linked snippets. Do not set a temperature; the current runner does not send one. Preserve `lsp: true`; use project lint/typecheck/compiler commands, not unavailable V2 LSP diagnostics. Back up V1 before native conversion; converted files are incompatible with V1. Activate on the next run/restart.
100
100
 
101
101
  ## Detailed Instructions
102
102
 
@@ -381,7 +381,7 @@ Subagents are typically **agent-initiated** — the coordinator decides when to
381
381
 
382
382
  ### Factory (opt-in)
383
383
 
384
- An optional file-driven pipeline for feature-sized work, alongside Feature Builder and TDD. Start it with `/factory <request>` in Claude Code, Copilot, Cursor, or OpenCode. The orchestrator reads the project and asks only the glaring questions before it creates anything, then asks you to continue or change the answers. Resume a feature with `/factory start <KEY | slug | job-id>`. Codex runs the orchestrator skill directly. Each job belongs to a feature folder in `docs/features/`, stops at a spec gate and a plan gate for your confirmation before any ticket or build, builds in its own git worktree unless you ask for `--in-place`, and moves its tickets when the project tracks them. The orchestrator is [.agents/skills/factory/SKILL.md](.agents/skills/factory/SKILL.md). Its seven agents are `factory-spec-writer`, `factory-builder`, `factory-reviewer-code`, `factory-reviewer-security`, `factory-reviewer-ux`, `factory-reviewer-ui`, and `factory-approver`, with wrappers in each harness's agents folder that point to the shared snippets in `.claude/agents-snippets/`. Setup, placeholders, and approval modes are in [factory/README.md](factory/README.md).
384
+ An optional file-driven pipeline for feature-sized work, alongside Feature Builder and TDD. Start it with `/factory <request>` in Claude Code, Copilot, Cursor, or OpenCode. The orchestrator reads the project and asks only the glaring questions before it creates anything, then asks you to continue or change the answers. Resume a feature with `/factory start <KEY | slug | job-id>`. Codex runs the orchestrator skill directly. Each job belongs to a feature folder in `docs/features/`, stops at a spec gate and a plan gate for your confirmation before any ticket or build, builds in its own git worktree unless you ask for `--in-place`, and moves its tickets when the project tracks them. The orchestrator is [.agents/skills/factory/SKILL.md](.agents/skills/factory/SKILL.md). It runs on the native `planner` (spec and plan), `implementer` (build, repair, and rework), and `reviewer` (the code, security, ux, and ui lenses, and approval) agents. Each role's Factory rules are in its brief in `.agents/skills/factory/roles/`. Setup, placeholders, and approval modes are in [factory/README.md](factory/README.md).
385
385
 
386
386
  ## Documentation Requirements
387
387
 
@@ -124,9 +124,9 @@ The template's local `plugins` array registers `opencode-mem` and `@tarquinen/op
124
124
 
125
125
  With approval, merge `"plugins": ["oh-my-opencode-slim@3.0.0"]` locally without replacing other registrations. Slim's separate strict schema retains `prompt`, `permission`, and `variant`; do not host-migrate it. The external starter is a separate package, not automatically upgraded. Plugin/runtime integration has not been tested.
126
126
 
127
- Use native `agents`/`system`, `request.body.temperature`, ordered `permissions` (`action`/`resource`/`effect`, `shell`/`subagent`), `commands`/`subagent`, `plugins` with `{ "package": "…", "options": {} }`, skill-directory arrays, and `mcp.servers` with inverse `disabled` and `timeout.catalog`/`timeout.execution`. Follow the [V2 migration guide](https://opencode.ai/v2/docs/migrate-v1) and [plugin guide](https://opencode.ai/v2/docs/build/plugins); the published schema may describe V1 and is not V2 validation authority.
127
+ Use native `agents`/`system`, ordered `permissions` (`action`/`resource`/`effect`, `shell`/`subagent`), `commands`/`subagent`, `plugins` with `{ "package": "…", "options": {} }`, skill-directory arrays, and `mcp.servers` with inverse `disabled` and `timeout.catalog`/`timeout.execution`. Follow the [V2 migration guide](https://opencode.ai/v2/docs/migrate-v1) and [plugin guide](https://opencode.ai/v2/docs/build/plugins); the published schema may describe V1 and is not V2 validation authority.
128
128
 
129
- Ambient `AGENTS.md` works. Config `instructions` entries load only when the runtime injects them (OpenChamber does; other hosts may not), so do not rely on them: write explicit "Read and follow" wrappers regardless. `@refs` are ordinary text: read linked snippets explicitly. `request.body.temperature` remains in config, but the current runner does not send it. Preserve `lsp: true`; use project lint/typecheck/compiler commands (no V2 LSP tools/diagnostics currently).
129
+ Ambient `AGENTS.md` works. Config `instructions` entries load only when the runtime injects them (OpenChamber does; other hosts may not), so do not rely on them: write explicit "Read and follow" wrappers regardless. `@refs` are ordinary text: read linked snippets explicitly. Do not set a temperature; the current runner does not send one. Preserve `lsp: true`; use project lint/typecheck/compiler commands (no V2 LSP tools/diagnostics currently).
130
130
 
131
131
  `--env opencode` supplies minimal shared references without activating other harnesses. Back up V1, merge rather than clobber models/providers/plugins, and activate on the next run/restart. Native-converted files are incompatible with V1. Verify with installed V2; `doctor` is not runtime validation.
132
132
 
@@ -4,14 +4,14 @@ A file-driven pipeline for feature-sized work. One orchestrator session runs a f
4
4
 
5
5
  The factory is **opt-in**. It sits alongside Feature Builder and TDD and changes nothing they do. Nothing runs until you invoke `/factory`. Quick fixes stay direct.
6
6
 
7
- Orchestrator: [.agents/skills/factory/SKILL.md](../.agents/skills/factory/SKILL.md). Its agents have wrappers in `.claude/agents/`, `.github/agents/`, `.cursor/agents/`, and `.opencode/agents/`. See [Harnesses](#harnesses).
7
+ Orchestrator: [.agents/skills/factory/SKILL.md](../.agents/skills/factory/SKILL.md). It runs on the native `planner`, `implementer`, and `reviewer` agents, and its role briefs live in `.agents/skills/factory/roles/`. See [Harnesses](#harnesses).
8
8
 
9
9
  ## Install
10
10
 
11
11
  1. **Install it.** The toolkit installer copies this folder into your project root as `factory/`.
12
12
  2. **Document your commands in `AGENTS.md`.** Agents read setup, dev, test, lint, and build commands from there, and the dev command must document how to pass a port (a flag or an env var). Without them the factory stops and asks you. Edit `factory/worktree-bootstrap.md` for the setup each new worktree needs (see Build location).
13
- 3. **Replace the placeholders** below in `.agents/skills/factory/SKILL.md` and `.claude/agents-snippets/factory-*.md`. Bootstrap does this when it runs.
14
- 4. **Commit** `factory/README.md`, `factory/.gitignore`, and the factory agents and skill. Runtime state is ignored (see Layout). Feature docs in the feature folders are committed with the code.
13
+ 3. **Replace the placeholders** below in `.agents/skills/factory/SKILL.md` and `.agents/skills/factory/roles/*.md`. Bootstrap does this when it runs.
14
+ 4. **Commit** `factory/README.md`, `factory/.gitignore`, and the factory skill with its role briefs. Runtime state is ignored (see Layout). Feature docs in the feature folders are committed with the code.
15
15
  5. **Run it** from your harness: `/factory <feature request>` to start from a request, or `/factory start <KEY | slug | job-id>` to pick up an existing feature. See [Harnesses](#harnesses) for each entry point.
16
16
 
17
17
  ## Placeholders
@@ -47,15 +47,17 @@ There is no queue. Start each feature with a request, a ticket key, or a slug.
47
47
 
48
48
  ## Harnesses
49
49
 
50
- The orchestrator and agents are the same in every harness. Each harness has its own entry point and agent wrappers. Every wrapper points to the shared snippets in `.claude/agents-snippets/`.
50
+ The orchestrator and agents are the same in every harness. Each harness has its own entry point. Every role runs on a native agent: `planner` for the spec writer, `implementer` for the builder, and `reviewer` for each review lens and the approver, with the lens or approval mode named in the dispatch. The role briefs in `.agents/skills/factory/roles/` hold the Factory rules.
51
51
 
52
- | Harness | Entry point | Agent wrappers |
52
+ | Harness | Entry point | Native agents |
53
53
  | --- | --- | --- |
54
54
  | Claude Code | `/factory` (`.claude/commands/factory.md`) | `.claude/agents/` |
55
55
  | GitHub Copilot | `/factory` prompt (`.github/prompts/factory.prompt.md`) | `.github/agents/` |
56
56
  | Cursor | `/factory` (`.cursor/commands/factory.md`) | `.cursor/agents/` |
57
57
  | OpenCode | `/factory` (`.opencode/commands/factory.md`) | `.opencode/agents/` |
58
- | Codex | The factory skill (`.agents/skills/factory/SKILL.md`) | None. Runs the snippets directly, one role at a time in one session (see Harness notes in SKILL.md) |
58
+ | Codex | The factory skill (`.agents/skills/factory/SKILL.md`) | None. Runs each role brief directly, one role at a time in one session (see Harness notes in SKILL.md) |
59
+
60
+ In OpenCode with the Slim plugin, `oracle` and `designer` are optional alternatives to `reviewer`, if you configure them as edit-denied. The default is the native agents.
59
61
 
60
62
  ## Feature folders and sizing
61
63
 
@@ -136,15 +138,15 @@ The parent and every sub-task move together. The orchestrator uses the project's
136
138
  ## How a job runs
137
139
 
138
140
  1. **Intake.** For `/factory <request>`, the orchestrator reads the project and asks only the glaring questions. You answer them, then choose to continue or change the answers. Nothing is created before you continue.
139
- 2. **Spec.** `factory-spec-writer` inspects the code and writes `spec.md` with numbered acceptance criteria.
141
+ 2. **Spec.** `planner` (spec mode) inspects the code and writes `spec.md` with numbered acceptance criteria.
140
142
  3. **Spec gate.** You confirm the spec, or request changes.
141
- 4. **Plan.** `factory-spec-writer` in plan mode writes `plan.md` (with the size) and `tasks.md` for large work.
143
+ 4. **Plan.** `planner` in plan mode writes `plan.md` (with the size) and `tasks.md` for large work.
142
144
  5. **Plan gate.** You confirm the plan, or request changes. Nothing is ticketed or built before you confirm.
143
145
  6. **Tickets and build location.** If tracked, the parent and sub-tasks are created and their keys are written into `tasks.md`. The folder is renamed to carry the key. Then a builder gets its own git worktree on branch `factory/<id>` (bootstrapped first, see Build location), or the in-place branch. The job's feature docs are committed on that branch.
144
146
  7. **Build.** The builder follows TDD, ticks `tasks.md` as it completes tasks, writes `build.md`, and writes `qa.md`.
145
- 8. **Review.** Every configured lens reviews the branch, writing `round-N/review-<lens>.md` with `VERDICT: PASS` or `VERDICT: CHANGES`.
147
+ 8. **Review.** Every configured lens reviews the branch, and each reviewer's report is saved as `round-N/review-<lens>.md` with `VERDICT: PASS` or `VERDICT: CHANGES`.
146
148
  9. **Repair.** Any `CHANGES` sends the builder back to fix it. Two repairs at most, so three review rounds. Then the job escalates to you.
147
- 10. **Approve.** `factory-approver` writes `decision.md` with `APPROVE` or `ESCALATE`.
149
+ 10. **Approve.** `reviewer` in approval mode (fresh context) returns `APPROVE` or `ESCALATE`, and the orchestrator writes it to `decision.md`.
148
150
  11. **Merge.** `local` mode: local only, never pushed. `push-mr` mode: push and open the request, then finish on the second approve (see Merge modes). `--no-ff` merge, the project's test command, then the worktree (if any) and branch are removed. Feature docs in the main checkout are set aside first (copies in `main-copies/`), so the merge brings in the branch's committed copies.
149
151
 
150
152
  Jobs that escalate (`needs-human`) keep their branch and worktree so you can inspect them. Use `/factory rework` or `/factory approve` to continue.
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-approver"
3
- description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Approver Agent
9
-
10
- Decide whether a factory job is approved for merge or escalated to a human.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../agents-snippets/factory-approver.md)
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-builder"
3
- description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md. Runs in build, repair, or rework mode. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Edit", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Builder Agent
9
-
10
- Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../agents-snippets/factory-builder.md)
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-reviewer-code"
3
- description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Reviewer (Code) Agent
9
-
10
- Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../agents-snippets/factory-reviewer-code.md)
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-reviewer-security"
3
- description: "Audit a factory job's branch diff for security problems in a fresh context. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Reviewer (Security) Agent
9
-
10
- Audit a factory job's branch diff for security problems in a fresh context.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../agents-snippets/factory-reviewer-security.md)
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-reviewer-ui"
3
- description: "Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Reviewer (UI) Agent
9
-
10
- Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../agents-snippets/factory-reviewer-ui.md)
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-reviewer-ux"
3
- description: "Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Reviewer (UX) Agent
9
-
10
- Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../agents-snippets/factory-reviewer-ux.md)
@@ -1,12 +0,0 @@
1
- ---
2
- name: "factory-spec-writer"
3
- description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code. Dispatched by the factory orchestrator."
4
- tools: ["Read", "Grep", "Glob", "Write", "Bash(*)"]
5
- user-invocable: true
6
- ---
7
-
8
- # Factory Spec Writer Agent
9
-
10
- Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
11
-
12
- **CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../agents-snippets/factory-spec-writer.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Approver Agent
8
-
9
- Decide whether a factory job is approved for merge or escalated to a human.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../../.claude/agents-snippets/factory-approver.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Builder Agent
8
-
9
- Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../../.claude/agents-snippets/factory-builder.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Reviewer (Code) Agent
8
-
9
- Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../../.claude/agents-snippets/factory-reviewer-code.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Audit a factory job's branch diff for security problems in a fresh context."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Reviewer (Security) Agent
8
-
9
- Audit a factory job's branch diff for security problems in a fresh context.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../../.claude/agents-snippets/factory-reviewer-security.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Reviewer (UI) Agent
8
-
9
- Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../../.claude/agents-snippets/factory-reviewer-ui.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Reviewer (UX) Agent
8
-
9
- Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../../.claude/agents-snippets/factory-reviewer-ux.md)
@@ -1,11 +0,0 @@
1
- ---
2
- description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code."
3
- globs:
4
- alwaysApply: agent
5
- ---
6
-
7
- # Factory Spec Writer Agent
8
-
9
- Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../../.claude/agents-snippets/factory-spec-writer.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Approver
3
- description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Approver Agent
8
-
9
- Decide whether a factory job is approved for merge or escalated to a human.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-approver.md](../../.claude/agents-snippets/factory-approver.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Builder
3
- description: "Build a factory job's feature inside its git worktree, following TDD, and log results in build.md. Runs in build, repair, or rework mode. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Builder Agent
8
-
9
- Build a factory job's feature inside its git worktree, following TDD, and log results in build.md.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-builder.md](../../.claude/agents-snippets/factory-builder.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Reviewer Code
3
- description: "Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Reviewer (Code) Agent
8
-
9
- Review a factory job's branch for correctness, simplicity, reuse, conventions, and docs, and run the project's checks.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-code.md](../../.claude/agents-snippets/factory-reviewer-code.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Reviewer Security
3
- description: "Audit a factory job's branch diff for security problems in a fresh context. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Reviewer (Security) Agent
8
-
9
- Audit a factory job's branch diff for security problems in a fresh context.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-security.md](../../.claude/agents-snippets/factory-reviewer-security.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Reviewer UI
3
- description: "Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Reviewer (UI) Agent
8
-
9
- Review a factory job's feature at its build location for design-system consistency, spacing, typography, contrast, and responsive layout, without signing in or writing to real services.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ui.md](../../.claude/agents-snippets/factory-reviewer-ui.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Reviewer UX
3
- description: "Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Reviewer (UX) Agent
8
-
9
- Review a factory job's feature at its build location for flows, states, copy, accessibility, and mobile, without signing in or writing to real services.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-reviewer-ux.md](../../.claude/agents-snippets/factory-reviewer-ux.md)
@@ -1,11 +0,0 @@
1
- ---
2
- name: Factory Spec Writer
3
- description: "Write a testable spec.md for a factory job from a feature request, after inspecting the real code. Dispatched by the factory orchestrator."
4
- tools: ["read", "search", "edit", "runInTerminal", "terminalLastCommand"]
5
- ---
6
-
7
- # Factory Spec Writer Agent
8
-
9
- Write a testable spec.md for a factory job from a feature request, after inspecting the real code.
10
-
11
- **CRITICAL: READ:** [.claude/agents-snippets/factory-spec-writer.md](../../.claude/agents-snippets/factory-spec-writer.md)
@@ -1,20 +0,0 @@
1
- ---
2
- description: "Decide whether a factory job is approved for merge or escalated to a human, checking history, final diff, a spot-checked criterion, a dry-run merge, and escalation triggers. Dispatched by the factory orchestrator."
3
- mode: subagent
4
- request:
5
- body:
6
- temperature: 0.1
7
- permissions:
8
- - action: edit
9
- resource: "*"
10
- effect: allow
11
- - action: shell
12
- resource: "*"
13
- effect: allow
14
- ---
15
-
16
- # Factory Approver Agent
17
-
18
- Decide whether a factory job is approved for merge or escalated to a human.
19
-
20
- Read and follow `.claude/agents-snippets/factory-approver.md` before performing this role.