Configuration

All Assemble configuration lives in .assemble.yaml at your project root.

Full configuration reference

# Assemble configuration

version: "1.0"

# Target platforms — which AI coding tools to generate configs for

platforms:

- cursor

- claude-code

- copilot

- windsurf

# See full list below

# Team profile — predefined set of defaults

profile: startup  # startup | enterprise | agency

# Governance level — oversight and checkpoints

governance: standard  # none | standard | strict

# Team language — language agents communicate in

langue_equipe: en  # en | fr | es | de | pt | etc.

# YOLO mode — autonomous execution
yolo: true  # true | false

# Cross-session memory — persist context between sessions
memory: true  # true | false

# Metrics — track workflow performance
metrics: true  # true | false

# Custom agents — extend the team

custom_agents:

- name: Athena

alias: athena

domain: privacy

file: .assemble/agents/privacy.md

keywords:

- privacy

- GDPR

# Custom workflows — add team-specific processes

custom_workflows:

- file: .assemble/workflows/design-review.yaml

trigger: /design-review

Options reference

version

Type: string | Required: yes | Default: "1.0"

Configuration file version. Currently only "1.0" is supported.

platforms

Type: string[] | Required: yes

List of AI coding platforms to generate configuration files for.

IDE platforms:cursor, windsurf, copilot, jetbrains, zed, trae, void, pearai, melty, codex, bolt, lovable, replit, cline, roo-code, tabnine

CLI platforms:claude-code, aider, continue, augment, amp

profile

Type: string | Required: no | Default: startup

Team profile that sets sensible defaults:

governance

Type: string | Required: no | Default: none

Governance level. See the Governance guide for details.

• none — no checkpoints
• standard — decision gates at key transitions
• strict — full audit trail, RBAC, NIST mapping

langue_equipe

Type: string | Required: no | Default: en

Language that agents use for communication and deliverables. Technical terms, code, and commands remain in English regardless of this setting.

Supported: any ISO 639-1 language code (en, fr, es, de, pt, ja, zh, ko, etc.)

yolo

Type: boolean | Required: no | Default: false

Enable YOLO mode for autonomous execution. See the YOLO Mode guide for details.

memory

Type: boolean | Required: no | Default: false

Enable cross-session memory. When true, Jarvis maintains assemble-output/_memory.md with:

• Session log: key decisions, blockers, outcomes
• Active context: current project state
• Key decisions: important decisions with rationale

metrics

Type: boolean | Required: no | Default: false

Enable workflow metrics tracking. When true, Jarvis logs workflow performance data to assemble-output/_metrics.md:

• Workflow name, timestamps, duration
• Steps executed, agents involved
• Success/failure status

custom_agents

Type: object[] | Required: no

Register custom agents for Jarvis routing. Each entry:

custom_workflows

Type: object[] | Required: no

Register custom workflows. Each entry:

Generated file structure

After running npx cohesiumai-assemble or npx cohesiumai-assemble generate:

your-project/

├── .assemble.yaml              # This configuration file

├── .assemble/

│   ├── agents/                 # Agent definitions (34 built-in)

│   │   ├── spider-man.md

│   │   ├── bruce-banner.md

│   │   └── ...

│   ├── workflows/              # Workflow definitions (15 built-in)

│   │   ├── feature-development.yaml

│   │   ├── bug-fix.yaml

│   │   └── ...

│   └── rules/                  # Routing, teams, orchestrator

│       ├── routing.md

│       ├── teams.md

│       └── orchestrator.md

├── .cursorrules                # Generated (if cursor in platforms)

├── CLAUDE.md                   # Generated (if claude-code in platforms)

├── .github/

│   └── copilot-instructions.md # Generated (if copilot in platforms)

└── assemble-output/            # Workflow deliverables

├── _memory.md              # Cross-session memory (if enabled)

└── _metrics.md             # Workflow metrics (if enabled)

Environment-specific overrides

For different environments, you can create override files:

# .assemble.local.yaml — local development overrides

yolo: true

governance: none

# .assemble.ci.yaml — CI/CD overrides

yolo: false

governance: strict

The merge order is: .assemble.yaml (base) → .assemble.{env}.yaml (override).