Appearance
Documentation Index
Use the sidebar to navigate, Ctrl+K (or ⌘K) to search all pages, and On this page (right) to jump within long guides.
Browse by role, lifecycle phase, pillar, or decision topic.
AI toolkit
Catalog: AI toolkit — all AI tools and AI-adjacent artifacts (ADR, specs, MCP, portals, review bots) in one place with lifecycle impact.
By lifecycle phase
Hub pages: Lifecycle overview — Plan · Build · Verify · Release · Operate · Learn
| Phase | Decision guides | Topic docs | Reference SOPs |
|---|---|---|---|
| Plan | Planning & ADR · Data governance | planning-and-adr.md · data-governance.md | SOP-001–003 |
| Build | AI tools · Spec-driven · Linters · Identity & secrets | developer-workflow.md | SOP-004 |
| Verify | Testing · Guardrails · Identity & secrets | qa-guardrails.md | SOP-005 |
| Release | CI/CD · Runtime | cicd-observability.md | SOP-006 |
| Operate | Monitoring & tracing · Dashboards · Incidents | operations-observability.md | SOP-007 |
| Learn | Monitoring as QA · Human-in-the-loop | GOVERNANCE.md | SOP-008 |
| Cross-cutting | Knowledge indexing | — | SOP-009 · 010 |
By role
Hub: Role perspectives
| Role | Perspective page | Also read |
|---|---|---|
| Developer | Developer | Developer workflow · AI coding tools |
| DevOps / SRE | DevOps / SRE | Operations overview · CI/CD guide |
| QA / Quality | QA | Automated testing · QA topic |
| Product manager / PO | Product manager | Planning guide |
| Scrum Master | Scrum Master | Process overview |
| Program manager | Program manager | Governance |
| Team lead / EM | Team lead / EM | Human-in-the-loop |
| Architect | Architect | Planning & ADR |
| Security | Security | Identity & secrets · Data governance · AI guardrails |
By content pillar
Hub: Pillars overview
| Pillar | Hub | Primary guides |
|---|---|---|
| Delivery | Delivery | Planning, spec-driven, AI toolkit, human-in-the-loop |
| Quality | Quality | Testing, linters, guardrails, monitoring-as-QA |
| Platform | Platform | CI/CD, runtime AWS |
| Data & security | Data & security | Data governance, identity & secrets |
| Operations | Operations | Monitoring, dashboards, incidents |
Operations & data (guide cluster)
| Guide | Decisions covered |
|---|---|
| Data governance layers | Classification, access, retention, lineage, AI/RAG scope |
| Identity, access & secrets | SSO, IAM, RBAC, Secrets Manager, CI OIDC, permission matrix |
| Monitoring, tracing & logging | OTel, CloudWatch, X-Ray, metrics/logs/traces, RUM |
| Dashboards & reporting | Golden dashboards, SLO reports, exec/compliance views |
| Incident management | PagerDuty, severity, comms, runbooks, postmortem |
| Observability & monitoring QA | Synthetics, deploy diff, regression feedback loop |
→ Full index (16 guides): guides/index.md
All decision guides
| Guide | Topic |
|---|---|
| AI coding tools | IDE agents, Q, Copilot |
| Planning, ADR & specs | Planning with AI |
| Knowledge indexing & portals | ADR/spec discovery |
| Spec-driven development | Contracts + AI codegen |
| Automated testing & QA | Test pyramid |
| Linters & static analysis | ESLint, SAST, pre-commit |
| AI guardrails & security | Policy, AI review |
| CI/CD & release | Pipelines, canary |
| Runtime on AWS | ECS, Lambda, data |
| Monitoring, tracing & logging | Three pillars |
| Dashboards & reporting | SLO + exec views |
| Incident management | On-call, incidents |
| Observability & monitoring QA | Prod as QA |
| Data governance layers | Data + AI bounds |
| Human-in-the-loop & governance | Gates, RACI |
| Identity, access & secrets | IAM, RBAC, secrets lifecycle |
Operating model (reference only)
| Doc | Contents |
|---|---|
| GOVERNANCE.md | Roles, RACI, tiers, artifact lifecycle |
| processes/overview.md | Value stream, phase gates |
| sops/ | 12 reference procedures |
Other
- HOW-TO-USE.md — what this repo is and isn't
- Adoption roadmap — week-by-week rollout
- AI toolkit catalog — tools and AI-adjacent artifacts
- Glossary — terms and abbreviations
- ARCHITECTURE.md — conceptual diagrams and layer model