Projects

Projects give SwarmClaw a durable operating context above individual tasks and chats.

Use projects to group:

• agents
• tasks
• schedules
• goals
• shared context about audience, priorities, and success criteria

What Projects Are For

Projects are the workspace-level answer to "what is this swarm working on?"

A project can hold:

• a clear objective
• operational notes and priorities
• linked agents and schedules
• related tasks
• a goal hierarchy rooted in that project

This keeps work scoped without forcing everything into one giant chat thread.

Goals

SwarmClaw supports a goal hierarchy with levels such as:

• organization
• team
• project
• agent
• task

Goals are additive. You can use projects without goals, or layer goals in when you want a stronger "why chain" across work.

Org Chart Relationship

Projects answer what the swarm is working on.

The Org Chart answers who is coordinated under whom.

Use them together:

• Projects for scope and operating context
• Org Chart for delegation topology and coordinator-worker structure

Common Workflows

• create a project for a release, research track, customer account, or product area
• assign the main agents that belong to that workstream
• link recurring schedules into the same scope
• attach tasks to the project so the board can be filtered by real work area
• add goals when you want the project objective to propagate deeper into execution

CLI Examples

swarmclaw projects list
swarmclaw projects create --data '{"name":"Release Ops","color":"#818CF8"}'
swarmclaw projects update <projectId> --data '{"description":"Launch coordination and QA"}'

swarmclaw goals list
swarmclaw goals create --data '{"title":"Ship v1.3.5","level":"project","projectId":"<projectId>"}'