Allowed in docs/ (+1)
Allowed in docs/
| Content Type | Location |
|---|---|
| Reference docs — explains how a module works | docs/modules/<domain>/ or docs/domains/<domain>/ |
| How-to guides for humans | docs/guides/ |
| API documentation | docs/api/ |
| Data source descriptions | docs/data-sources/ |
| Migration guides | docs/guides/migration-*.md |
| Domain-specific references | docs/<domain>/ (e.g., docs/hse/, docs/petrophysics/) |
NOT Allowed in docs/
| Misplaced File | Correct Location |
|---|---|
AGENT_OS_COMMANDS.md |
DELETE (agent_os is archived) |
MANDATORY_SLASH_COMMAND_ECOSYSTEM.md |
.Codex/docs/ or DELETE |
AI_AGENT_ORCHESTRATION.md |
.Codex/docs/ai-orchestration.md |
AI_USAGE_GUIDELINES.md |
.Codex/docs/ if agent-facing, else docs/guides/ |
sub_ai/ directory |
.Codex/docs/ |
raw_data/ |
data/<domain>/ |
prompt-review/ |
.Codex/docs/ or delete |
| WRK deliverable reports | workspace-hub/.Codex/work-queue/done/ |
| Session notes | .Codex/docs/ or delete |
Rule: If a file in docs/ contains slash commands, agent protocols, or provider instructions, it belongs in .Codex/docs/, not docs/.