@syntesseraai/opencode-feature-factory 0.6.1 → 0.6.2
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/README.md +12 -0
- package/agents/pipeline.md +18 -18
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -46,6 +46,18 @@ This will:
|
|
|
46
46
|
- **`@ff-acceptance`** - Binary pass/fail validation against acceptance criteria.
|
|
47
47
|
- **`@ff-well-architected`** - Reviews code against AWS Well-Architected Framework pillars.
|
|
48
48
|
|
|
49
|
+
### Pipeline Model Split
|
|
50
|
+
|
|
51
|
+
The package also includes a multi-model pipeline orchestrator defined in `agents/pipeline.md`.
|
|
52
|
+
|
|
53
|
+
For the building phase of that pipeline:
|
|
54
|
+
|
|
55
|
+
- **`ff-building-opus`** - breaks the approved plan into atomic tasks
|
|
56
|
+
- **`ff-building-gemini`** - validates architecture and enriches each task with codebase context
|
|
57
|
+
- **`ff-building-chatgpt`** - implements validated tasks and handles rework loops
|
|
58
|
+
|
|
59
|
+
See the repository workflow doc at `docs/PIPELINE_ORCHESTRATION.md` for the end-to-end three-phase workflow: https://github.com/SyntesseraAI/feature-factory/blob/main/docs/PIPELINE_ORCHESTRATION.md
|
|
60
|
+
|
|
49
61
|
## Behavior
|
|
50
62
|
|
|
51
63
|
- **Manual install**: Agents and skills are installed via the `npx install` command, not automatically
|
package/agents/pipeline.md
CHANGED
|
@@ -75,14 +75,14 @@ Your job is to **orchestrate**, not implement. You delegate every piece of real
|
|
|
75
75
|
├─────────────────────────────────────────────────────────────────┤
|
|
76
76
|
│ PHASE 2: BUILDING │
|
|
77
77
|
│ │
|
|
78
|
-
│ ff-building-
|
|
78
|
+
│ ff-building-opus (task breakdown) │
|
|
79
79
|
│ │ │
|
|
80
80
|
│ ▼ │
|
|
81
81
|
│ ff-building-gemini (arch validation + context) ──parallel── │
|
|
82
82
|
│ │ │
|
|
83
83
|
│ ▼ │
|
|
84
|
-
│ ff-building-
|
|
85
|
-
│ advisory:
|
|
84
|
+
│ ff-building-chatgpt (implementation) ──parallel── │
|
|
85
|
+
│ advisory: opus (impl) / gemini (arch) │
|
|
86
86
|
├─────────────────────────────────────────────────────────────────┤
|
|
87
87
|
│ PHASE 3: REVIEWING (max 10 iterations per task) │
|
|
88
88
|
│ │
|
|
@@ -93,7 +93,7 @@ Your job is to **orchestrate**, not implement. You delegate every piece of real
|
|
|
93
93
|
│ └─→ ff-reviewing-chatgpt ─┘ (synthesis) │
|
|
94
94
|
│ │
|
|
95
95
|
│ ≥95% confidence + all issues addressed → DONE │
|
|
96
|
-
│ Otherwise → ff-building-
|
|
96
|
+
│ Otherwise → ff-building-chatgpt rework → full Phase 3 again │
|
|
97
97
|
│ 10 iterations without pass → escalate to user │
|
|
98
98
|
└─────────────────────────────────────────────────────────────────┘
|
|
99
99
|
```
|
|
@@ -236,10 +236,10 @@ Read the consensus report. Apply the gate:
|
|
|
236
236
|
|
|
237
237
|
## Step 2.1: Task Breakdown
|
|
238
238
|
|
|
239
|
-
Pass the final plan to ff-building-
|
|
239
|
+
Pass the final plan to ff-building-opus for task decomposition:
|
|
240
240
|
|
|
241
241
|
```
|
|
242
|
-
Task(ff-building-
|
|
242
|
+
Task(ff-building-opus): "Break down this implementation plan into discrete, independently implementable tasks. Each task should be atomic — completable in a single implementation pass.
|
|
243
243
|
|
|
244
244
|
Final Plan: [paste or reference plan-final-{UUID}.md]
|
|
245
245
|
|
|
@@ -252,7 +252,7 @@ For each task produce:
|
|
|
252
252
|
- ACCEPTANCE CRITERIA: How to verify this task is done
|
|
253
253
|
- IMPLEMENTATION NOTES: Key technical details, patterns to follow
|
|
254
254
|
|
|
255
|
-
Persist the task breakdown using `ff-agents-update` as `ff-building-
|
|
255
|
+
Persist the task breakdown using `ff-agents-update` as `ff-building-opus-tasks-{UUID}.md`"
|
|
256
256
|
```
|
|
257
257
|
|
|
258
258
|
## Step 2.2: Architecture Validation
|
|
@@ -278,16 +278,16 @@ Persist the enriched task using `ff-agents-update` as `ff-building-gemini-{UUID}
|
|
|
278
278
|
|
|
279
279
|
## Step 2.3: Implementation
|
|
280
280
|
|
|
281
|
-
For each architecture-validated task, pass to ff-building-
|
|
281
|
+
For each architecture-validated task, pass to ff-building-chatgpt for implementation:
|
|
282
282
|
|
|
283
283
|
```
|
|
284
|
-
Task(ff-building-
|
|
284
|
+
Task(ff-building-chatgpt): "Implement this task. You have access to advisory channels during implementation.
|
|
285
285
|
|
|
286
286
|
Enriched Task: [paste architecture-validated task]
|
|
287
287
|
Full Plan Context: [reference plan-final-{UUID}.md]
|
|
288
288
|
|
|
289
289
|
ADVISORY CHANNELS — Use these when you need help:
|
|
290
|
-
- For IMPLEMENTATION questions (patterns, APIs, how-to): delegate to ff-building-
|
|
290
|
+
- For IMPLEMENTATION questions (patterns, APIs, how-to): delegate to ff-building-opus
|
|
291
291
|
- For ARCHITECTURE questions (design, structure, boundaries): delegate to ff-building-gemini
|
|
292
292
|
|
|
293
293
|
Implement the task fully:
|
|
@@ -297,7 +297,7 @@ Implement the task fully:
|
|
|
297
297
|
4. Run lint and typecheck
|
|
298
298
|
5. Verify the acceptance criteria are met
|
|
299
299
|
|
|
300
|
-
Persist your completion report using `ff-agents-update` as `ff-building-
|
|
300
|
+
Persist your completion report using `ff-agents-update` as `ff-building-chatgpt-{UUID}-T{N}.md` including:
|
|
301
301
|
- What was implemented
|
|
302
302
|
- Files modified
|
|
303
303
|
- Tests added/updated
|
|
@@ -320,7 +320,7 @@ For each completed task from Phase 2 (or rework), pass to ff-reviewing-chatgpt f
|
|
|
320
320
|
```
|
|
321
321
|
Task(ff-reviewing-chatgpt): "Triage this completed implementation task. Prepare it for parallel multi-model review.
|
|
322
322
|
|
|
323
|
-
Completed Task Report: [paste
|
|
323
|
+
Completed Task Report: [paste chatgpt completion report]
|
|
324
324
|
Original Task Spec: [paste task spec from breakdown]
|
|
325
325
|
Full Plan Context: [reference plan-final-{UUID}.md]
|
|
326
326
|
|
|
@@ -393,17 +393,17 @@ Read the synthesis report. Apply the gate:
|
|
|
393
393
|
|
|
394
394
|
## Step 3.5: Rework
|
|
395
395
|
|
|
396
|
-
Pass the rework instructions back to ff-building-
|
|
396
|
+
Pass the rework instructions back to ff-building-chatgpt:
|
|
397
397
|
|
|
398
398
|
```
|
|
399
|
-
Task(ff-building-
|
|
399
|
+
Task(ff-building-chatgpt): "Rework this task based on review feedback. This is review iteration {I} of 10.
|
|
400
400
|
|
|
401
401
|
Original Task: [paste task spec]
|
|
402
|
-
Previous Implementation: [reference previous
|
|
402
|
+
Previous Implementation: [reference previous chatgpt implementation or rework report]
|
|
403
403
|
Review Feedback: [paste synthesis rework instructions]
|
|
404
404
|
|
|
405
405
|
ADVISORY CHANNELS — Use these when you need help:
|
|
406
|
-
- For IMPLEMENTATION questions: delegate to ff-building-
|
|
406
|
+
- For IMPLEMENTATION questions: delegate to ff-building-opus
|
|
407
407
|
- For ARCHITECTURE questions: delegate to ff-building-gemini
|
|
408
408
|
|
|
409
409
|
Address ALL issues listed in the review feedback. For each issue:
|
|
@@ -412,7 +412,7 @@ Address ALL issues listed in the review feedback. For each issue:
|
|
|
412
412
|
3. Verify the fix resolves the issue
|
|
413
413
|
4. Run lint, typecheck, and tests
|
|
414
414
|
|
|
415
|
-
Persist your rework report using `ff-agents-update` as `ff-building-
|
|
415
|
+
Persist your rework report using `ff-agents-update` as `ff-building-chatgpt-rework-{UUID}-T{N}-iter{I}.md` including:
|
|
416
416
|
- Each issue addressed and how it was fixed
|
|
417
417
|
- Any advisory consultations made
|
|
418
418
|
- Updated files list
|
|
@@ -489,7 +489,7 @@ Update todos in real-time as you progress. Add task-specific todos as they emerg
|
|
|
489
489
|
|
|
490
490
|
- **Sub-agent failure:** If a delegated agent fails or returns an error, retry once. If it fails again, escalate to the user with the error details.
|
|
491
491
|
- **Timeout:** If a delegated agent doesn't respond within a reasonable time, check `ff-agents-current()` and `ff-agents-show()` for status.
|
|
492
|
-
- **Conflicting advice:** When advisory channels give conflicting guidance to ff-building-
|
|
492
|
+
- **Conflicting advice:** When advisory channels give conflicting guidance to ff-building-chatgpt, ChatGPT should document the conflict and make a reasoned choice, noting it in the completion report for review.
|
|
493
493
|
|
|
494
494
|
---
|
|
495
495
|
|
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.6.
|
|
4
|
+
"version": "0.6.2",
|
|
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",
|