Resources & Templates

Free, reusable spec templates and checklists for engineering teams. All resources are in Markdown format.

30 resources · Markdown · Free

Featured

Software Spec Template (Google Docs)

A complete spec template for Google Docs.

View

Acceptance Criteria Prompt Pack

Prompt templates for generating acceptance criteria with AI.

Download

Spec & Planning Templates

Acceptance Criteria Prompt Pack

AI-ready prompts for generating Given/When/Then acceptance criteria from feature descriptions. Works with ChatGPT, Claude, and Copilot.

Download .md

Ticket-to-Spec Field Template

A mapping template that converts Jira/Linear ticket fields into structured spec sections — goal, non-goals, acceptance criteria, and rollback.

Download .md

Spec-First Adoption Decision Tree

A decision flowchart to help teams determine when a feature needs a full spec, a lightweight spec, or can go straight to code.

Download .md

Spec-Driven Governance Policy

An org-level policy template defining when specs are required, who reviews them, and how they integrate with sprint planning.

Download .md

PR Criteria Evidence Form

A pull request template that maps each acceptance criterion to its test evidence — linking spec to code at merge time.

Download .md

Incident Note Template

A structured postmortem template covering timeline, root cause, detection gap, spec gap analysis, and follow-up action items.

Download .md

API & Contract Resources

API Backward Compatibility Checklist

Pre-release checklist for verifying that API changes don't break existing consumers — field additions, removals, type changes, and default values.

Download .md

API Change Communication Template

Stakeholder notification template for breaking and non-breaking API changes — migration timeline, impact scope, and action required.

Download .md

API Deprecation Plan Template

Step-by-step template for sunsetting API versions — deprecation notice, migration guides, monitoring, and cut-off enforcement.

Download .md

API Error Runbook

Operations runbook mapping API error codes to root causes, triage steps, and escalation paths for on-call engineers.

Download .md

API Error Taxonomy

Classification framework for API errors — validation, authorization, rate-limit, upstream dependency, and internal server errors with standard payloads.

Download .md

API Schema Diff Review Matrix

Review checklist for evaluating API schema diffs — categorizes changes as safe, risky, or breaking with reviewer action items.

Download .md

API Versioning Decision Memo

Decision document template for choosing between URL, header, and content-negotiation versioning — trade-offs, team context, and rationale.

Download .md

OpenAPI Contract CI Checks

CI pipeline configuration template for automated OpenAPI schema validation — linting, breaking-change detection, and mock server tests.

Download .md

Contract Review Question Bank

50+ review questions organized by API lifecycle stage — design, implementation, pre-release, and post-deployment contract validation.

Download .md

Partner API Onboarding Kit

External partner integration package template — API key provisioning, sandbox access, rate limits, SLA, and escalation contacts.

Download .md

AI & Automation Resources

Agentic API Decision Matrix

Evaluation framework for deciding when to expose APIs to AI agents — risk assessment, permission scoping, and human-in-the-loop thresholds.

Download .md

AI Migration Review Checklist

Pre-migration checklist for AI-assisted code changes — scope validation, test coverage requirements, rollback verification, and approval gates.

Download .md

AI Quality Gate Policy

Organization-level policy defining quality gates for AI-generated code — review requirements, test evidence, and deployment restrictions.

Download .md

AI Risk Register Template

Risk assessment template for AI features — hallucination risk, data leakage, bias detection, model drift monitoring, and mitigation strategies.

Download .md

Product Prompt Library Starter Kit

Organized collection of production-ready prompts for product teams — feature ideation, user story generation, and acceptance criteria drafting.

Download .md

Spec Workflow Prompt Pack

End-to-end prompt templates for spec-driven workflows — from PRD analysis to acceptance criteria generation to test case creation.

Download .md

Structured Prompt Rubric

Scoring rubric for evaluating prompt quality — clarity, constraint specificity, output format, and boundary definition criteria.

Download .md

SDK Human Review Scorecard

Review scorecard for evaluating AI-generated SDK code — API surface correctness, error handling, documentation quality, and test coverage.

Download .md

OpenClaw Workspace Governance Checklist

Governance checklist for OpenClaw workspace setup — permission controls, spec binding policies, output review workflows, and audit trails.

Download .md

Database & Operations

DB Migration Risk Model

Risk scoring model for database migrations — table size, lock duration, rollback complexity, and data integrity validation steps.

Download .md

Payment Retry Matrix

Decision matrix for payment retry logic — idempotency requirements, backoff strategies, and failure classification by payment provider response codes.

Download .md

Reconciliation Exception Playbook

Operations playbook for handling reconciliation exceptions — mismatch detection, root cause categories, resolution workflows, and escalation criteria.

Download .md

Test Evidence Gate Playbook

Quality gate playbook defining required test evidence per release tier — unit, integration, contract, and load test thresholds before deployment.

Download .md

Tool Comparison Score Model

Weighted scoring model for evaluating and comparing engineering tools — feature coverage, integration cost, team fit, and total cost of ownership.

Download .md