docs/ is the source of truth for repository contracts.
Each project must have one project index document and one or more domain contract documents.
- These rules apply to documentation authoring and editing work, not general conversational summaries.
- Do not arbitrarily omit, delete, or simplify requested or source-backed content during documentation edits unless the user explicitly asks for that outcome.
- If documentation content, scope, or intent is ambiguous, ask the user before deciding what to remove, merge, or reinterpret.
- If a documentation change affects repository or domain policy boundaries, update or create the relevant
AGENTS.mdfile in the same change when needed.
- Project index docs:
docs/project-<project-id>.md - Domain contract docs:
docs/<domain>-<project-or-component>-<contract>.md - Domain prefix must be one of:
apps,cmds,servers,crates,protos,packages - Use lowercase kebab-case identifiers and stable enum-style IDs in contract sections.
docs/project-template.md: template for project index docsdocs/domain-template.md: template for domain contract docs
docs/project-cargo-mono.mddocs/crates-cargo-mono-foundation.md
docs/project-nodeup.mddocs/crates-nodeup-foundation.md
docs/project-with-watch.mddocs/crates-with-watch-foundation.md
docs/project-derun.mddocs/cmds-derun-foundation.md
docs/project-mpapp.mddocs/apps-mpapp-foundation.md
docs/project-devkit.mddocs/apps-devkit-foundation.md
docs/project-devkit-remote-file-picker.mddocs/apps-devkit-remote-file-picker-foundation.md
docs/project-public-docs.mddocs/apps-public-docs-foundation.md
docs/project-devkit-commit-tracker.mddocs/apps-devkit-commit-tracker-web-app-foundation.md
docs/project-thenv.mddocs/apps-thenv-web-console-foundation.mddocs/servers-thenv-server-foundation.mddocs/cmds-thenv-cli-foundation.md
docs/project-serde-feather.mddocs/crates-serde-feather-core-foundation.mddocs/crates-serde-feather-macros-foundation.md
docs/project-rustia.mddocs/crates-rustia-core-foundation.mddocs/crates-rustia-llm-foundation.mddocs/crates-rustia-macros-foundation.md
docs/project-dexdex.mddocs/apps-dexdex-desktop-app-foundation.mddocs/apps-dexdex-ui-contract.mddocs/apps-dexdex-user-guide-contract.mddocs/apps-dexdex-notification-contract.mddocs/apps-dexdex-workspace-connectivity-contract.mddocs/servers-dexdex-main-server-foundation.mddocs/servers-dexdex-worker-server-foundation.mddocs/servers-dexdex-event-streaming-contract.mddocs/servers-dexdex-pr-management-contract.mddocs/protos-dexdex-v1-contract.mddocs/protos-dexdex-api-contract.mddocs/protos-dexdex-entities-contract.mddocs/protos-dexdex-plan-mode-contract.md
docs/project-ttl.mddocs/cmds-ttl-foundation.mddocs/cmds-ttl-language-contract.md