Agents

What is an Agent?

An agent in Crucible is a specialized AI worker with persistent identity, its own workspace, and domain expertise. Each agent has a defined role — researcher, engineer, writer, strategist, ops — and is built to excel at that specific domain.

Agent Configuration

Every agent is defined by key files in its workspace:

• SOUL.md — Personality, principles, and behavioral guidelines
• IDENTITY.md — Role definition, responsibilities, and working modes
• MEMORY.md — Long-term accumulated knowledge
• TOOLS.md — Environment-specific configuration

Workspaces

Each agent gets its own directory on the filesystem. This is where tasks arrive (in tasks/inbox/), where work happens (in tasks/active/), and where results are stored (in tasks/done/).

Designing Your Roster

Think about what kinds of work your team needs done. Each agent should have a clear domain with minimal overlap. A good roster covers research, engineering, content, strategy, and operations — but your specific needs will vary.