governance · the posture
Audit-first — and on the record.
You do not have to take a measure on trust. Every reading carries its citations, the belief updates behind it, and an audit trail — so a number can be checked rather than believed.
That is the guarantee: a record you can check. How the engine is built is on the record too, below.
The discipline behind the engine
How the engine is built is on the record. For anyone deciding whether to rely on a measure it produces, that record is what shows it is real and built seriously.
Decisions on the record
Every architectural choice is an Architecture Decision Record — the question, the options, the trade-offs, the call, and the date. Nothing structural changes without one. The record is continuous and kept; the history is the argument.
Reasoning on the record
The audit log is not paperwork wrapped around the engine. It is the engine’s output: every interpretation, every challenge, every estimate update, recorded. Transparency here is structural, not a marketing line.
Five contracts that block, not suggest
Test, traceability, bug, scope, topology. Each is a gate the work cannot bypass — a change that breaks a contract does not merge. Discipline that is optional is not discipline; these are not optional.
A bar the hardest claim must clear
The engine’s most demanding claim has a published readiness standard and a validation harness behind it. The bar holds even when the honest answer is “not yet” — and saying “not yet” in public is itself part of the standard.
governance · the record
Every architectural decision, on the record
Not a claim about the discipline — the discipline itself. Every row below is a real Architecture Decision Record in this repository, read straight from source and rendered at build time. There is no hand-maintained summary to drift from what actually shipped.
| ADR | Decision | Status | Date |
|---|---|---|---|
| 000 | Stage Gate Discipline (Constitution) | ACCEPTED · founder-locked 2026-05-23 | 2026-05-23 |
| 001 | Strict Contracts and the Violation Moment Protocol | Proposed | 2026-05-09 |
| 002 | The Three Epistemology Modes and the Five Canonical Commitments | Proposed | 2026-05-09 |
| 003 | Internal Core, External Ring, and Consumer-Count-Dependent Governance | Proposed | 2026-05-09 |
| 004 | Agent One Verdict Schema (amends ADR-003) | Proposed | 2026-05-09 |
| 005 | Stochastic Engine Architecture (Hybrid LLM Citation + Dirichlet-Multinomial Bayesian) | Proposed | 2026-05-11 |
| 006 | Deterministic and Composite Mode Architectures | Proposed | 2026-05-11 |
| 007 | Marker library schema codification | Accepted | 2026-05-12 |
| 008 | User-in-the-loop citation override | Accepted (specification only — implementation lands in a follow-up PR) | 2026-05-12 |
| 009 | ADR-to-PRD/SRS/BC doc-sync CI gate | Accepted | 2026-05-12 |
| 010 | Rich marker schema: framework_context, band_progression, extraction_hints | Accepted | 2026-05-12 |
| 011 | Compass content source-of-truth + resync discipline | Accepted | 2026-05-12 |
| 012 | Calibration Governance: Anchor Case Schema and Tier One Pass Criteria | Active — original Draft 2026-05-13; Revision A approved Sprint B13 2026-05-17 | 2026-05-13 |
| 013 | Framework-Calibrated Status: `calibration_source` and `calibration_tier` | Draft — D-4 reconciled with ADR-012 Rev A on 2026-06-03 (B23), see note below | 2026-05-14 |
| 014 | L6 Surface Layer Architecture | Accepted | 2026-05-14 |
| 015 | Pulse Session Model | Accepted | 2026-05-15 |
| 016 | Target-Setting and Gap Computation | Accepted | 2026-05-16 |
| 017 | V2.0 Validation Methodology | Accepted — original 2026-05-16; Revision B approved 2026-06-03 (B23) | 2026-05-16 |
| 018 | L6 Frontend Stack: Next.js + Firebase Auth + Firestore + Cloud Run | Accepted | 2026-05-17 |
| 019 | Admin console data model + universal audit | Proposed (DRAFT · parked for founder review) | 2026-05-19 |
| 020 | Tenant model: org / groups / users | Proposed (DRAFT · parked for founder review) | 2026-05-19 |
| 021 | Dynamic RBAC permission matrix | Proposed (DRAFT · parked for founder review) | 2026-05-19 |
| 022 | Modular monolith via npm workspaces | Proposed (DRAFT · founder-approved direction 2026-05-20) | 2026-05-20 |
| 023 | Deferred Items Registry · contract | Proposed (DRAFT · founder-approved direction 2026-05-20) | 2026-05-20 |
| 024 | compass-platform extraction routine · contract | Proposed (DRAFT · founder-approved direction 2026-05-20) | 2026-05-20 |
| 025 | Ring module internal layered architecture · contract | Proposed (DRAFT · founder-approved direction 2026-05-20) | 2026-05-20 |
| 026 | Widget feed contract (Bridge surface) | Accepted | 2026-05-24 |
| 027 | Membership model convergence with compass-platform EPIC E81 | Accepted (B16/T1 landed PR #134 · B16/T1b landed PR #136 · permission_override decision in ADR-028 PR #135) | 2026-05-24 |
| 028 | Permission override routes kept (no tension with E81) | Accepted | 2026-05-24 |
| 029 | Actions surface canonical shape | Accepted (2026-05-27, post-T4 deploy) | 2026-05-27 |
| 030 | Drift event canonical shape | Accepted (2026-05-27, post-T3 deploy · founder browser smoke confirmed Bridge shelf 4/4 live · drift_alert widget + /admin/drift list page rendering real candidates · Convert-to-action prompt-flow operational) | 2026-05-27 |
| 031 | Drift→Action pipeline (V1.x placeholder) | Placeholder · V1.x scoping deferred per founder lock 2026-05-27 | 2026-05-27 |
| 032 | Audit Firestore sink + query contract | Accepted (2026-05-29, post-T3 deploy · founder browser smoke confirmed /admin/audit-log rendering durable events with normalized event_id + org_id hoist · drift_candidate_surfaced doc written via FirestoreAuditSink + queried back through the explorer) | 2026-05-27 |
| 033 | Sign-off chain (session · action · objective) | Accepted (2026-05-29 · B20 closed · live on rev kerte-dev-web-00051-q4r) | 2026-05-29 |
| 034 | Notifications stack (in-app V1.0) | Accepted (2026-05-29 · B20 closed · live on rev kerte-dev-web-00051-q4r) | 2026-05-29 |
| 035 | Audit Seçim C: retention + redaction + export | Accepted (2026-05-29 · B20 closed · live on rev kerte-dev-web-00051-q4r) | 2026-05-29 |
| 036 | Parameters surface (implements the B16-planned param primitive) | Accepted (2026-05-29 · B20 closed · live on rev kerte-dev-web-00051-q4r) | 2026-05-29 |
| 037 | Custom roles + hybrid authority | Accepted (2026-05-31 · B21 close-out · D-1..D-10 implemented + verified on prod rev 00055-22z) | 2026-05-29 |
| 038 | Option-source registry (PA-governed dropdown data sources) | Accepted (2026-06-02 · B22 close-out · D-1..D-8 implemented + prod-verified rev 00060-wbm) | 2026-06-01 |
| 039 | Artifact Engine Architecture (clean, kerte-dev-native) | Accepted (architecture locked 2026-06-03; founder-approved). Stage-1 spec | 2026-06-03 |
| 040 | Engagements — consultant binding via membership projection | Accepted | 2026-06-12 |
| 041 | Framework-anchor bank (D1) | Accepted | 2026-06-13 |
| 042 | Strengths / Growth / Risks + Top-3 (D3) | Accepted | 2026-06-13 |
| 043 | Evidence-aware re-assessment diff (D4) | Accepted | 2026-06-13 |
| 044 | Playbook gap render — never "—" beside a real target (D2 fix) | Accepted | 2026-06-13 |
| 045 | Per-subdomain §3 framework anchors (D1 Option A) | Accepted | 2026-06-15 |
| 046 | Prompt caching for the citation extractor (cost control) | Accepted | 2026-06-15 |
| 047 | Advisory content-judge (D5) | Accepted | 2026-06-15 |
| 048 | Workbook as narrative cards + CSV (the #1 content gap) | Accepted | 2026-06-15 |
| 049 | Roadmap action drafter — both muscles (B) | Accepted | 2026-06-15 |
| 050 | Deterministic roadmap risk register + RACI (B2) | Accepted | 2026-06-15 |
| 051 | Wire the D5 advisory judge into the curation UI (C) | Accepted | 2026-06-15 |
| 052 | Workbook per-question prose (both muscles) | Accepted | 2026-06-16 |
| 053 | Admin compass-authoring CRUD — E1 Browse (read-only) | Accepted | 2026-06-16 |
| 054 | Admin compass-authoring CRUD — E2 Weights overlay | Accepted | 2026-06-16 |
| 055 | Advisory answer insight for the assessment respondent | Accepted | 2026-06-17 |
| 056 | Admin compass-authoring CRUD — E2.5 Question weights overlay | Accepted | 2026-06-18 |
| 057 | Admin compass-authoring CRUD — E3 Question content overlay | Accepted | 2026-06-19 |
| 058 | Overlay-active runs carry their calibration into the deliverable | Accepted | 2026-06-19 |
| 059 | The compass overlay must reach the respondent wizard (B1/H1 fix) | Accepted | 2026-06-19 |
| 060 | NIST CSF 2.0 Capability Compass (the 4th compass) | Accepted (2026-06-25) | 2026-06-25 |
| 061 | ReviewCockpit — reusable admin triage component | Accepted (2026-06-25) | 2026-06-25 |
| 062 | Self-service data export + account deletion (V1.1 privacy sub-features) | Accepted (2026-06-30) | 2026-06-30 |
| 063 | Session revocation — active-session list + "sign out everywhere" | Accepted (2026-07-01) | 2026-07-01 |
| 064 | COBIT 2019 compass — first standards-batch migration from compass-platform | Accepted (2026-07-01) | 2026-07-01 |
| 065 | ITIL 5 compass — authored from verified official structure | Accepted (2026-07-01) | 2026-07-01 |
| 066 | ISO 27001 compass — standards-batch port | Accepted (2026-07-01) | 2026-07-01 |
| 067 | TOGAF compass — standards-batch port | Accepted (2026-07-01) | 2026-07-01 |
| 068 | DAMA-DMBOK compass — standards-batch port (batch complete) | Accepted (2026-07-01) | 2026-07-01 |
| 069 | Software Engineering & AI-Augmented Delivery compass — IT-operational wave (1/5) | Accepted (2026-07-17) | 2026-07-17 |
| 070 | AI & Innovation compass — IT-operational wave (2/5) | Accepted (2026-07-17) | 2026-07-17 |
| 071 | IT Strategy & Governance compass — IT-operational wave (3/5) | Accepted (2026-07-17) | 2026-07-17 |
| 072 | Customer Analytics & Data compass — IT-operational wave (4/5) | Accepted (2026-07-17) | 2026-07-17 |
| 073 | Project, Program & Portfolio Management (P3M) compass — IT-operational wave (5/5, wave complete) | Accepted (2026-07-17) | 2026-07-17 |
| 074 | Digital Resilience compass — Business wave (1/2) | Accepted (2026-07-17) | 2026-07-17 |
| 075 | Corporate AI Readiness compass — Business wave (2/2, wave complete) | Accepted (2026-07-17) | 2026-07-17 |
| 076 | Vibe Coder & AI-Augmented Engineer compass — Career wave (1/7) | Accepted (2026-07-17) | 2026-07-17 |
| 077 | Product Manager Track compass — Career wave (2/7) | Accepted (2026-07-17) | 2026-07-17 |
| 078 | Data Scientist Track compass — Career wave (3/7) | Accepted (2026-07-17) | 2026-07-17 |
| 079 | UX Designer Track compass — Career wave (4/7) | Accepted (2026-07-17) | 2026-07-17 |
| 080 | Solo Founder Readiness compass — Career wave (5/7) | Accepted (2026-07-17) | 2026-07-17 |
| 081 | AI Architect Career Compass — Career wave (6/7) | Accepted (2026-07-17) | 2026-07-17 |
| 082 | Mid-career Switch Readiness compass — Career wave (7/7, wave complete) | Accepted (2026-07-17) | 2026-07-17 |
| 083 | ETC Master Compass — full compass catalog migration complete | Accepted (2026-07-17) | 2026-07-17 |
| 084 | Sign-in OAuth: popup, not redirect — reverses a compass-platform lesson | Accepted (2026-07-23) | 2026-07-23 |
| 085 | Assessment depth & mix (Pulse/Deep question-run sizing + continuous-scale closed-form rendering) | Accepted (2026-07-27 · founder-locked, revision 1 — content-port scope, | 2026-07-27 |
| 086 | GDS (Gerçek Doğrulama Sistemi): WHEN × WHAT × WHO, plus artifact-drift and scope-creep guards | Proposed | 2026-07-29 |
| 087 | Unify Handoff into the Action Pipeline: platform-development vs compass-dependent actions | Proposed | 2026-07-29 |
| 088 | A marker's framework citation becomes a typed reference; `tags` keeps its own vocabulary | accepted | 2026-08-10 |
| 089 | A compass may be defined by data, alongside the twenty-four defined by code | Accepted (founder, 2026-08-10) | 2026-08-10 |
| 090 | A measurement is a round, and a session is what a round leaves behind | Accepted (founder, 2026-08-17). Specified in [SRS-rounds-amendment-1](../../product/SRS-rounds-amendment-1.md). | 2026-08-17 |
| 091 | A marker's band ladder must say something about that marker | Accepted (founder, 2026-08-18) — option C. Applied the same day by | 2026-08-18 |
| 092 | A question's citation should be a typed reference, not a prefix convention | Accepted (founder, 2026-08-19) — option 2, corrected: aliases first, then | 2026-08-19 |
| 093 | A question declares how it is answered; the directory stops deciding | Accepted (founder, 2026-08-20) — *"Soru tiplerini de soru bazında veritabanında | 2026-08-20 |
| 094 | Cybersecurity's mode split, after every domain gets both instruments | WITHDRAWN, undeployed (founder, 2026-08-20). Superseded by | 2026-08-20 |
| 095 | The question's voice decides its widget; cybersecurity's calibration is not spent to fix it | Accepted (founder, 2026-08-20 — chose option 3 over splitting the subdomains). | 2026-08-20 |
| 096 | Rename the cybersecurity subdomain "Cyber Governance & Risk Management" to "Security Awareness & Culture" | Active | 2026-08-24 |
| 097 | Re-mass the stochastic prior: Dirichlet(1,1,1,1,1) → Dirichlet(0.25,…) | Active | 2026-08-24 |
Generated at build time from docs/architecture/decisions/ADR-*.md — the file is the source of truth, this table is a read-only projection of it.
The five things the engine will not negotiate
Most of the engine is configurable. Exactly five things are not. They are the reason a measure means the same thing across every compass:
- The four-step method — As-Is → To-Be → Gap → Roadmap. The skeleton does not bend.
- Three epistemology modes — deterministic, stochastic, composite. A fourth needs an ADR.
- The 1.0–5.0 maturity scale — the words per band can be tuned; the numbers cannot.
- Behavioral evidence with a deterministic floor — the canonical stochastic implementation.
- Audit logging — every interpretation, challenge, and update, recorded. Not optional.
Everything else — endpoints, names, defaults, adapters — can change under ordinary decision discipline. These five change only with a major version and explicit owner approval.
using kerte
If you want to use it
Most teams run it here. Anything beyond that — your own methodology carried by the same engine — is a conversation. One door covers it.