Chelle

Directory Structure

Your workspace follows conventions that help Chelle understand your knowledge. Here's the standard structure.

Standard Layout

workspace/
├── README.md           # Workspace description
├── lake/               # Entity storage
│   ├── tasks/          # Task entities
│   ├── projects/       # Project entities
│   ├── journal/        # Journal entries
│   └── companies/      # Organization entities
├── roles/              # Role definitions
├── docs/               # Documentation
└── .claude/            # Chelle configuration
    ├── skills/         # Custom skills
    └── settings.json   # Workspace settings

The Lake Directory

The lake/ directory is where structured entities live. Each subdirectory represents an entity type.

Chelle automatically discovers entity types from this structure.

Root Files

  • README.md - Describes your workspace. Chelle reads this to understand the context.

Special Directories

roles/

Role definitions that shape how Chelle approaches tasks. When you "load" a role, Chelle adopts that perspective.

.claude/

Configuration directory (hidden by default). Contains:

  • skills/ - Custom slash commands
  • settings.json - Workspace configuration
  • mcp_settings.json - MCP server configuration

Naming Conventions

  • Tasks - 000001-short-description.md (numeric ID prefix)
  • Journal - 2024-01-15.md (date-based)
  • Projects - project-name.md (slugified title)

Next: Working with conversations