Shared Operational Docs¶
This directory contains deeper operational docs used by both humans and coding agents.
Use this docs tree for information that is too detailed or too volatile for AGENTS.md.
Documents¶
init-cli-spec.md: pointer to the shared canonical init CLI reference indocs/init.mdverification.md: required local/CI verification loopworktrees.md: parallel branch + worktree workflowroadmap.md: near-term harness and refactor prioritiestopology.md: documentation and repo topology guidanceci-tests-plan.md: narrow next-step plan for harness parity and docs invariantscli-usability-plan.md: CLI agent-usability improvement plandata-io-contract-plan.md: data I/O contract and refactor plantrain-config-plan.md: training/config refactor plan for experiment throughputpackage-topology-spec.md: target package organization and module-boundary specpackage-topology-migration-plan.md: staged migration plan toward the target package topology
Philosophy¶
AGENTS.mdis the entrypoint for repository workflow.- Documentation should be shared across humans and agents whenever possible.
- New durable rules should prefer tests, CI, or scripts over prose alone.