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:

Profile	Governance	YOLO	Agents	Focus
`startup`	none	true	All 34	Speed and iteration
`enterprise`	standard	false	All 34	Oversight and compliance
`agency`	standard	true	All 34	Multi-client management

`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

Field	Type	Required	Description
`name`	string	yes	Display name
`alias`	string	yes	`@alias` for invocation
`domain`	string	yes	Expertise domain
`file`	string	yes	Path to agent definition file
`keywords`	string[]	yes	Routing keywords

`custom_workflows`

Type: object[] | Required: no

Field	Type	Required	Description
`file`	string	yes	Path to workflow YAML file
`trigger`	string	yes	`/command` to activate

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).