89 lines
2.7 KiB
Markdown
89 lines
2.7 KiB
Markdown
# 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*
|