109 lines
5.1 KiB
Markdown
109 lines
5.1 KiB
Markdown
# 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.
|