| name | skill-sdd-contracts |
| description | Spec-Driven Development (SDD) contract templates for the ALDC framework. Use when an ALDC agent or workflow needs the canonical document template for an architecture doc, spec, test plan, planning findings, code review render, BCQuality task-context, phase/plan completion report, delivery note, or memory file. Loads the immutable template from assets/ on demand. Never edit a template in place — copy it to the target path and fill it. |
Skill: SDD Contract Templates
Purpose
ALDC is spec-driven: every phase produces a document that follows an immutable
template. This skill bundles those 14 templates as assets/ so they travel with
the APM package and resolve after apm install — instead of living at a
docs/templates/ path that APM never deploys to a consumer project.
Templates are Just-In-Time resources: load the specific one only when you are
about to produce its document. Never read all of them at once.
How agents consume these
Some templates are read at runtime (an agent copies/fills/renders them); the
ALDC agents reference those by their asset path skill-sdd-contracts/assets/<file>. The rest
are human reference — their format is already inlined in the agent/prompt that
owns them, so they are bundled here for completeness but are not read during a run.
| Asset | Consumed |
|---|
assets/architecture-template.md | runtime |
assets/bcquality-task-context.md | runtime |
assets/code-review-template.md | runtime |
assets/delivery-template.md | reference |
assets/memory-template.md | reference |
assets/mkdocs-site-prompt.md | reference |
assets/phase-complete-template.md | reference |
assets/plan-complete-template.md | reference |
assets/plan-template.md | reference |
assets/planning-findings-template.md | runtime |
assets/skill-template.md | reference |
assets/spec-template.md | reference |
assets/technical-spec-template.md | reference |
assets/test-plan-template.md | runtime |
Usage rule
- Identify the document you are about to write (architecture, spec, test plan, …).
LOAD skill-sdd-contracts/assets/<template>.md — read the matching template from this skill.- Copy it to the target path (e.g.
.github/plans/{req_name}/…) and fill every
section. Never edit the template in place.
This file is generated by scripts/build-apm.mjs from the canonical
docs/templates/ directory. Do not edit it by hand — edit the canonical templates
and re-run the generator.
