Ghostlight/notes/documentation-inventory.md

# Documentation Inventory

Use this file as the navigation map for Ghostlight's docs. It classifies files
by job so architecture, planning, prompts, state ledgers, and live examples do
not slowly melt into one cursed binder.

## Canonical Re-Entry And Planning

- `state/map.yaml`: canonical project map and current status.
- `notes/fresh-workspace-handoff.md`: re-entry summary for fresh sessions.
- `notes/ghostlight-current-system-map.md`: current runtime and artifact map.
- `notes/ghostlight-implementation-plan.md`: live implementation plan and
  next-action surface.
- `notes/documentation-inventory.md`: this navigation/status index.

## Core Architecture Contracts

- `docs/architecture/ghostlight-dungeon-mvp.md`: hosted dungeon authority and
  runtime map.
- `docs/architecture/ghostlight-multiresolution-agency.md`: dynamic agency
  graph, connected cohesive/arena covers, detail fairness, cell waves, fission,
  controls, and atomicity.
- `docs/architecture/ghostlight-dungeon-multiplayer-intention.md`: bounded
  post-MVP extension of the campaign kernel to multiple human-controlled actors,
  including authority, privacy, concurrency, and unresolved social policy.
- `docs/architecture/canonical-agent-state-schema.md`: canonical state model.
- `docs/architecture/agent-state-variable-glossary.md`: meanings for state
  axes, voice style, overlays, and emergent behaviors.
- `docs/architecture/agent-state-distributions-and-prompt-projection.md`:
  deeper state-distribution and projection rationale.
- `docs/architecture/prompt-projection-contract.md`: projection boundary and
  renderer contract.
- `docs/architecture/projected-local-context.md`: character-local context
  shape.
- `docs/architecture/sequential-agent-runtime.md`: sequential action/reaction
  runtime architecture.
- `docs/architecture/sandboxed-responder-packets.md`: isolated responder packet
  contract and capture requirements.
- `docs/architecture/soft-model-training-artifacts.md`: rule for turning soft
  judgments into training artifacts.
- `docs/architecture/ink-branching-scenes.md`: branch-and-fold, branch
  compiler, visual prompt, and IF reviewer contract.
- `docs/architecture/illustrated-if-visual-pipeline.md`: visual replay
  contract, geometry authority, scene-set/blockout role, and imagegen boundary.
- `docs/architecture/lore-grounding-digest-format.md`: source-grounding digest
  format.
- `docs/architecture/aetheria-lore-grounding-architecture.md`: Aetheria
  historical, future-branch, and procedural grounding boundaries.
- `docs/architecture/corpus-coverage-ledger.md`: corpus coverage ledger
  contract and status-report shape.
- `docs/architecture/technology-item-manifest-plan.md`: item, assembly,
  supply-chain, trade-good, and blueprint data target.
- `docs/architecture/training-plan.md`: trainable organs, datasets, gates, and
  rough scale targets.

## Supporting Architecture And Future Mechanisms

- `docs/architecture/aetheria-agent-population-model.md`: population and
  faction-scale agent modeling.
- `docs/architecture/aetheria-content-generation-targets.md`: Aetheria content
  targets and consumer use cases.
- `docs/architecture/aetheria-persistent-agent-architecture.md`: broader
  persistent-agent architecture.
- `docs/architecture/projection-distillation-plan.md`: student projector
  training concept.
- `docs/architecture/schema-future-mechanisms.md`: future schema organs waiting
  for more evidence.
- `notes/architecture-rationale.md`: rationale notes for major design
  boundaries.

## Accessible Explanations

- `docs/public-architecture/`: canonical source for the public Ghostlight site
  architecture section: overview, authority, pipelines, and the complete
  production agent/model-stage catalog. The site publishes an exact projection
  and owns navigation and presentation, not technical truth.
- `docs/articles/multiresolution-gestalts.md`: reader-facing explanation of
  Ghostlight Dungeon's dynamic agency graph, cohesive and arena cells, detail
  fairness, Persona waves, and named-character continuity.

## Raw Imported Source

- `docs/aetheria/call-of-the-void-brainstorm.md`: raw imported brainstorming
  document. Encoding scars are preserved; do not treat this as canonical prose.

## Research Backlog

- `docs/research/personality-model-roadmap.md`: personality-model research
  roadmap.
- `docs/research/personality-signal-classifier.md`: personality signal
  classifier research.
- `docs/research/things-to-steal.md`: research backlog and candidate ideas.

## State Ledgers

- `state/evidence.jsonl`: distilled current evidence ledger.
- `state/evidence.archive.jsonl`: archival evidence ledger.
- `state/branches.json`: branch ledger.
- `state/corpus-coverage.json`: machine-readable coverage ledger for accepted,
  draft, planned, rejected, and superseded Aetheria fixtures.
- `state/scratch.md`: disposable one-subgoal scratch surface.

## Maintenance Rule

Architecture docs describe durable contracts. Live planning belongs in
`notes/ghostlight-implementation-plan.md`, `notes/fresh-workspace-handoff.md`,
and `state/map.yaml`. Experimental fixture receipts are not kept in the live
workspace once their lessons have been distilled into docs, state, or git
history.