File: architecture/AGENTS.md
Disposition: NEW
Authority basis: docs/authority/zeus_current_architecture.md; docs/authority/zeus_current_delivery.md; docs/authority/zeus_change_control_constitution.md; architecture/kernel_manifest.yaml; architecture/invariants.yaml; architecture/zones.yaml; architecture/negative_constraints.yaml; architecture/maturity_model.yaml.
Supersedes / harmonizes: informal architecture claims in historical docs.
Why this file exists now: this is the K0/K1 law zone and needs narrower instructions than the repo root.
Current-phase or long-lived: Long-lived.

# architecture AGENTS

This directory contains machine-checkable and constitutional authority surfaces.

Module book: `docs/reference/modules/topology_system.md`

## Treat this zone as high sensitivity
Changes here are architecture or governance changes, never “just docs.”

## Required before edit
- approved packet
- explicit invariant references
- list of touched authority surfaces
- statement of what existing surface this change harmonizes or supersedes

## Do
- keep manifests, constitution, and spec mutually consistent
- prefer delta over rewrite
- preserve descriptive vs normative distinction
- record migration drift instead of hiding it

## Do not
- create parallel authority files
- copy historical rationale into active law without saying so
- claim runtime convergence unless current code actually matches
- widen semantics by convenience

## File registry

| File | Purpose |
|------|---------|
| `kernel_manifest.yaml` | Kernel file ownership and protection rules |
| `invariants.yaml` | 10 invariant definitions (INV-01 through INV-10) |
| `zones.yaml` | Zone definitions with import rules (K0-K4) |
| `negative_constraints.yaml` | 10 negative constraint definitions |
| `maturity_model.yaml` | Maturity model definitions |
| `topology_schema.yaml` | Schema for compiled topology graph nodes, enums, and strict issue codes |
| `topology.yaml` | Initial compiled topology graph for root/src/tests/scripts/docs/config/CI/state/runtime/shadow surfaces |
| `source_rationale.yaml` | Per-file rationale map for tracked `src/**` files, hazards, and write-route cards |
| `test_topology.yaml` | Test-suite topology manifest: law gate, categories, high-sensitivity skips, reverse-antibody status |
| `script_manifest.yaml` | Script manifest with authority class, write targets, dry-run/apply metadata, and safety gates |
| `naming_conventions.yaml` | Canonical file/function naming and script/test freshness metadata map |
| `data_rebuild_topology.yaml` | Data/rebuild certification criteria and non-promotion topology |
| `history_lore.yaml` | Dense historical lore registry: failure modes, wrong moves, antibodies, residual risks, and task routing |
| `artifact_lifecycle.yaml` | Artifact classification and minimum work-record contract |
| `context_budget.yaml` | Context budget and maintenance cadence for keeping entry maps/digests slim |
| `module_manifest.yaml` | Machine registry for dense module books, module routers, and module-level law/current-fact/test links; now includes R3 CutoverGuard, venue adapter, user-channel ingest, strategy benchmark, and risk allocator/governor routes |
| `context_pack_profiles.yaml` | Task-shaped context-pack profiles for generated agent work packets |
| `task_boot_profiles.yaml` | Question-first semantic boot profiles for source/settlement/hourly/Day0/calibration/docs/graph tasks |
| `fatal_misreads.yaml` | Machine-readable fatal semantic shortcut antibodies |
| `city_truth_contract.yaml` | Stable city/source/date truth contract schema and evidence taxonomy |
| `code_review_graph_protocol.yaml` | DEPRECATED 2026-04-28 (validator stub only). Authoritative summary inlined in root AGENTS.md §Code Review Graph per round2_verdict.md §1.1 #9. Full removal pending script-aware batch. |
| `change_receipt_schema.yaml` | Machine-readable route/change receipt contract for high-risk closeout |
| `code_idioms.yaml` | Registry for intentional non-obvious code shapes such as static-analysis hooks |
| `core_claims.yaml` | Proof-backed semantic claims emitted by generated topology views |
| `runtime_modes.yaml` | Discovery mode index: opening_hunt, update_reaction, day0_capture |
| `reference_replacement.yaml` | Replacement matrix for bulky reference docs and deletion eligibility |
| `docs_registry.yaml` | Machine-readable docs classification registry and default-read contract |
| `map_maintenance.yaml` | Companion-registry rules for added/deleted files in active surfaces |
| `lifecycle_grammar.md` | Lifecycle grammar specification |
| `2026_04_02_architecture_kernel.sql` | Canonical event/projection schema — position_events, position_current, strategy_health, risk_actions, control_overrides, fact tables |
| `self_check/zero_context_entry.md` | Zero-context agent entry checklist |
| `ast_rules/semgrep_zeus.yml` | Semgrep rules for code enforcement |
| `ast_rules/forbidden_patterns.md` | Forbidden code patterns |
| `packet_templates/*.md` | Work packet templates (bugfix, feature, refactor, schema) |
| `worktree_merge_protocol.yaml` | Cross-session merge protocol per Stage 4 Gate B (verdict.md §6) — conflict-first merge inspection; MERGE_AUDIT_EVIDENCE critic verdict required only for escalated broad/high-risk conflict surfaces |
| `world_schema_manifest.yaml` | World DB schema manifest: per-table column inventory and schema authority for two-system independence (created 2026-04-30) |
| `preflight_overrides_2026-04-28.yaml` | Operator-approved preflight drift overrides for WU ICAO history residuals (schema_version 1; created 2026-04-28) |
| `inv_prototype.py` | @enforced_by decorator prototype for round-2 §H1 INV annotation experiment (created 2026-04-28) |
| `world_schema_version.yaml` | World DB schema version sentinel for two-system independence axis 4 (created 2026-05-01) |
| `runtime_posture.yaml` | Runtime posture YAML — read-only at runtime per INV-26 (created 2026-04-26) |
| `scope_schema.json` | JSON Schema for Zeus packet scope.yaml sidecar; machine-read by zpkt and pre-commit hook |
| `digest_profiles.py` | Auto-generated digest profiles for topology_doctor — DO NOT EDIT BY HAND; regenerated from topology.yaml |
| `paris_station_resolution_2026-05-01.yaml` | Operator decision 2026-05-01: Paris Polymarket settlement station is LFPB (not LFPG) |

## Subdirectory navigation

Each subdirectory has its own `AGENTS.md` with file registry and rules:

| Subdirectory | AGENTS.md | Purpose |
|--------------|-----------|---------|
| `ast_rules/` | `ast_rules/AGENTS.md` | AST-level enforcement rules (Semgrep + forbidden patterns) |
| `packet_templates/` | `packet_templates/AGENTS.md` | Work packet templates for change classification |
| `self_check/` | `self_check/AGENTS.md` | Agent entry checklists |

## Review rule
At least one independent verifier must read the final diff before acceptance.