Skip to content

Commit f6aa11c

Browse files
Terraphim CITerraphim AI
andcommitted
feat(symphony): add V-model phase budgeting guidance to WORKFLOW
Document the split-issue pattern for complex work where agents exhaust their 50-turn budget during phases 1-3. Verification-only and validation-only issues can skip earlier phases and proceed directly to their target phase, reading artefacts from prior issues. Co-Authored-By: Terraphim AI <noreply@terraphim.io>
1 parent d785f52 commit f6aa11c

1 file changed

Lines changed: 20 additions & 1 deletion

File tree

crates/terraphim_symphony/examples/WORKFLOW-terraphim-private.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,9 +150,28 @@ Commit the artefact: `git add .docs/ && git commit -m "docs: validation for {{ i
150150
- Use British English in documentation
151151
- Never use mocks in tests
152152

153+
## Phase Budgeting
154+
155+
For complex issues (merge/reconciliation, large refactors), agents may exhaust their
156+
turn budget during phases 1-3. When creating issues, consider splitting into:
157+
158+
- **Implementation issue**: Phases 1-3 (research, design, implementation)
159+
- **Verification issue**: Phase 4 only, depends on implementation issue
160+
- **Validation issue**: Phase 5 only, depends on verification issue
161+
162+
For verification-only issues (title contains "verify" or "verification"):
163+
- Skip phases 1-3
164+
- Read existing `.docs/research-issue-*.md` and `.docs/design-issue-*.md` artefacts
165+
- Proceed directly to Phase 4: Verification
166+
167+
For validation-only issues (title contains "validate" or "validation"):
168+
- Skip phases 1-4
169+
- Read existing artefacts from prior phases
170+
- Proceed directly to Phase 5: Validation
171+
153172
## CRITICAL Instructions
154173

155-
1. Follow all 5 V-model phases in order. Do NOT skip phases.
174+
1. Follow all applicable V-model phases in order. Do NOT skip phases unless this is a verification-only or validation-only issue.
156175
2. Examine ALL existing code in this workspace. Build on what is there.
157176
3. Produce artefacts for each phase and commit them to the branch.
158177
4. Ensure all quality gates pass before finishing.

0 commit comments

Comments
 (0)