| name | repo-structure-allowed-in-docs |
| description | Sub-skill of repo-structure: Allowed in docs/ (+1). |
| version | 1.4.0 |
| category | workspace |
| type | reference |
| scripts_exempt | true |
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/.
