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, docs/issues/ROOT_CAUSE_*.md
• Testing/QA: docs/testing/*_TEST*.md, docs/testing/QA_*.md
• Agent Swarm: docs/agent-swarm/AGENT_SWARM_*.md, docs/agent-swarm/WORKFLOW_*.md, docs/agent-swarm/STAGE_*.md
• API Documentation: docs/api/API_*.md, docs/api/*_ENDPOINTS*.md
• Implementation Reports: docs/reports/*_IMPLEMENTATION*.md, docs/reports/*_SUMMARY.md
• Deployment: docs/deployment/DEPLOYMENT_*.md, docs/deployment/RAILWAY_*.md
• Quick References: docs/quick-reference/*_QUICK_*.md, docs/quick-reference/*_REFERENCE.md, docs/quick-reference/STEPS_*.md
• Backend Features: docs/backend/RLHF_*.md, docs/backend/MEMORY_*.md, docs/backend/SECURITY_*.md
• Development Guides: docs/development-guides/CODING_*.md, docs/development-guides/*_GUIDE.md, docs/guides/*_INSTRUCTIONS.md
• Planning: docs/planning/PRD_*.md, docs/planning/BACKLOG*.md

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

• Frontend Features: AINative-website/docs/features/
• Frontend Testing: AINative-website/docs/testing/
• Frontend Implementation: AINative-website/docs/implementation/
• Frontend Issues: AINative-website/docs/issues/
• Frontend Deployment: AINative-website/docs/deployment/
• Frontend Reports: AINative-website/docs/reports/

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

• ALL test scripts: scripts/test_*.sh
• ALL migration scripts: scripts/*_migration.sh
• ALL monitoring scripts: scripts/monitor_*.sh
• ALL utility scripts: scripts/*.sh

ENFORCEMENT WORKFLOW#

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

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.