372bdf987d
Phase 6 of the holistic assessment: what follows from it, and what it needs ruled before anything else can be sequenced. `50-execution-plan.md` — five waves (scrub/rule → delete → simplify/enforce → accelerate evidence loops → automate last) plus five frontier tracks, covering every G-1…G-20 and H-1…H-12 entry, with four hard dependency gates and nine risks stated before they are incurred. `50-rulings.md` — R-1…R-14. One decision per section: the evidence verified ated06dd64, the options enumerated, a recommendation with its reasoning, and the exact diff that follows from each choice, so ruling costs one word. Nothing in it recommends reversing a ratified decision; R-12 amends two ADRs' records without touching either decision. §0 of the plan carries SEVEN corrections to the assessment, all found by reading code, workflows and ADR supersession banners — none by re-reading documents. Four change planned work: - N-3 (new) the local smoke suite (23 files) and smoke.yml (13) have diverged by 10 files. Severity is LOWER than this plan's first draft stated: AGENTS.md makes the in-worktree run the merge gate and CI secondary observability, and the local gate is the superset — so nothing is unguarded. What is real is one in-code comment claiming an equality that does not hold, and the push that skipped the local gate, for which CI is the only automatic check. - N-4 the L10 soak HAS been run — 5000 beats, reboot at 2500, all four gates pass (contract.md, landedaed273b1). G-5's "never produced an artifact" is wrong. The debt is the ceremony: no committed report, no pinned deterministic_digest (the contract's own unmet closing instruction), no cadence. Prose with no pinned digest is testimony, not evidence. - N-5 G-10's blocker does not exist. ADR-0264 §4.1 carries a self-supersession banner: R5 removed the 16-premise cap on 2026-07-26, and four bands would earn SERVE the moment a ledger is sealed. PR-13 is WITHDRAWN and the whole throughput frontier reduces to one ruling (R-8). - N-7 the flag count is 28 of 32 RuntimeConfig booleans, not seventeen. Plus N-1 (the orphan scan artifact: TEST_SUITES["full"] is a directory), N-2 (the L10 pins run twice a day, post-merge and nightly), and N-6 (H-8 has a fourth instance inside the code — two flag docstrings assert a production profile the production profile does not have, which moves R-3 decisively toward "incomplete flag set"). Docs only. No runtime behavior, no flag, no test changed.
25 lines
3.3 KiB
Markdown
25 lines
3.3 KiB
Markdown
# docs/assessment/ — The Holistic Macro→Micro Assessment (2026-07-27)
|
||
|
||
A read-only, evidence-bearing assessment of CORE's cognitive-cycle design versus implementation fulfillment, conducted under `docs/conceptualizing_engineering_mastery.md` at `forgejo/main` @ `8927c563`. Phases 0–5 change no runtime behavior, fix no defect, and decide nothing — they produce evidence and judgments for ruling. Phase 6 adds the execution plan built on them and the ruling packet they require.
|
||
|
||
**Start here:** [`40-assessment.md`](40-assessment.md) — the synthesis (the verdict, the five frontiers, the recommended attack order). Then [`50-execution-plan.md`](50-execution-plan.md) for what follows from it, and [`50-rulings.md`](50-rulings.md) for what is waiting on a decision. The registers rank the work; the cards are the evidence base.
|
||
|
||
| File / dir | Phase | What it is |
|
||
|---|---|---|
|
||
| [`00-scope-and-method.md`](00-scope-and-method.md) | — | Charter, method, rules of engagement, phase/executor table |
|
||
| [`01-phase0-ground-truth.md`](01-phase0-ground-truth.md) | 0 | Corpus triage, the five unreconciled articulations, system-map recovery |
|
||
| [`02-layer-taxonomy.md`](02-layer-taxonomy.md) | 1 | The two-axis taxonomy: 7 macro layers + 2 cross-cuts over 33 zones; the Candidate Register (CR-1…4); completeness criteria |
|
||
| [`03-card-schema.md`](03-card-schema.md) | 1 | The card metadata schema: liveness ⊥ fitness, design ⊥ build, sabotage-tested evidence, `verified_at` stamps |
|
||
| [`10-layer-cards/`](10-layer-cards/) | 2 | Nine layer cards (M0–M6, MG, MV), every liveness label re-verified against code |
|
||
| [`04-phase2-findings.md`](04-phase2-findings.md) | 2 | Stage-coverage audit; corrections to Phase 0; findings F-1…F-5 |
|
||
| [`20-component-cards/`](20-component-cards/) | 3 | Eight component cards: the four zero-subsystem zones + always-on, derivation organs, surface selection, attention |
|
||
| [`05-phase3-findings.md`](05-phase3-findings.md) | 3 | Corrections C-1…C-5; findings F-6…F-10; the consolidated Phase-4 seed list |
|
||
| [`30-gap-register.md`](30-gap-register.md) | 4 | **The live gap register** — 20 entries, 4 tiers, each with evidence + deciding authority (proposes superseding `docs/gaps.md`) |
|
||
| [`31-hindrance-audit.md`](31-hindrance-audit.md) | 4 | Eleven hindrances with fitness verdicts and better homes; five candidates examined and cleared |
|
||
| [`40-assessment.md`](40-assessment.md) | 5 | The synthesis |
|
||
| [`50-execution-plan.md`](50-execution-plan.md) | 6 | **The execution plan** — five waves + five frontier tracks over every G/H entry, with the dependency gates and the risks. §0 carries seven corrections to the assessment found while sizing it |
|
||
| [`50-rulings.md`](50-rulings.md) | 6 | **The ruling packet** — R-1…R-14, each with evidence, options, a recommendation, and the exact diff that follows from each choice. Wave 0's deliverable |
|
||
|
||
**Maintenance contract** (from §8 of the synthesis): a card whose `verified_at` falls behind a load-bearing arc is testimony, not evidence. Update cards when their subsystems move, or this directory becomes the next dead instrument it was built to replace.
|
||
|
||
**Standing note:** the PR #138 fabrication findings appear throughout as *measured & pinned, fix held for ADR + ratification* — recorded, never re-discovered, never fixed here, per explicit instruction.
|