Skip to content

Scaffold

The scaffold MCP tool downloads role-specific files into the calling agent's workspace. After onboarding (which creates the folder structure), scaffold gives the agent its AGENTS.md and the guides it needs for its role.

How it works

1. Agent connects to Conductor MCP
2. Agent calls onboard → creates folder structure, clones conductor
3. Agent calls scaffold("engineering-lead") → downloads role files
4. Agent reads conductor/AGENTS.md → knows what it can/cannot do
5. Agent starts working

Role files

Each role gets:

Role AGENTS.md Guides
Portfolio Manager conductor/AGENTS.md workflow, portfolio, lines/index, gatekeepers, notion-hierarchy, initiatives
Product Manager conductor/AGENTS.md product, estate/chooser, gatekeepers
Engineering Lead conductor/AGENTS.md software/overview, patterns/, lifecycle/, estate/*, secrets, github-first, socket-activation, gatekeepers
Editor-in-Chief conductor/AGENTS.md editorial, lines/index, gatekeepers
Engagement Manager conductor/AGENTS.md services, privacy-model, gatekeepers
Platform Engineer conductor/AGENTS.md operate, socket-activation, deploying, gatekeepers

All roles also get about/product.md and about/organization.md as shared context.

The AGENTS.md

Each role's AGENTS.md tells the agent: - What tools it needs - What it can do - What it cannot do - What guides to read - Key rules and non-negotiables

The AGENTS.md is the single source of truth for the agent's behavior. It replaces ad-hoc prompting with structured instructions.

Implementation

The tool returns JSON with file paths and their contents:

{
  "role": "engineering-lead",
  "files": {
    "conductor/AGENTS.md": "# AGENTS.md — Engineering Lead\n\n...",
    "conductor/docs/lines/software/overview.md": "# Software line\n\n...",
    ...
  },
  "instruction": "Write each file to disk at the path shown..."
}

The agent writes each file to disk, then reads its AGENTS.md to begin work.