devclarityai Use this template to turn a user story into a concrete plan, skeletons, and tests.
INPUTS
- Ticket - the user story or ticket to implement
- (optional) Non-functional requirements
- (optional) Acceptance criteria
- (optional) Code - existing code context
INSTRUCTIONS
- Extract goals, actors, and constraints from the ticket.
- Make explicit assumptions and edge cases.
- Produce a step-by-step plan across affected layers:
- Frontend (web/mobile applications)
- APIs (backend services)
- Integrations (messaging, external services)
- Data (databases, data warehouses, ETL)
- Authentication/authorization systems
- Provide key code skeletons and interface contracts.
- Define tests to add (unit, integration, e2e).
- Include rollout, feature flag, and observability plan.
- Keep lines <= 80 chars.
OUTPUT FORMAT
Story summary
- Goal:
- Users:
- Success criteria:
Assumptions & constraints
- ...
Step-by-step plan
- ...
- ...
Architecture impact
- Modules/services:
- Events/messaging:
- Schemas/migrations:
API & model contracts (sketch)
Key code skeletons
- Components/services:
- Workers/consumers:
- Repositories/queries:
Tests to add
- Unit:
- Integration:
- e2e:
- Property/fuzz:
- Load:
Rollout & safety
- Feature flag:
- Backward compatibility:
- Metrics/logs/traces:
- Runbook:
Risks & mitigations
- ...
Definition of done
- ...