4.0 KiB
4.0 KiB
Gate Prompt Templates (Codex)
Copy/adapt these templates per gate. Keep prompts explicit and evidence-oriented.
Common Prompt Header
You are implementing Gate <GATE_ID> for this project.
Constraints:
- Follow AGENTS.md workflow rules exactly.
- Update documentation after every meaningful change.
- Run required validations and report evidence.
- Do not claim completion without test outputs.
- Do not assume requirements; if unclear, stop and ask.
- If spec reference is missing for implementation work, return BLOCKED and do not code.
Output contract (mandatory):
- STATUS: DONE | BLOCKED
- TASK: <single task>
- SPEC_REF: <reference or BLOCKED reason>
- FILES_CHANGED: <list>
- VALIDATION_RUN: <commands + outcomes>
- OPENCLAW_VERIFY: <cli checks + browser checks or N/A>
- RISKS: <list or NONE>
Required docs updates:
- docs/tasks.md
- docs/progress.md
- docs/change-log.md
- docs/traceability.md
- docs/test-results.md
When fully done, run:
openclaw gateway wake --text "Done: <GATE_ID> completed with evidence" --mode now
G1 Planning Prompt
Objective: Complete planning artifacts.
Tasks:
1) Finalize requirements with testable acceptance criteria.
2) Capture Definition of Done.
3) List assumptions and risks.
4) If research_mode=true, produce docs/research-notes.md with options and recommendation.
Validations:
- Ensure requirements are testable and unambiguous.
- Ensure acceptance criteria map to at least one test each.
Done condition:
- docs/requirements.md complete
- docs/plan.md updated
- docs/progress.md updated for G1
G2 Architecture Prompt
Objective: Complete architecture baseline and ADR.
Tasks:
1) Update docs/architecture.md (components, data flow, deployment, security baseline).
2) Update docs/adr/ADR-0001-initial-architecture.md with alternatives and trade-offs.
3) For brownfield, ensure as-is architecture + migration artifacts are current.
Validations:
- Architecture supports must-have journeys.
- ADR includes at least 2 alternatives.
Done condition:
- G2 artifacts complete and cross-linked in docs/traceability.md
G3 Slice-1 Prompt
Objective: Deliver and verify first vertical slice.
Tasks:
1) Implement first slice for the top priority user journey.
2) Add unit and integration tests for this slice.
3) Execute manual smoke test for the slice.
Validations:
- unit tests pass
- integration tests pass
- manual smoke scenario recorded in docs/test-results.md
Done condition:
- slice-1 works end-to-end with evidence
G4 Full Build Prompt
Objective: Complete full build and baseline verification.
Tasks:
1) Implement remaining in-scope v1 features.
2) Run full validation suite.
3) Resolve failures or document blockers.
Validations:
- lint/type/build pass
- unit/integration/e2e pass
- contract checks pass if API boundaries exist
Done condition:
- all in-scope features implemented and verified
G5 Security & Quality Prompt
Objective: Execute security and quality gate.
Tasks:
1) Run dependency/secret baseline checks.
2) Verify auth/input validation/error handling.
3) Run performance smoke checks.
Validations:
- no unresolved critical/high issues
- mitigation plan logged for medium/low issues
Done condition:
- security and quality evidence logged
G6 Release Candidate Prompt
Objective: Prepare and verify release candidate.
Tasks:
1) Complete release checklist.
2) Validate rollback instructions.
3) Confirm monitoring/alerts baseline.
Validations:
- release-checklist complete
- rollback approach validated
- docs versioned and coherent
Done condition:
- RC ready for approval/deployment
G7 Handover Prompt
Objective: Complete handover and close orchestration.
Tasks:
1) Execute post-deploy smoke tests.
2) Finalize handover notes + runbook pointers.
3) Create next-iteration backlog.
Validations:
- critical journeys pass in deployed environment
- unresolved risks have owners
Done condition:
- docs/progress.md reaches 100% and project is handover-ready