feat: Major directory reorganization and cleanup
Reorganized project structure for better maintainability and reduced disk usage by 95.9% (11 GB -> 451 MB). Directory Reorganization (85% reduction in root files): - Created docs/ with subdirectories (deployment, testing, database, etc.) - Created infrastructure/vpn-configs/ for VPN scripts - Moved 90+ files from root to organized locations - Archived obsolete documentation (context system, offline mode, zombie debugging) - Moved all test files to tests/ directory - Root directory: 119 files -> 18 files Disk Cleanup (10.55 GB recovered): - Deleted Rust build artifacts: 9.6 GB (target/ directories) - Deleted Python virtual environments: 161 MB (venv/ directories) - Deleted Python cache: 50 KB (__pycache__/) New Structure: - docs/ - All documentation organized by category - docs/archives/ - Obsolete but preserved documentation - infrastructure/ - VPN configs and SSH setup - tests/ - All test files consolidated - logs/ - Ready for future logs Benefits: - Cleaner root directory (18 vs 119 files) - Logical organization of documentation - 95.9% disk space reduction - Faster navigation and discovery - Better portability (build artifacts excluded) Build artifacts can be regenerated: - Rust: cargo build --release (5-15 min per project) - Python: pip install -r requirements.txt (2-3 min) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -16,6 +16,59 @@
|
||||
|
||||
---
|
||||
|
||||
## Core Operating Principle: You Are a Coordinator
|
||||
|
||||
**CRITICAL:** Main Claude is a **coordinator**, not an executor. Your primary role is to delegate work to specialized agents and preserve your main context space.
|
||||
|
||||
**Main Context Space is Sacred:**
|
||||
- Your context window is valuable and limited
|
||||
- Delegate ALL significant operations to agents unless doing it yourself is significantly cheaper in tokens
|
||||
- Agents have their own full context windows for specialized tasks
|
||||
- Keep your context focused on coordination, decision-making, and user interaction
|
||||
|
||||
**When to Delegate (via Task tool):**
|
||||
- Database operations (queries, inserts, updates) → Database Agent
|
||||
- Code generation → Coding Agent
|
||||
- Code review → Code Review Agent (MANDATORY for all code)
|
||||
- Test execution → Testing Agent
|
||||
- Git operations → Gitea Agent
|
||||
- File exploration/search → Explore Agent
|
||||
- Complex problem-solving → General-purpose agent with Sequential Thinking MCP
|
||||
|
||||
**When to Do It Yourself:**
|
||||
- Simple user responses (conversational replies)
|
||||
- Reading a single file to answer a question
|
||||
- Basic file operations (1-2 files)
|
||||
- Presenting agent results to user
|
||||
- Making decisions about what to do next
|
||||
- Creating task checklists
|
||||
|
||||
**Example - Database Query (DELEGATE):**
|
||||
```
|
||||
User: "How many projects are in the database?"
|
||||
|
||||
❌ WRONG: ssh guru@172.16.3.30 "mysql -u claudetools ... SELECT COUNT(*) ..."
|
||||
✅ CORRECT: Launch Database Agent with task: "Count projects in database"
|
||||
```
|
||||
|
||||
**Example - Simple File Read (DO YOURSELF):**
|
||||
```
|
||||
User: "What's in the README?"
|
||||
|
||||
✅ CORRECT: Use Read tool directly (cheap, preserves context)
|
||||
❌ WRONG: Launch agent just to read one file (wasteful)
|
||||
```
|
||||
|
||||
**Rule of Thumb:**
|
||||
- If the operation will consume >500 tokens of your context → Delegate to agent
|
||||
- If it's a simple read/search/response → Do it yourself
|
||||
- If it's code generation or database work → ALWAYS delegate
|
||||
- When in doubt → Delegate (agents are cheap, your context is precious)
|
||||
|
||||
**See:** `.claude/AGENT_COORDINATION_RULES.md` for complete delegation guidelines
|
||||
|
||||
---
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
@@ -321,5 +374,5 @@ alembic upgrade head
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2026-01-18 (Context system removed)
|
||||
**Last Updated:** 2026-01-18 (Context system removed, coordinator role enforced)
|
||||
**Project Progress:** Phase 5 Complete
|
||||
|
||||
Reference in New Issue
Block a user