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

2.7 KiB Raw Blame History