@syntesseraai/opencode-feature-factory 0.12.1 → 0.12.3
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.
- package/AGENTS.md +5 -5
- package/README.md +9 -5
- package/agents/feature-factory.md +24 -18
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -5,11 +5,11 @@ This file is installed to `~/.config/opencode/AGENTS.md` by `@syntesseraai/openc
|
|
|
5
5
|
## What Feature Factory Provides
|
|
6
6
|
|
|
7
7
|
- Native workflow orchestration through the `feature-factory` agent.
|
|
8
|
-
- Default orchestrator model: `feature-factory` -> `
|
|
8
|
+
- Default orchestrator model: `feature-factory` -> `openai/gpt-5.4-fast`
|
|
9
9
|
- Stage sub-agents with default model routing:
|
|
10
|
-
- `planning` -> `openai/gpt-5.4`
|
|
11
|
-
- `building` -> `openai/gpt-5.
|
|
12
|
-
- `reviewing` -> `opencode/
|
|
10
|
+
- `planning` -> `openai/gpt-5.4-fast`
|
|
11
|
+
- `building` -> `openai/gpt-5.4-fast`
|
|
12
|
+
- `reviewing` -> `opencode/claude-opus-4-7`
|
|
13
13
|
- `documenting` -> `opencode/gemini-3.1-pro`
|
|
14
14
|
- Specialized agents: `feature-factory`, `planning`, `building`, `reviewing`, and `documenting`.
|
|
15
15
|
- Quick commands: `/ff-review [optional prompt]`, `/ff-document [optional prompt]`, and `/ff-rework [optional prompt]` (all run as main agents on the relevant stage).
|
|
@@ -19,7 +19,7 @@ This file is installed to `~/.config/opencode/AGENTS.md` by `@syntesseraai/openc
|
|
|
19
19
|
|
|
20
20
|
1. Clarify requirements and acceptance criteria before coding.
|
|
21
21
|
2. Plan only when no approved planning handoff exists (`PLANNING_GATE=APPROVED` + `FINAL_PLAN`).
|
|
22
|
-
3.
|
|
22
|
+
3. Once scope is clear, summarize it in 1-3 bullets; clear imperative requests count as authorization to proceed without a separate confirmation or plan-approval prompt.
|
|
23
23
|
4. Build.
|
|
24
24
|
5. Document.
|
|
25
25
|
6. Review implementation and documentation gates.
|
package/README.md
CHANGED
|
@@ -58,16 +58,16 @@ The plugin no longer exposes `ff_pipeline`, `ff_mini_loop`, or `ff_list_models`
|
|
|
58
58
|
|
|
59
59
|
Instead, the `feature-factory` primary agent orchestrates workflows natively by delegating to stage sub-agents:
|
|
60
60
|
|
|
61
|
-
- `feature-factory` (orchestrator) -> default model `
|
|
62
|
-
- `planning` -> default model `openai/gpt-5.4`
|
|
63
|
-
- `building` -> default model `openai/gpt-5.
|
|
64
|
-
- `reviewing` -> default model `opencode/
|
|
61
|
+
- `feature-factory` (orchestrator) -> default model `openai/gpt-5.4-fast`
|
|
62
|
+
- `planning` -> default model `openai/gpt-5.4-fast`
|
|
63
|
+
- `building` -> default model `openai/gpt-5.4-fast`
|
|
64
|
+
- `reviewing` -> default model `opencode/claude-opus-4-7`
|
|
65
65
|
- `documenting` -> default model `opencode/gemini-3.1-pro`
|
|
66
66
|
|
|
67
67
|
### Fixed execution path
|
|
68
68
|
|
|
69
69
|
1. Plan if needed (or consume approved planning handoff).
|
|
70
|
-
2.
|
|
70
|
+
2. Scope-clear authorization checkpoint; once scope is clear, summarize it in 1-3 bullets, and treat clear imperative requests as authorization to proceed.
|
|
71
71
|
3. Build.
|
|
72
72
|
4. Document.
|
|
73
73
|
5. Review implementation + documentation gates.
|
|
@@ -76,6 +76,10 @@ Instead, the `feature-factory` primary agent orchestrates workflows natively by
|
|
|
76
76
|
|
|
77
77
|
Each transition carries forward normalized prior-stage context (summary, gate/verdict, action items, open issues, and resolved prior output excerpts sourced from previous stage output or existing context) so downstream stages receive full handoff state without unresolved placeholder aliases.
|
|
78
78
|
|
|
79
|
+
When an approved planning handoff already includes `PLANNING_GATE=APPROVED` + `FINAL_PLAN`, the orchestrator proceeds automatically to Build once scope is clear and summarized. It must not ask for a separate scope-clear authorization or plan-approval step, and it must not add a separate “starting now” notice before Build.
|
|
80
|
+
|
|
81
|
+
The same rule applies to imperative follow-on requests derived from prior workflow outputs such as `OPEN_ISSUES`, action items, or non-blocking items: if the instruction is clear, the orchestrator should proceed without an extra approval turn.
|
|
82
|
+
|
|
79
83
|
Writable stage agents (`building`, `documenting`) prefer native `edit` (and `write` for new files) when needed. Read-only agents keep `edit` disabled.
|
|
80
84
|
|
|
81
85
|
Stage-agent code discovery is graph-first: planning/building/reviewing/documenting prefer codebase-memory MCP tools (`codebase-memory-mcp_search_graph`, `codebase-memory-mcp_get_architecture`, `codebase-memory-mcp_trace_call_path`, `codebase-memory-mcp_get_code_snippet`) for repository-local analysis, and use `gh_grep_searchGitHub` when investigating public GitHub source examples.
|
|
@@ -75,13 +75,14 @@ When workflow scope changes behavior, workflows, commands, configuration, or rep
|
|
|
75
75
|
|
|
76
76
|
---
|
|
77
77
|
|
|
78
|
-
## Step 1: Understand and
|
|
78
|
+
## Step 1: Understand requirements and determine authorization
|
|
79
79
|
|
|
80
|
-
Work through the user's request in a
|
|
80
|
+
Work through the user's request in a scope-first manner:
|
|
81
81
|
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
82
|
+
- If scope, constraints, or acceptance criteria are ambiguous, ask focused clarifying questions.
|
|
83
|
+
- Once scope is clear, summarize your understanding in 1-3 bullets.
|
|
84
|
+
- Treat a clear imperative implementation request as authorization to proceed; do not ask for a separate confirmation or "should I start" prompt.
|
|
85
|
+
- Apply the same authorization rule to follow-on imperative requests derived from prior workflow outputs such as `OPEN_ISSUES`, action items, or non-blocking follow-ups.
|
|
85
86
|
|
|
86
87
|
If no request is provided, ask what they want to build.
|
|
87
88
|
|
|
@@ -92,9 +93,10 @@ If the user arrives with an approved planning output that includes both `PLANNIN
|
|
|
92
93
|
In this handoff mode:
|
|
93
94
|
|
|
94
95
|
1. Do not force the user back through planning.
|
|
95
|
-
2.
|
|
96
|
-
3.
|
|
97
|
-
4.
|
|
96
|
+
2. Summarize the plan scope in 1-3 bullets for traceability.
|
|
97
|
+
3. Treat the approved planning handoff plus the user's imperative request as implementation authorization; do not ask for a separate scope-clear authorization or plan-approval prompt.
|
|
98
|
+
4. Start workflow execution at the first build step immediately after the scoped summary, using `FINAL_PLAN` as primary input.
|
|
99
|
+
5. Preserve original planning risk/testing assumptions in downstream handoffs.
|
|
98
100
|
|
|
99
101
|
---
|
|
100
102
|
|
|
@@ -103,7 +105,7 @@ In this handoff mode:
|
|
|
103
105
|
Use one fixed workflow only:
|
|
104
106
|
|
|
105
107
|
1. Plan if no approved plan exists.
|
|
106
|
-
2.
|
|
108
|
+
2. Once scope is clear, summarize it in 1-3 bullets; for clear imperative requests, that summary records the scope and counts as authorization to proceed.
|
|
107
109
|
3. Build.
|
|
108
110
|
4. Document.
|
|
109
111
|
5. Review (implementation and documentation gates).
|
|
@@ -179,11 +181,15 @@ If not clear, ask that same stage a focused follow-up before continuing.
|
|
|
179
181
|
|
|
180
182
|
When planning is approved, extract and pass `FINAL_PLAN` (plus risks, assumptions, and validation strategy) into the first build handoff. If authoritative handoff already contains `PLANNING_GATE=APPROVED` + `FINAL_PLAN`, skip this loop and use that plan directly.
|
|
181
183
|
|
|
182
|
-
###
|
|
184
|
+
### Scope-clear authorization checkpoint (required)
|
|
183
185
|
|
|
184
|
-
- Before the first implementation iteration,
|
|
185
|
-
-
|
|
186
|
-
-
|
|
186
|
+
- Before the first implementation iteration, ensure scope is clear and summarize it in 1-3 bullets.
|
|
187
|
+
- If the request is a clear imperative, treat that clear scope as implementation authorization.
|
|
188
|
+
- If scope is ambiguous, ask focused clarifying questions before Build.
|
|
189
|
+
- Do not ask a second implementation-confirmation or plan-approval question after the scoped summary.
|
|
190
|
+
- Do not emit an extra "starting now" or equivalent pre-build notice before delegating Build.
|
|
191
|
+
- This rule applies both after an approved planning handoff and after an interactive planning loop reaches clear scope.
|
|
192
|
+
- This rule also applies to imperative follow-on requests derived from prior workflow outputs such as `OPEN_ISSUES`, action items, or non-blocking items.
|
|
187
193
|
|
|
188
194
|
### Execution/review loop (max 10 iterations)
|
|
189
195
|
|
|
@@ -202,17 +208,17 @@ For each iteration `n`:
|
|
|
202
208
|
|
|
203
209
|
### Autonomous continuation rule
|
|
204
210
|
|
|
205
|
-
- After the required
|
|
211
|
+
- After the required scope-clear authorization checkpoint is satisfied, do not pause between required stages.
|
|
206
212
|
- Do not ask the user what to do next while required workflow stages remain unfinished.
|
|
207
213
|
- Do not use optional phrasing like "If you want, I can..." for unfinished required workflow steps.
|
|
208
214
|
- If a stage reports partial progress (for example "waiting for tests"), treat it as non-terminal and issue a focused same-stage follow-up immediately.
|
|
209
215
|
|
|
210
216
|
### Fixed-workflow non-terminal invariant
|
|
211
217
|
|
|
212
|
-
- After the required
|
|
213
|
-
- After the required
|
|
218
|
+
- After the required scope-clear authorization checkpoint, successful Build always proceeds to Document.
|
|
219
|
+
- After the required scope-clear authorization checkpoint, successful Document always proceeds to Review.
|
|
214
220
|
- Build and Document are stage-complete states, not workflow-complete states.
|
|
215
|
-
- When deterministic continuation is required after
|
|
221
|
+
- When deterministic continuation is required after scope-clear authorization, emit `RECOMMENDED_NEXT_STEP` exactly as defined in the Plugin continuation contract below.
|
|
216
222
|
|
|
217
223
|
### Direct-execution prohibition
|
|
218
224
|
|
|
@@ -256,7 +262,7 @@ RECOMMENDED_NEXT_STEP='<human-readable next step>'
|
|
|
256
262
|
|
|
257
263
|
Rules:
|
|
258
264
|
|
|
259
|
-
- Never emit `RECOMMENDED_NEXT_STEP` before the required
|
|
265
|
+
- Never emit `RECOMMENDED_NEXT_STEP` before the required scope-clear authorization checkpoint.
|
|
260
266
|
- Emit `RECOMMENDED_NEXT_STEP` when the next workflow action is deterministic and does not require user input.
|
|
261
267
|
- Omit `RECOMMENDED_NEXT_STEP` when the workflow is fully complete, blocked, escalated, or waiting on required user input.
|
|
262
268
|
- Omit `RECOMMENDED_NEXT_STEP` when the recommendation is "None", "Nothing", "No further steps", or similar.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/package.json",
|
|
3
3
|
"name": "@syntesseraai/opencode-feature-factory",
|
|
4
|
-
"version": "0.12.
|
|
4
|
+
"version": "0.12.3",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "OpenCode plugin for Feature Factory agents - provides sub-agents and skills for validation, review, security, and architecture assessment",
|
|
7
7
|
"license": "MIT",
|