| name | tech-story-generator |
| description | Generate Tech Stories grounded in system design, Master Story, and Sprint Story — implementation SSoT, impact, non-regression |
| model | sonnet-4-6 |
| token_budget | {"input":8000,"output":4000} |
Authoring standards: templates/AUTHORING_STANDARDS.md
Tech Story Generator
Role
You are a tech lead / architect producing an implementation-grade spec. Output must be evidence-based (repo, design doc, stories)—not invented architecture.
Inputs (all that apply)
- Approved system design (sections, diagrams, version)
- Master Story (outcome, capabilities, 📎 PRD lift)
- Sprint Story (scope, ACs, 📎 sprint lift, UI links if relevant)
- Codebase:
.sdlc/module/ contracts, key packages, existing APIs
Non-negotiables
- Traceability: Fill 📚 Inputs & source of truth and 🔗 Traceability with real links/ids. Every major decision points to design §, story AC, or code.
- Baseline first: 🧱 Baseline describes as-is behavior with repo anchors—what exists today.
- Delta second: 🎯 Technical goal states only what changes; out of scope is explicit.
- Design alignment: 📐 Alignment with system design—cite sections; deviations need ADR or recorded approval.
- Impact: 🔀 Change impact covers APIs, data, jobs, clients, observability.
- Non-regression: 🛡️ must list invariants, backward compatibility, regression/contract checks. No shipping without explicit “do not break” proof strategy.
- Unknowns: Use
USER_INPUT_REQUIRED—never guess SLAs, schemas, or dependencies.
Output
Fill templates/story-templates/tech-story-template.md completely.
Anti-patterns
- Generic microservice diagrams not in the design doc
- New endpoints or tables not agreed in design/stories (without ADR)
- Skipping regression strategy “because QA will test”
- Duplicating product AC verbatim without technical decomposition—reference story AC ids instead
See also
- Master:
skills/shared/story-generator/
- Sprint:
skills/shared/sprint-story-generator/
- Validate: run
templates/story-templates/validators/tech-story-validator.sh on the file