-
Notifications
You must be signed in to change notification settings - Fork 0
Framework at a Glance
Status: Complete · The entire SAE Framework on one page. Print it, pin it, share it. Every line links to its deep dive.
The cost of code, infrastructure, and boilerplate has collapsed toward zero. The bottleneck is no longer execution — it is human clarity.
One operator with deep domain insight and sharp architectural vision, orchestrating AI personas, out‑builds a legacy cross‑functional team — by managing digital context, not human headcount.
| Legacy | SAE | |
|---|---|---|
| Bottleneck | Engineering hours / syntax | Human clarity |
| Scaling | Add headcount → O(N²) coordination | Collapse to N=1 → O(1) |
| Unit of work | Story points | Context Entropy |
| Source of truth | The code | The spec |
| Speed | Months | Days |
→ The 12 Layers of Friction · Module 1
0 FRAME → 1 SPEC → 2 PRIME → 3 GENERATE → 4 REVIEW → 5 GUARD → 6 RECONCILE → 7 SHIP
↑ │
└──────────── spec amendment ← 9 MAINTAIN ← 8 OBSERVE ←──────────────────────┘
Every change re‑enters at Spec — never the code. → The End‑to‑End Lifecycle
| Persona | Job |
|---|---|
| Conductor (you) | Architecture, edge cases, structural‑drift review, final calls |
| Visualizer | Generative UI → semantic components |
| Engineer | Repo‑aware code generation from the spec |
| Guardian | Adversarial QA — breaks what the Engineer builds, in a fresh context |
→ Module 3 · prompts in Agent Setup
- Architect‑Engineer Collapse — vision + execution in one person
- Single‑Shot Vertical Slice — schema → API → state → UI in one cycle
- Spec‑Driven Development — the Markdown spec is the source of truth
- High‑Context Modular Design — small, isolated, AI‑readable bounded contexts
→ Module 2
| Rating | Band | Prep | Time |
|---|---|---|---|
| 1–3 | Low | Minimal — just do it | Minutes |
| 5–8 | Medium | Audit/update the spec first | < 1 hour |
| 13 | High | Redefine boundaries before touching anything | An afternoon |
→ Module 5
Cursor + Claude Code · Next.js + v0 + Shadcn · Supabase / Neon · Vercel / Cloudflare
If a tool needs a dedicated admin, it's banned. → Module 4 · Tooling List
- The spec is the source of truth — reconcile code↔spec immediately.
- The writer never judges its own work — verify in a fresh, adversarial context.
- Gate the irreversible — auth, payments, deletion, schema drops: human decides, never auto.
- Isolate bounded contexts — isolation keeps generation precise.
- You own the output — "the AI wrote it" is not an explanation.
Cycle time (flow) · Regression escape rate (quality) · Spec drift time (health canary) · Blast‑radius incidents (the line you don't cross). Read flow and quality together. → KPIs & Metrics
Single point of failure · you can't review what you can't evaluate · "bypass integration testing" is shorthand, not literal · vendor lock‑in · regulated domains keep their gates · the #1 failure mode is a stale spec. → Risks, Security & Governance · When NOT to Use SAE
New here? Start with The 12 Layers of Friction, then build via Getting Started.
The Sovereign Architect‑Engineer (SAE) Framework · Maintained by Sanjeev Azad · Repository · MIT License · Contribute
- Module 1: The Sovereign Paradigm Shifts
- Module 2: Core Pillars of SAE Architecture
- Module 3: The Digital Org Chart
- Module 4: The Lean SAE Tech Stack
- Module 5: Project Navigation & Metrics
- The End‑to‑End Lifecycle
- Operator Competency Model
- The Verification Doctrine
- Scenario Playbooks
- Operator Techniques
- Best Practices
- KPIs & Metrics
- The Maturity Model
- The Anti-Pattern Catalog
- Risks, Security & Governance
- Governance, Versioning & Stewardship