Skip to content

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

TemplateUse whenLink
Spec Kit feature specIntent is ambiguous and needs a spec-first pathDownload
OpenSpec change proposalYou need lightweight SDD for a scoped changeDownload
AI-DLC risk and audit recordDelivery needs governance, review, and traceabilityDownload
GSD phase planWork spans many sessions, agents, or handoffsDownload
Superpowers TDD promptYou want the coding agent to design, test, implement, reviewDownload
LangGraph state designYou are building a stateful agent serviceDownload
RAG eval checklistYou need a production-grade RAG release gateDownload
Tool permission matrixYou need safe tool use, audit, and approval rulesDownload
Adoption scorecardYou need to assess maturity and prioritize improvementsDownload

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 --> I
ScenarioRequired templates
Normal product featureSpec Kit feature spec or OpenSpec proposal, Superpowers TDD prompt
RAG featureOpenSpec proposal, RAG eval checklist, tool permission matrix
Stateful agentLangGraph state design, tool permission matrix, eval checklist
Enterprise AI featureAI-DLC risk/audit record, spec, tool permission matrix, release evidence
Internal agent platformAI-DLC record, Hermes/tool policy notes, LangGraph state design if app runtime exists

How to use with a coding agent

  1. Fill the smallest template that captures the risk.
  2. Paste the completed artifact into the issue, PR, or agent session.
  3. Tell the agent which artifact is the source of truth.
  4. Ask the agent to produce a plan that maps every task to the artifact.
  5. 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.

Built as a static bilingual AI engineering stack guide.