Engineering notes

Internal engineering material organized into topic clusters. These notes capture in-flight design work, investigations, and triage; they are working artifacts for maintainers rather than end-user documentation.

Clusters

Live clusters:

Architectural review — design reviews and findings.
Findings — recorded engineering findings.
Reflections — retrospective engineering reflections.
Test-suite parallelization — CI shard topology status — point-in-time mission-status snapshot of the CI shard-topology re-flip, carved out of the durable testing-parallel.md how-to.

Additional live references: transient mission-scoped classifications (mission notes) and a preserved historical mission closeout (01KSMG8Y — Pre-Doctrine Test Stabilization).

Retired clusters (deprecated)

These clusters captured design/investigation work that has since shipped or been superseded; their pages are preserved as historical records with doc_status: deprecated (not live).

Runtime and state overhaul — retired (deprecated); design shipped as execution-context unification (#1619), open-core delivery plan §1.2.
Triage — retired (deprecated); closeout for merged mission test-stabilization-and-debt-pass-01KSF9HJ.
Infra/logic separation (2173-infra-logic-separation/) — retired (deprecated); Phase 1 shipped via merged mission runtime-bridge-degod-01KX8M1C (#2173 / #2531).
Surface-resolution work (3-2-3-surface-resolution-cluster/) — retired (deprecated); shipped in the 3.2.3 release.
Naming/identity SSOT (naming-identity-ssot-strangler/) — retired (deprecated); identity-primitive lower-layer move shipped, open-core delivery plan §1.2.

Field reports

Maintainer-facing narratives of a full run under the doctrine — process, operator decisions, and where the charter/ADRs/guides changed the outcome:

Doctrine-driven P0 remediation, end to end (2026-07-18) — remediating the merge-core P0 pair #2709/#2711 and fast-follow #2786; what the adversarial-squad cadence and the red-main / tracker-hygiene / seam docs actually bought.

Closing reports

One-time mission closeout records — final checks, disposition tables, and follow-up issue filings for a completed mission:

Docs IA & Onboarding Overhaul — Terminology Sweep & Closing Report — WP10's closing record for mission docs-ia-onboarding-overhaul-01KY02JB: the mission-wide terminology/glossary sweep, NFR-005 Divio frontmatter coverage check, and follow-up issue filing.

Pre-spec research

Durable records of profile-loaded pre-spec research squads, captured so a parked mission can resume without re-running the squad:

DRG completeness (#2843 / #2847) — pre-spec research squad findings — convergent 4-lens findings on the #2833 residue: relation-description parity, the activation-gate latent bug, and the anti-pattern corpus promotion split.
CSF #2670 landing-pass campsite follow-ups — pre-spec research — root-cause findings for the shard-map gap, xdist flake, sync remediation-guard, and mypy debt tickets under epic #1928.

Docs governance

Docs-wide structural baselines and concern audits — the durable record of where each doc kind belongs and what has drifted, replacing the retired anti-sprawl ratchet:

Common-Docs section audit (docs-wide structural concern baseline) — post-#2851 concern-bucket audit of every docs/ section (excl. development/ + guides/): misfiled files, redistribution tally, follow-up ticket proposals under #2314 bucket C, and the taxonomy recommendation for #2302.

Design notes

Durable design investigations that inform a convention or a future mission:

Agent knowledge: canonical homes — where rules (charter), practices (doctrine), reference (Common Docs), and learned facts (.kittify/memory/) belong; how to stop a per-agent memory duplicating the repo.
Coord-branch bookkeeping: read/write split-brain root-cause — retired (deprecated); delivered by merged mission coord-write-placement-closure-01KYCF83 (#2841). #2841 drift is unenforced write-placement (writers pick their own dir), not a broken partition contract; the single placement-port seam that makes wrong-partition writes unrepresentable at commit.
Coordination-branch trust & reconciliation model — mission scope — retired (deprecated); delivered by merged mission coord-write-placement-closure-01KYCF83 (#2841). The pre-spec scope for the coord-trust friction-remediation mission: Gap-1 staleness, Symptom-B gate exemption, and why reconciliation is a minimized fail-loud residual, not the centerpiece.