# Repo Structure Allowed In Docs

> Sub-skill of repo-structure: Allowed in docs/ (+1).

- Skill: `vamseeachanta/repo-structure-allowed-in-docs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/repo-structure-allowed-in-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/repo-structure-allowed-in-docs/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/repo-structure-allowed-in-docs

---


# 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/`.

---