2.7 KiB
2.7 KiB
Workspace Structure — Quick Reference
Updated: 2026-02-18 after hierarchical memory migration
Root Files (Core Config)
| File | Purpose | Load on Startup? |
|---|---|---|
| MEMORY.md | 🆕 Lightweight index (~2.4k tokens) | ✅ YES |
| IDENTITY.md | Who I am (name, vibe, emoji) | ✅ YES |
| SOUL.md | How I behave (principles) | ✅ YES |
| USER.md | Who you are (Corey) | ✅ YES |
| AGENTS.md | Agent behavior rules | ✅ YES |
| HEARTBEAT.md | Periodic tasks | ✅ YES |
| TOOLS.md | Your specific tool configs | ✅ YES |
| SECURITY.md | Security rules | ✅ YES |
| workspace-context.md | Daily temp state | ✅ YES |
memory/ Directory (Drill-Down Details)
memory/
├── people/
│ └── corey.md # Your profile, preferences
├── projects/
│ ├── home-assistant.md # HA, room-assistant, sensors
│ ├── coding-workflow.md # Git, repos, LAMP stack
│ ├── discord-voice-bot.md # GLaDOS voice bot
│ └── memory-system.md # Meta: how memory works
├── decisions/
│ └── 2026-02.md # February decision log
├── context/ # (empty, ready for temp files)
└── 2026-*.md # Daily notes (unchanged)
Drill down when: Conversation mentions project/person/decision
Other Key Folders
| Folder | Contents |
|---|---|
| .learnings/ | ERRORS.md, LEARNINGS.md, FEATURE_REQUESTS.md |
| unused_files/ | Archived old files (transcripts, duplicates) |
| temp/ | Working scripts, temporary files |
| scripts/ | Helper scripts (backup-memory.py, etc.) |
Documentation Files
| File | What It Documents |
|---|---|
| MEMORY_MIGRATION_LOG.md | What changed in the rebuild |
| MEMORY_SYSTEM_ARCHITECTURE.md | How the full system works |
| CRON_REPORT_TEMPLATE.md | Standard format for reports |
| FUTURE_WORKER_IDEAS.md | Future agent ideas |
| WORKSPACE_STRUCTURE.md | This file — quick reference |
Token Load Comparison
| Scenario | Before | After | Savings |
|---|---|---|---|
| Session start | 5-10k tokens | ~2.4k tokens | 60-70% |
| Drill down 1 project | N/A | +~1k tokens | On-demand |
| Full context load | 15-20k tokens | ~5-6k tokens | 70% |
Quick Actions
Need project details? → Check memory/projects/[name].md
Need user preferences? → Check memory/people/corey.md
Need why we decided X? → Check memory/decisions/2026-02.md
Need what happened today? → Check memory/2026-02-18.md
Need system architecture? → Check MEMORY_SYSTEM_ARCHITECTURE.md
System Version: Hierarchical v1.0 Migration Date: 2026-02-18