This directory is the progressive-disclosure entry point for WrightKit-wide durable documentation. The repository root README stays concise and routes here; load only the policy or contract relevant to the task.
- WrightKit goal — durable product intent, priorities, success outcomes, and deliberate non-goals.
- Documentation management — documentation layout, progressive disclosure, synchronization, and drift audits.
- Engineering quality — implementation quality, simplicity, locality, readability, and durable-vs-dynamic knowledge.
- Issue readiness and implementation preflight — task readiness, verifiable outcomes, and public-boundary continuity.
- PR review and review-fix handoff — one-pass review, findings, thread handling, and re-review.
- Testing policy — testing entry point: core test principles, test organization, fixtures, and routing to the narrower testing documents.
- Compatibility and reference testing — upstream-compiler structural convergence, raw Workshop/locale semantic compatibility, oracle gaps, and real-project regressions and corpora.
- Robustness testing — adversarial input and fuzzing.
- Verification and acceptance — verification boundaries, merge-time CI acceptance, independent verification, and PR expectations.
- Entropy policy — removal, consolidation, and post-wave cleanup.
- CI platform — shared CI platform boundaries.
- Rust CI — Rust job composition, caching, and toolchains.
- Rust build artifacts — local/worktree build storage.
- Release engineering — tagging, packaging, and publication.
- Agent guidance — durable agent-instruction design.
- Codex Cloud — WrightKit shared-context bootstrap and cloud workspace routing.
Repository-local documentation remains authoritative for repository-specific contracts. ADRs preserve decision history; source, tests, CI, releases, Issues, and PRs establish current execution reality.