Appearance
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
| Day | Action | Read |
|---|---|---|
| 1 | Team lead walks through How to use | HOW-TO-USE |
| 2 | Pick one lifecycle phase to improve first | Lifecycle hubs |
| 3 | Each role reads their perspective | Role pages |
| 4 | Align on GOVERNANCE roles (adapt RACI) | GOVERNANCE |
| 5 | Record "we start with phase X" in your ADR | — |
Recommended first phase: Plan (ADR + spec) or Verify (CI gates).
Weeks 2–3 — Plan & define
| Milestone | Deliverable |
|---|---|
| Intake template | Customized SOP-001 |
| ADR folder | docs/adr/ in your repo + SOP-002 |
| Spec approval | SOP-003 with ARCH/PO owners |
| Data classification | Glossary started — Data governance guide |
| AI policy | SOP-010 signed by all engineers |
Weeks 4–6 — Build & verify
| Milestone | Deliverable |
|---|---|
| AI tooling | Decision: AI coding tools guide → your ADR |
| Pre-commit | gitleaks + linter — Linters guide |
| CI gates | Secret + unit + SAST on PR — SOP-005 |
| PR review | Human reviewer required; AI advisory |
| Identity baseline | SSO + no human access keys — Identity guide |
Weeks 7–9 — Release & platform
| Milestone | Deliverable |
|---|---|
| CI/CD | CI/CD guide → pipeline in your repo |
| Staging | PO sign-off gate — Release hub |
| Runtime | Compute choice ADR — Runtime AWS guide |
| Deploy roles | Separate build vs deploy IAM (OIDC) |
Weeks 10–12 — Operate & learn
| Milestone | Deliverable |
|---|---|
| Observability | Metrics + traces — Monitoring guide |
| Dashboards | Golden dashboard per service |
| On-call | Incident guide + SOP-007 |
| Postmortem | SOP-008 for Sev-1/2 |
| Feedback loop | Monitoring as QA ticket type |
Month 4+ — Mature
- Knowledge indexing for agent context
- Tier model fully enforced (GOVERNANCE)
- Exception process live (SOP-012)
- Quarterly review of pitfalls in decision guides you adopted
Success metrics (examples)
| Metric | Target |
|---|---|
| PRs without Approved spec | → 0 |
| Secret scan bypass merges | → 0 |
| Mean time to rollback | Defined + tested |
| Postmortem action closure | > 90% in 30 days |