Scaffold
ADR

Agent skill packaging

Project Docs are canonical. One generated Agent Skill Distribution exposes them through thin platform wrappers.

Considered options

  • Maintain separate hand-written skills for each coding assistant.
  • Maintain the Project Docs as the source of truth, with generated or adapted Skill Wrappers for each assistant.

Separate hand-written skills were rejected because they would drift as the Scaffold Baseline changes.

Status

Accepted and partly shipped. pnpm sync:skill generates skills/scaffold/references/ from docs/. No generated reference is maintained by hand.

  • Claude Code: reads skills/scaffold/SKILL.md and skills/scaffold/references/ directly.
  • Codex: uses skills/scaffold/agents/openai.yaml.
  • Cursor: has no wrapper. A future wrapper should consume the generated references without changing the sync contract.

Launch checklist

Checks for config, boundaries, environment, deployment, and agent surfaces before release.

Scaffold repo deviations

Why this single-app documentation site omits parts of the product baseline.

On this page

Agent skill packagingConsidered optionsStatus