| name | delivery.tech_spec |
| phase | delivery |
| roles | Engineering Lead, Feature Team Engineer |
| description | Produce an implementation-ready technical specification with architecture, sequencing, and validation details. |
| variables | [object Object] |
| outputs | Technical design overview with diagrams and data flow descriptions., Implementation plan with milestones and task breakdown., Validation strategy including testing, monitoring, and rollout considerations. |
Purpose
Accelerate engineering planning by generating a comprehensive spec template aligned with the squad's delivery standards.
Pre-run Checklist
- ✅ Confirm definition artifacts (story map, spikes) are finalized.
- ✅ Align on target release milestone and success metrics.
- ✅ Gather existing system diagrams or API documentation.
Invocation Guidance
codex skills run delivery.tech_spec \
--vars "feature={{feature}}" \
"objectives={{objectives}}" \
"constraints={{constraints}}" \
"integrations={{integrations}}"
Recommended Input Attachments
- Architecture or sequence diagrams.
- API contracts or schema definitions.
- Relevant RFCs or ADRs.
Claude Workflow Outline
- Summarize feature objectives, constraints, and integration points.
- Describe the target architecture, including components, data flows, and failure handling.
- Outline implementation phases with tasks, owners, and dependencies.
- Define validation strategy: testing, monitoring, observability, and rollout plan.
- Provide documentation and review checklist.
Output Template
# Technical Specification — {{feature}}
## 1. Summary & Objectives
- Objectives:
- Success Metrics:
- Constraints:
## 2. Architecture Overview
- Component Diagram Description
- Data Flow:
- Failure Modes & Mitigations:
## 3. Implementation Plan
| Milestone | Tasks | Owner | Dependencies | Target Date |
| --- | --- | --- | --- | --- |
## 4. Validation Strategy
- Testing:
- Monitoring & Alerts:
- Rollout Plan:
## 5. Open Questions & Risks
- Item — Owner — Due Date
## 6. Review Checklist
- [ ] Design review scheduled
- [ ] Security review required?
- [ ] Documentation updates planned
Follow-up Actions
- Schedule a design review with relevant stakeholders.
- Break down milestone tasks into backlog tickets.
- Keep the spec updated as implementation progresses.