04 Workspace_
Your workspace is where your agent learns how you think. Structure it intentionally, and the agent can move with precision and care.
Slow Down First
Before organizing anything, ask your agent: What am I building here? What will I be doing most often? What does the agent need to find quickly?
Different projects need different shapes:
- Software development: Deep folder structure, with source code organized by module
- Research & writing: Flat with clear prefixes—
draft-,final-,archive- - Legal documents: Organized by date and case, with consistent naming for fast searching
- Personal knowledge: Hierarchical by topic, with cross-references and tags
The structure you choose should reflect what you're trying to accomplish.
Machine-Readable vs. Human-Readable
Your agent needs to find things fast. You need to understand what's there when you look. These don't always align.
- For the agent: Consistent naming patterns, clear prefixes, flat hierarchies (fewer levels = faster traversal)
- For you: Readable folder names, file descriptions in READMEs, structure that makes intuitive sense
Example: Instead of nesting a project three levels deep (projects/active/legal/case-brief-2026.md), flatten it to the root with a prefix: p-legal-case-brief-2026.md. The agent can find it instantly. You still know what it is.
Simple Structure
Once you know what you're building, keep it simple:
workspace/
p-project-name/
drafts/
final/
archive/
README.md (describes what's in this project)
Naming Conventions
- Use dashes for spaces:
my-project-file.md - Dates as YYYY-MM-DD for sorting:
2026-03-29-notes.md - Prefix projects:
p-project-name - Prefix status:
draft-,final-,archive-(within projects)
What the Agent Can Access
Everything in the workspace folder. But be intentional—don't clutter it with files the agent doesn't need to know about.
README.md in each project with a description of what lives there. It's how the agent learns your thinking.See How Others Organize
Want to see how other den members are organizing their workspaces? Check the tips page or go to the discord server for real-world examples and FAQ.