File Placement Rules

🚨 ZERO TOLERANCE FILE PLACEMENT 🚨

STRICT RULES

• * ❌ FORBIDDEN: Creating .md files in /Users/tobymorning/Desktop/core/ (except README.md, CLAUDE.md)
• ❌ FORBIDDEN: Creating .md files in /Users/tobymorning/Desktop/core/src/backend/ (except README.md)
• ❌ FORBIDDEN: Creating .md files in /Users/tobymorning/Desktop/core/AINative-website/ (except README.md, CLAUDE.md)
• ❌ FORBIDDEN: Creating scripts (.sh) in /Users/tobymorning/Desktop/core/src/backend/ (except start.sh)

REQUIRED LOCATIONS

Backend Documentation → /Users/tobymorning/Desktop/core/docs/

• * Issues/Bugs: docs/issues/ISSUE_*.md, docs/issues/BUG_*.md, INLINECODE7
• Testing/QA: docs/testing/*_TEST*.md, INLINECODE9
• Agent Swarm: docs/agent-swarm/AGENT_SWARM_*.md, docs/agent-swarm/WORKFLOW_*.md, INLINECODE12
• API Documentation: docs/api/API_*.md, INLINECODE14
• Implementation Reports: docs/reports/*_IMPLEMENTATION*.md, INLINECODE16
• Deployment: docs/deployment/DEPLOYMENT_*.md, INLINECODE18
• Quick References: docs/quick-reference/*_QUICK_*.md, docs/quick-reference/*_REFERENCE.md, INLINECODE21
• Backend Features: docs/backend/RLHF_*.md, docs/backend/MEMORY_*.md, INLINECODE24
• Development Guides: docs/development-guides/CODING_*.md, docs/development-guides/*_GUIDE.md, INLINECODE27
• Planning: docs/planning/PRD_*.md, INLINECODE29

Frontend Documentation → /Users/tobymorning/Desktop/core/AINative-website/docs/

• * Frontend Features: INLINECODE31
• Frontend Testing: INLINECODE32
• Frontend Implementation: INLINECODE33
• Frontend Issues: INLINECODE34
• Frontend Deployment: INLINECODE35
• Frontend Reports: INLINECODE36

Scripts → /Users/tobymorning/Desktop/core/scripts/

• * ALL test scripts: INLINECODE38
• ALL migration scripts: INLINECODE39
• ALL monitoring scripts: INLINECODE40
• ALL utility scripts: INLINECODE41

ENFORCEMENT WORKFLOW

Before creating ANY .md file or .sh script, you MUST:

1. 1. ✅ Check if you're creating it in a root directory
2. ✅ If yes, STOP and use the appropriate docs/ or scripts/ subfolder
3. ✅ Choose the correct category based on filename patterns above
4. ✅ Create in the correct location FIRST TIME, not in root then move later

VIOLATION CONSEQUENCES

Creating documentation in root directories causes:

• * Project clutter and disorganization
• Wasted time reorganizing files
• Inconsistent documentation structure
• Developer frustration
• Loss of findability for important docs

THIS IS A ZERO-TOLERANCE RULE. ALWAYS use docs/ or scripts/ subfolders.

Reference Files

See references/directory-mapping.md for complete mapping table of filename patterns to required directory locations.