SecondPen.aiTemplates · Engineering & architecture
Operational Readiness Review (ORR) template
Origin: AWS Well-Architected; Amazon's pre-launch checklist distilled from past COEs.
Sections
- Architecture
- Failure modes
- Monitoring & alarms
- Deployment & rollback
- Capacity
- Security
- Runbooks
- On-call
- Sign-off
How a tough reader scores it
When you score a draft against this format, the Critic evaluates this ORR. The weights add up to 100; the fixes for the weakest criteria arrive as cards in the editor.
| Criterion | Weight |
|---|---|
| Every dependency and failure mode identified with blast radius | 20 |
| Alarms exist for customer-impacting symptoms with thresholds | 20 |
| Safe deployment with tested rollback | 15 |
| Capacity validated with load-test evidence | 15 |
| Runbooks exist and are actionable | 10 |
| DR targets defined and tested | 10 |
| Answers backed by evidence links, not assertions | 10 |
How it works in SecondPen.ai
Open the template and the editor writes the blank once, with a line of guidance under each heading that you delete as you fill it in. Write your abstract and the editor names the format it reads like. Ask for a document with a slash command and it offers to start from the matching format. When the draft is ready, the Critic scores it against the criteria above, the way this format's toughest reader would, and the three highest-leverage fixes become Editor cards.
More in Engineering & architecture
- Google design docGoogle engineering culture; the canonical pre-implementation review doc
- RFC (Request for Comments)IETF RFCs; modern engineering template from the Rust RFC process, also used at Uber, Sourcegraph, and HashiCorp
- Architecture Decision Record (ADR)Michael Nygard (2011); now standard in ThoughtWorks Tech Radar "adopt" practices
- Threat model (STRIDE)Microsoft SDL; STRIDE by Loren Kohnfelder and Praerit Garg
- Runbook / playbookGoogle SRE and PagerDuty incident-response practice
- SLO documentGoogle SRE book and workbook
- C4 architecture overviewSimon Brown's C4 model (Context, Containers, Components, Code)
- READMEOpen-source convention (standard-readme, GitHub)