Skip to main content
Reference — generated from the toolkit

Source of truth: toolkit/scaffold/README.md. Edit it there; this page is regenerated on build.

RAPID project scaffold

The template every RAPID build starts from. Agents build inside the scaffold rather than inventing structure — the single highest-leverage artefact for uniform agent output, and "guardrails built in, not bolted on" made literal.

This directory is the skeleton — the structure and the agent-facing context files. A runnable golden path per adopted stack (with CI, test harness and a working example) is layered on top once stacks are chosen from the radar.

What a scaffolded repo contains​

{product}/
├── CLAUDE.md              # agent context — see scaffold/CLAUDE.md
├── memory/                # gotchas — one fact per file (repo-context standard)
├── docs/
│   ├── adr/               # decision records (see toolkit/templates/adr.md)
│   └── runbooks/          # operational runbooks (see toolkit/templates/runbook.md)
├── .github/workflows/     # the shared CI/CD pipeline (ci-cd-pipeline standard)
├── {src}/                 # golden-path application code
└── {tests}/               # test harness wired to the pyramid + mutation testing

What's pre-wired​

  • Agent config — CLAUDE.md, hooks (lint/test/scan on write), MCP allowlist, model pinning — implementing the agent guardrail standard.
  • CI with gates — the CI/CD pipeline and merge gate pre-configured; coverage, mutation, SAST, SCA, secrets all on.
  • Secure defaults — linter config encoding the secure-by-default posture.
  • Docs & memory stubs — so docs-with-build and gotcha capture have somewhere to land from day one.

Standards referenced: SLSA, 12-factor.