Skip to content

Adoption roadmap ​

Don't roll out everything at once. This roadmap helps a team adopt the reference model incrementally and record choices in your ADRs.

Reference only

Customize timelines for your org size, compliance tier, and existing tooling.

Week 1 — Orient ​

DayActionRead
1Team lead walks through How to useHOW-TO-USE
2Pick one lifecycle phase to improve firstLifecycle hubs
3Each role reads their perspectiveRole pages
4Align on GOVERNANCE roles (adapt RACI)GOVERNANCE
5Record "we start with phase X" in your ADR—

Recommended first phase: Plan (ADR + spec) or Verify (CI gates).

Weeks 2–3 — Plan & define ​

MilestoneDeliverable
Intake templateCustomized SOP-001
ADR folderdocs/adr/ in your repo + SOP-002
Spec approvalSOP-003 with ARCH/PO owners
Data classificationGlossary started — Data governance guide
AI policySOP-010 signed by all engineers

Weeks 4–6 — Build & verify ​

MilestoneDeliverable
AI toolingDecision: AI coding tools guide → your ADR
Pre-commitgitleaks + linter — Linters guide
CI gatesSecret + unit + SAST on PR — SOP-005
PR reviewHuman reviewer required; AI advisory
Identity baselineSSO + no human access keys — Identity guide

Weeks 7–9 — Release & platform ​

MilestoneDeliverable
CI/CDCI/CD guide → pipeline in your repo
StagingPO sign-off gate — Release hub
RuntimeCompute choice ADR — Runtime AWS guide
Deploy rolesSeparate build vs deploy IAM (OIDC)

Weeks 10–12 — Operate & learn ​

MilestoneDeliverable
ObservabilityMetrics + traces — Monitoring guide
DashboardsGolden dashboard per service
On-callIncident guide + SOP-007
PostmortemSOP-008 for Sev-1/2
Feedback loopMonitoring as QA ticket type

Month 4+ — Mature ​

Success metrics (examples) ​

MetricTarget
PRs without Approved spec→ 0
Secret scan bypass merges→ 0
Mean time to rollbackDefined + tested
Postmortem action closure> 90% in 30 days

Reference template only — no production code. Adapt in your own project.