Templates and Starter Artifacts
This pack turns the guide into a working toolkit. Use the templates as starting points for issues, pull requests, architecture notes, AI-DLC records, or agent prompts.
Downloadable templates
| Template | Use when | Link |
|---|---|---|
| Spec Kit feature spec | Intent is ambiguous and needs a spec-first path | Download |
| OpenSpec change proposal | You need lightweight SDD for a scoped change | Download |
| AI-DLC risk and audit record | Delivery needs governance, review, and traceability | Download |
| GSD phase plan | Work spans many sessions, agents, or handoffs | Download |
| Superpowers TDD prompt | You want the coding agent to design, test, implement, review | Download |
| LangGraph state design | You are building a stateful agent service | Download |
| RAG eval checklist | You need a production-grade RAG release gate | Download |
| Tool permission matrix | You need safe tool use, audit, and approval rules | Download |
| Adoption scorecard | You need to assess maturity and prioritize improvements | Download |
Which template should be required?
mermaid
flowchart TB
A[New AI-assisted change] --> B{Risk level}
B -->|High| C[AI-DLC risk and audit record]
B -->|Medium| D{Requirement clarity}
B -->|Low| E[OpenSpec change proposal]
D -->|Unclear| F[Spec Kit feature spec]
D -->|Clear| E
C --> G[Tool permission matrix]
F --> H[Superpowers TDD prompt]
E --> H
G --> I[RAG eval or LangGraph state design if relevant]
H --> IRecommended minimum bundle
| Scenario | Required templates |
|---|---|
| Normal product feature | Spec Kit feature spec or OpenSpec proposal, Superpowers TDD prompt |
| RAG feature | OpenSpec proposal, RAG eval checklist, tool permission matrix |
| Stateful agent | LangGraph state design, tool permission matrix, eval checklist |
| Enterprise AI feature | AI-DLC risk/audit record, spec, tool permission matrix, release evidence |
| Internal agent platform | AI-DLC record, Hermes/tool policy notes, LangGraph state design if app runtime exists |
How to use with a coding agent
- Fill the smallest template that captures the risk.
- Paste the completed artifact into the issue, PR, or agent session.
- Tell the agent which artifact is the source of truth.
- Ask the agent to produce a plan that maps every task to the artifact.
- Require tests, evals, or review evidence before implementation is considered done.
Template quality bar
A template is useful only if it changes behavior. If a section will not affect design, testing, review, or release, remove it for that change. Lightweight does not mean undocumented; it means every artifact earns its place.