@bastani/atomic 0.5.25 → 0.5.26

package/README.md

@@ -9,9 +9,9 @@
 [![Bun](https://img.shields.io/badge/Bun-Runtime-f9f1e1?logo=bun&logoColor=black)](./package.json)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
-**An open-source TypeScript SDK for building harnesses around your coding agent** — Claude Code, OpenCode, or GitHub Copilot CLI. Chain agent sessions into deterministic pipelines, add human-in-the-loop approval gates, dispatch **12 specialized sub-agents**, and tap **55 built-in skills** — then ship it as TypeScript your whole team runs.
+**An open-source TypeScript SDK for building harnesses around your coding agent** — Claude Code, OpenCode, or GitHub Copilot CLI. Chain agent sessions into deterministic pipelines, add human-in-the-loop approval gates, dispatch **12 specialized sub-agents**, and tap **57 built-in skills** — then ship it as TypeScript your whole team runs.
 
-> Define how your agent works. Start for yourself, scale to your team.
+> Define how your agent works. Start for yourself, scale to your team — across GitHub, Azure DevOps (ADO), or Sapling.
 
 ---
 
@@ -255,27 +255,54 @@ atomic workflow -n ux-personas -a claude
 
 ## Table of Contents
 
-- [Quick Start](#quick-start)
-- [Why Atomic](#why-atomic)
-- [Security: Workflow Permissions Model](#security-workflow-permissions-model)
-- [Core Features](#core-features)
-  - [Multi-Agent Support](#multi-agent-support)
-  - [Workflow SDK](#workflow-sdk--build-your-own-deterministic-harness)
-  - [Research Codebase](#research-codebase)
-  - [Autonomous Execution (Ralph)](#autonomous-execution-ralph)
-  - [Deep Research Codebase](#deep-research-codebase)
-  - [Containerized Execution](#containerized-execution)
-  - [Specialized Sub-Agents](#specialized-sub-agents)
-  - [Built-in Skills](#built-in-skills)
-  - [Workflow Orchestrator Panel](#workflow-orchestrator-panel)
-- [Commands Reference](#commands-reference)
-- [Configuration](#configuration)
-- [Updating & Uninstalling](#updating--uninstalling)
-- [Troubleshooting](#troubleshooting)
-- [FAQ](#faq)
-- [Contributing](#contributing)
-- [License](#license)
-- [Credits](#credits)
+- [Atomic](#atomic)
+  - [Quick Start](#quick-start)
+    - [Prerequisites](#prerequisites)
+    - [1. Install](#1-install)
+    - [2. Generate context files](#2-generate-context-files)
+    - [3. Try Ralph (autonomous coding)](#3-try-ralph-autonomous-coding)
+    - [4. Build your own workflow](#4-build-your-own-workflow)
+    - [Managing sessions](#managing-sessions)
+  - [Why Atomic](#why-atomic)
+    - [Example use cases](#example-use-cases)
+  - [Table of Contents](#table-of-contents)
+  - [Security: Workflow Permissions Model](#security-workflow-permissions-model)
+  - [Core Features](#core-features)
+    - [Multi-Agent Support](#multi-agent-support)
+    - [Workflow SDK — Build Your Own Deterministic Harness](#workflow-sdk--build-your-own-deterministic-harness)
+      - [Builder API](#builder-api)
+      - [WorkflowContext (`ctx`) — top-level orchestrator](#workflowcontext-ctx--top-level-orchestrator)
+      - [SessionContext (`s`) — inside each session callback](#sessioncontext-s--inside-each-session-callback)
+      - [Session Options (`SessionRunOptions`)](#session-options-sessionrunoptions)
+      - [Saving Transcripts](#saving-transcripts)
+      - [Per-Agent Session APIs](#per-agent-session-apis)
+      - [Key Rules](#key-rules)
+    - [Research Codebase](#research-codebase)
+    - [Autonomous Execution (Ralph)](#autonomous-execution-ralph)
+    - [Deep Research Codebase](#deep-research-codebase)
+    - [Containerized Execution](#containerized-execution)
+    - [Specialized Sub-Agents](#specialized-sub-agents)
+    - [Built-in Skills](#built-in-skills)
+    - [Workflow Orchestrator Panel](#workflow-orchestrator-panel)
+  - [Commands Reference](#commands-reference)
+    - [CLI Commands](#cli-commands)
+      - [Global Flags](#global-flags)
+      - [`atomic session` Subcommands](#atomic-session-subcommands)
+      - [`atomic chat` Flags](#atomic-chat-flags)
+      - [`atomic workflow` Flags](#atomic-workflow-flags)
+      - [`atomic completions` — Shell Completions](#atomic-completions--shell-completions)
+    - [Atomic-Provided Skills (invokable from any agent chat)](#atomic-provided-skills-invokable-from-any-agent-chat)
+  - [Configuration](#configuration)
+    - [`.atomic/settings.json`](#atomicsettingsjson)
+    - [Agent-Specific Files](#agent-specific-files)
+  - [Updating \& Uninstalling](#updating--uninstalling)
+    - [Update](#update)
+    - [Uninstall](#uninstall)
+  - [Troubleshooting](#troubleshooting)
+  - [FAQ](#faq)
+  - [Contributing](#contributing)
+  - [License](#license)
+  - [Credits](#credits)
 
 ---
 
@@ -529,19 +556,19 @@ The graph shows `seed → merge` — headless stages are transparent to the topo
 
 **Key capabilities:**
 
-| Capability                         | Description                                                                                                                                                                      |
-| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Dynamic session spawning**       | `ctx.stage()` spawns sessions at runtime — each gets its own tmux window and graph node                                                                                          |
-| **Native TypeScript control flow** | Use `for`, `if/else`, `Promise.all()`, `try/catch` — no framework DSL                                                                                                            |
-| **Session return values**          | Session callbacks can return data: `const h = await ctx.stage(...); h.result`                                                                                                    |
-| **Transcript passing**             | Access prior output via handle (`s.transcript(handle)`) or name (`s.transcript("name")`)                                                                                         |
-| **Declared input schemas**         | Add an `inputs: [...]` array and the CLI materialises `--<field>=<value>` flags with built-in validation                                                                         |
-| **Interactive picker**             | `atomic workflow -a <agent>` renders input schemas as forms — no flag memorisation                                                                                               |
-| **Nested sub-sessions**            | `s.stage()` inside a callback spawns child sessions — visible as nested graph nodes                                                                                              |
-| **Auto-inferred graph**            | Topology derived from `await` / `Promise.all` patterns — no annotations                                                                                                          |
-| **Provider-agnostic**              | Write raw SDK code for Claude, Copilot, or OpenCode inside each callback                                                                                                         |
-| **Live graph visualization**       | Sessions appear in the TUI graph as they spawn — loops and conditionals visible in real time                                                                                     |
-| **Background (headless) stages**   | `headless: true` runs in-process without a tmux window — invisible in graph, tracked by statusline counter, identical callback API                                               |
+| Capability                         | Description                                                                                                                        |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| **Dynamic session spawning**       | `ctx.stage()` spawns sessions at runtime — each gets its own tmux window and graph node                                            |
+| **Native TypeScript control flow** | Use `for`, `if/else`, `Promise.all()`, `try/catch` — no framework DSL                                                              |
+| **Session return values**          | Session callbacks can return data: `const h = await ctx.stage(...); h.result`                                                      |
+| **Transcript passing**             | Access prior output via handle (`s.transcript(handle)`) or name (`s.transcript("name")`)                                           |
+| **Declared input schemas**         | Add an `inputs: [...]` array and the CLI materialises `--<field>=<value>` flags with built-in validation                           |
+| **Interactive picker**             | `atomic workflow -a <agent>` renders input schemas as forms — no flag memorisation                                                 |
+| **Nested sub-sessions**            | `s.stage()` inside a callback spawns child sessions — visible as nested graph nodes                                                |
+| **Auto-inferred graph**            | Topology derived from `await` / `Promise.all` patterns — no annotations                                                            |
+| **Provider-agnostic**              | Write raw SDK code for Claude, Copilot, or OpenCode inside each callback                                                           |
+| **Live graph visualization**       | Sessions appear in the TUI graph as they spawn — loops and conditionals visible in real time                                       |
+| **Background (headless) stages**   | `headless: true` runs in-process without a tmux window — invisible in graph, tracked by statusline counter, identical callback API |
 
 **Deterministic execution guarantees:**
 
@@ -580,19 +607,19 @@ Variance comes only from the LLM's responses, not from the harness.
 
 #### SessionContext (`s`) — inside each session callback
 
-| Property                                     | Type                        | Description                                                                                                                             |
-| -------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| `s.client`                                   | `ProviderClient<A>`         | Pre-created SDK client (auto-managed by runtime)                                                                                        |
-| `s.session`                                  | `ProviderSession<A>`        | Pre-created provider session (auto-managed by runtime)                                                                                  |
-| `s.inputs`                                   | `{ [K in N]?: string }`     | Same typed inputs as `ctx.inputs`, forwarded into every stage so callbacks can read values without closing over the outer `ctx`         |
-| `s.agent`                                    | `AgentType`                 | Which agent is running                                                                                                                  |
-| `s.paneId`                                   | `string`                    | tmux pane ID for this session                                                                                                           |
-| `s.sessionId`                                | `string`                    | Session UUID                                                                                                                            |
-| `s.sessionDir`                               | `string`                    | Path to this session's storage directory on disk                                                                                        |
-| `s.save(messages)`                           | `SaveTranscript`            | Save this session's output for subsequent sessions                                                                                      |
-| `s.transcript(ref)`                          | `Promise<Transcript>`       | Get a completed session's transcript                                                                                                    |
-| `s.getMessages(ref)`                         | `Promise<SavedMessage[]>`   | Get a completed session's raw native messages                                                                                           |
-| `s.stage(opts, clientOpts, sessionOpts, fn)` | `Promise<SessionHandle<T>>` | Spawn a nested sub-session (child in the graph)                                                                                         |
+| Property                                     | Type                        | Description                                                                                                                     |
+| -------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `s.client`                                   | `ProviderClient<A>`         | Pre-created SDK client (auto-managed by runtime)                                                                                |
+| `s.session`                                  | `ProviderSession<A>`        | Pre-created provider session (auto-managed by runtime)                                                                          |
+| `s.inputs`                                   | `{ [K in N]?: string }`     | Same typed inputs as `ctx.inputs`, forwarded into every stage so callbacks can read values without closing over the outer `ctx` |
+| `s.agent`                                    | `AgentType`                 | Which agent is running                                                                                                          |
+| `s.paneId`                                   | `string`                    | tmux pane ID for this session                                                                                                   |
+| `s.sessionId`                                | `string`                    | Session UUID                                                                                                                    |
+| `s.sessionDir`                               | `string`                    | Path to this session's storage directory on disk                                                                                |
+| `s.save(messages)`                           | `SaveTranscript`            | Save this session's output for subsequent sessions                                                                              |
+| `s.transcript(ref)`                          | `Promise<Transcript>`       | Get a completed session's transcript                                                                                            |
+| `s.getMessages(ref)`                         | `Promise<SavedMessage[]>`   | Get a completed session's raw native messages                                                                                   |
+| `s.stage(opts, clientOpts, sessionOpts, fn)` | `Promise<SessionHandle<T>>` | Spawn a nested sub-session (child in the graph)                                                                                 |
 
 #### Session Options (`SessionRunOptions`)
 
@@ -645,14 +672,14 @@ For the authoring walkthrough ask Atomic to use the `workflow-creator` skill or
 
 The `/research-codebase` command dispatches **specialized sub-agents in parallel** to analyze your codebase — understand auth flows, trace root causes, query docs, and hit external sources via [DeepWiki MCP](https://deepwiki.com). Get up to speed on a new project in minutes instead of hours.
 
-| Sub-Agent                    | Model  | Purpose                                                                                   |
-| ---------------------------- | ------ | ----------------------------------------------------------------------------------------- |
-| `codebase-locator`           | Haiku  | Locate files, directories, and components relevant to the research topic                  |
-| `codebase-analyzer`          | Sonnet | Analyze implementation details, trace data flow, explain technical workings               |
-| `codebase-pattern-finder`    | Haiku  | Find similar implementations, usage examples, and existing patterns to model after        |
-| `codebase-online-researcher` | Sonnet | Fetch up-to-date information from the web and repository knowledge from DeepWiki          |
-| `codebase-research-locator`  | Haiku  | Discover relevant documents in `research/` and `specs/` directories                       |
-| `codebase-research-analyzer` | Sonnet | Extract high-value insights, decisions, and technical details from research documents     |
+| Sub-Agent                    | Model  | Purpose                                                                               |
+| ---------------------------- | ------ | ------------------------------------------------------------------------------------- |
+| `codebase-locator`           | Haiku  | Locate files, directories, and components relevant to the research topic              |
+| `codebase-analyzer`          | Sonnet | Analyze implementation details, trace data flow, explain technical workings           |
+| `codebase-pattern-finder`    | Haiku  | Find similar implementations, usage examples, and existing patterns to model after    |
+| `codebase-online-researcher` | Sonnet | Fetch up-to-date information from the web and repository knowledge from DeepWiki      |
+| `codebase-research-locator`  | Haiku  | Discover relevant documents in `research/` and `specs/` directories                   |
+| `codebase-research-analyzer` | Sonnet | Extract high-value insights, decisions, and technical details from research documents |
 
 **Run parallel research sessions** to compare approaches:
 
@@ -748,20 +775,20 @@ See [Quick Start → Devcontainer](#1-install) for a working `.devcontainer.json
 
 Atomic dispatches **purpose-built sub-agents**, each with scoped context, tools, and termination conditions:
 
-| Sub-Agent                    | Purpose                                                                |
-| ---------------------------- | ---------------------------------------------------------------------- |
-| `planner`                    | Decompose specs into structured task lists with dependency tracking    |
-| `worker`                     | Implement single focused tasks (multiple workers run in parallel)      |
-| `reviewer`                   | Audit implementations against specs and best practices                 |
-| `code-simplifier`            | Simplify and refine code for clarity, consistency, maintainability     |
-| `orchestrator`               | Coordinate complex multi-step workflows                                |
-| `codebase-analyzer`          | Analyze implementation details of specific components                  |
-| `codebase-locator`           | Locate files, directories, and components                              |
-| `codebase-pattern-finder`    | Find similar implementations and usage examples                        |
-| `codebase-online-researcher` | Research using web sources and DeepWiki                                |
-| `codebase-research-analyzer` | Deep dive on research topics                                           |
-| `codebase-research-locator`  | Find documents in `research/` directory                                |
-| `debugger`                   | Debug errors, test failures, and unexpected behavior                   |
+| Sub-Agent                    | Purpose                                                             |
+| ---------------------------- | ------------------------------------------------------------------- |
+| `planner`                    | Decompose specs into structured task lists with dependency tracking |
+| `worker`                     | Implement single focused tasks (multiple workers run in parallel)   |
+| `reviewer`                   | Audit implementations against specs and best practices              |
+| `code-simplifier`            | Simplify and refine code for clarity, consistency, maintainability  |
+| `orchestrator`               | Coordinate complex multi-step workflows                             |
+| `codebase-analyzer`          | Analyze implementation details of specific components               |
+| `codebase-locator`           | Locate files, directories, and components                           |
+| `codebase-pattern-finder`    | Find similar implementations and usage examples                     |
+| `codebase-online-researcher` | Research using web sources and DeepWiki                             |
+| `codebase-research-analyzer` | Deep dive on research topics                                        |
+| `codebase-research-locator`  | Find documents in `research/` directory                             |
+| `debugger`                   | Debug errors, test failures, and unexpected behavior                |
 
 <details>
 <summary><i>Why specialize instead of using one general-purpose agent?</i></summary>
@@ -783,7 +810,7 @@ Use `/agents` in any chat session to see all available sub-agents.
 
 ### Built-in Skills
 
-Skills are structured capability modules that give agents best practices and reusable workflows. Atomic ships **55 skills** across eight categories; each lives at `.agents/skills/<name>/SKILL.md` and is auto-invoked when the agent detects a relevant trigger.
+Skills are structured capability modules that give agents best practices and reusable workflows. Atomic ships **57 skills** across eight categories; each lives at `.agents/skills/<name>/SKILL.md` and is auto-invoked when the agent detects a relevant trigger.
 
 <details>
 <summary><b>Development workflows</b></summary>
@@ -872,15 +899,19 @@ Skills are structured capability modules that give agents best practices and reu
 | `pptx`      | Create, read, edit, and manipulate PowerPoint (`.pptx`) slide decks     |
 | `liteparse` | Parse and convert unstructured files (PDF, DOCX, PPTX, images) locally  |
 
-**Git / Sapling / automation:**
+**Git / Azure DevOps / Sapling / automation:**
 
-| Skill            | Description                                              |
-| ---------------- | -------------------------------------------------------- |
-| `gh-commit`      | Conventional-commit Git commits                          |
-| `gh-create-pr`   | Commit unstaged changes, push, and submit a pull request |
-| `sl-commit`      | Conventional-commit Sapling commits                      |
-| `sl-submit-diff` | Submit Sapling commits as Phabricator diffs              |
-| `playwright-cli` | Automate browser interactions, tests, screenshots        |
+| Skill            | Description                                                                 |
+| ---------------- | --------------------------------------------------------------------------- |
+| `gh-commit`      | Conventional-commit Git commits                                             |
+| `gh-create-pr`   | Commit unstaged changes, push, and submit a GitHub PR                       |
+| `ado-commit`     | Conventional-commit Git commits for Azure DevOps (adds `AB#<id>` trailers)  |
+| `ado-create-pr`  | Commit, push, and open an Azure DevOps PR via the `azure-devops` MCP server |
+| `sl-commit`      | Conventional-commit Sapling commits                                         |
+| `sl-submit-diff` | Submit Sapling commits as Phabricator diffs                                 |
+| `playwright-cli` | Automate browser interactions, tests, screenshots                           |
+
+> **Note on source control providers:** the GitHub and Azure DevOps MCP servers are **disabled by default** to avoid consuming tokens on projects that don't need them. Set `scm` in `.atomic/settings.json` (or run `atomic config set scm <provider>`) to `github`, `azure-devops`, or `sapling` — on every `atomic chat` / `atomic workflow` startup Atomic reconciles `.claude/settings.json` (`disabledMcpjsonServers`), `.opencode/opencode.json` (`mcp.<server>.enabled`), and appends `--disable-mcp-server <name>` to the Copilot CLI invocation (Copilot has no on-disk MCP toggle). `sapling` disables both servers everywhere.
 
 **Meta:**
 
@@ -914,16 +945,16 @@ During `atomic chat`, there is no Atomic-owned TUI — `atomic chat -a <agent>`
 
 ### CLI Commands
 
-| Command                         | Description                                                           |
-| ------------------------------- | --------------------------------------------------------------------- |
-| `atomic chat`                   | Spawn the native agent CLI inside a tmux session                      |
-| `atomic workflow`               | Run a multi-session workflow with the Atomic orchestrator panel       |
-| `atomic workflow list`          | List available workflows, grouped by source                           |
-| `atomic session list`           | List all running sessions on the atomic tmux socket                   |
-| `atomic session connect [name]` | Attach to a session (interactive picker when no name given)           |
-| `atomic session kill [name]`    | Kill a session by name, or all sessions when no name is given         |
-| `atomic completions <shell>`    | Output shell completion script (bash, zsh, fish, powershell)          |
-| `atomic config set <k> <v>`     | Set configuration values (currently supports `telemetry`)             |
+| Command                         | Description                                                     |
+| ------------------------------- | --------------------------------------------------------------- |
+| `atomic chat`                   | Spawn the native agent CLI inside a tmux session                |
+| `atomic workflow`               | Run a multi-session workflow with the Atomic orchestrator panel |
+| `atomic workflow list`          | List available workflows, grouped by source                     |
+| `atomic session list`           | List all running sessions on the atomic tmux socket             |
+| `atomic session connect [name]` | Attach to a session (interactive picker when no name given)     |
+| `atomic session kill [name]`    | Kill a session by name, or all sessions when no name is given   |
+| `atomic completions <shell>`    | Output shell completion script (bash, zsh, fish, powershell)    |
+| `atomic config set <k> <v>`     | Set configuration values (supports `telemetry` and `scm`)       |
 
 #### Global Flags
 
@@ -978,13 +1009,13 @@ atomic chat -a claude --verbose              # forward --verbose to claude
 
 #### `atomic workflow` Flags
 
-| Flag                 | Description                                                                                       |
-| -------------------- | ------------------------------------------------------------------------------------------------- |
-| `-n, --name <name>`  | Workflow name (matches directory under `.atomic/workflows/<name>/`)                               |
-| `-a, --agent <name>` | Agent: `claude`, `opencode`, `copilot`                                                            |
+| Flag                 | Description                                                                                                                                       |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `-n, --name <name>`  | Workflow name (matches directory under `.atomic/workflows/<name>/`)                                                                               |
+| `-a, --agent <name>` | Agent: `claude`, `opencode`, `copilot`                                                                                                            |
 | `-d, --detach`       | Start the workflow in the background without attaching — ideal for scripted / CI runs; attach later with `atomic workflow session connect <name>` |
-| `--<field>=<value>`  | Structured input for workflows that declare an `inputs` schema (also accepts `--<field> <value>`) |
-| `[prompt...]`        | Positional prompt — requires the workflow to declare a `prompt` input                             |
+| `--<field>=<value>`  | Structured input for workflows that declare an `inputs` schema (also accepts `--<field> <value>`)                                                 |
+| `[prompt...]`        | Positional prompt — requires the workflow to declare a `prompt` input                                                                             |
 
 Five invocation shapes:
 
@@ -1057,17 +1088,19 @@ Add-Content $PROFILE "`nif (Test-Path `"$cache`") { . `"$cache`" }"
 
 Atomic ships skills — not slash commands. Skills are auto-discovered by Claude Code, OpenCode, and Copilot CLI, invoked by typing `/<skill-name>` (Claude Code) or by natural-language reference (OpenCode / Copilot CLI).
 
-| Skill               | Typical invocation                | Purpose                                                                       |
-| ------------------- | --------------------------------- | ----------------------------------------------------------------------------- |
-| `init`              | `/init`                           | Generate `CLAUDE.md` and `AGENTS.md` by exploring the codebase                |
-| `research-codebase` | `/research-codebase "<question>"` | Dispatch parallel sub-agents to analyze the codebase and write a research doc |
-| `create-spec`       | `/create-spec "<research-path>"`  | Produce a technical spec grounded in a research document                      |
-| `explain-code`      | `/explain-code "<path>"`          | Deep-dive explanation of specific code using DeepWiki                         |
-| `gh-commit`         | `/gh-commit`                      | Create a conventional-commit Git commit                                       |
-| `gh-create-pr`      | `/gh-create-pr`                   | Commit, push, and open a pull request                                         |
-| `sl-commit`         | `/sl-commit`                      | Create a Sapling commit                                                       |
-| `sl-submit-diff`    | `/sl-submit-diff`                 | Submit a Sapling commit as a Phabricator diff                                 |
-| `workflow-creator`  | natural language                  | Generate a multi-agent workflow file in `.atomic/workflows/`                  |
+| Skill               | Typical invocation                | Purpose                                                                         |
+| ------------------- | --------------------------------- | ------------------------------------------------------------------------------- |
+| `init`              | `/init`                           | Generate `CLAUDE.md` and `AGENTS.md` by exploring the codebase                  |
+| `research-codebase` | `/research-codebase "<question>"` | Dispatch parallel sub-agents to analyze the codebase and write a research doc   |
+| `create-spec`       | `/create-spec "<research-path>"`  | Produce a technical spec grounded in a research document                        |
+| `explain-code`      | `/explain-code "<path>"`          | Deep-dive explanation of specific code using DeepWiki                           |
+| `gh-commit`         | `/gh-commit`                      | Create a conventional-commit Git commit                                         |
+| `gh-create-pr`      | `/gh-create-pr`                   | Commit, push, and open a GitHub pull request                                    |
+| `ado-commit`        | `/ado-commit`                     | Create a conventional-commit Git commit on an Azure DevOps-hosted repo          |
+| `ado-create-pr`     | `/ado-create-pr`                  | Commit, push, and open an Azure DevOps PR through the `azure-devops` MCP server |
+| `sl-commit`         | `/sl-commit`                      | Create a Sapling commit                                                         |
+| `sl-submit-diff`    | `/sl-submit-diff`                 | Submit a Sapling commit as a Phabricator diff                                   |
+| `workflow-creator`  | natural language                  | Generate a multi-agent workflow file in `.atomic/workflows/`                    |
 
 Native slash commands (`/help`, `/clear`, `/compact`, `/model`, `/theme`, `/agents`, `/mcp`, `/exit`) come from the underlying agent CLI, not Atomic.
 
@@ -1091,12 +1124,13 @@ Resolution order:
 }
 ```
 
-| Field         | Type   | Description                               |
-| ------------- | ------ | ----------------------------------------- |
-| `$schema`     | string | JSON Schema URL for editor autocomplete   |
-| `version`     | number | Config schema version (currently `1`)     |
-| `scm`         | string | Source control: `github` or `sapling`     |
-| `lastUpdated` | string | ISO 8601 timestamp of the last update     |
+
+| Field         | Type   | Description                                                                                                                                     |
+| ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `$schema`     | string | JSON Schema URL for editor autocomplete                                                                                                         |
+| `version`     | number | Config schema version (currently `1`)                                                                                                           |
+| `scm`         | string | Source control provider — `github`, `azure-devops`, or `sapling`. Reconciles the GitHub / Azure DevOps MCP servers in agent configs on startup. |
+| `lastUpdated` | string | ISO 8601 timestamp of the last update                                                                                                           |
 
 > Model selection and reasoning effort are managed by each underlying agent CLI (e.g. Claude Code's `/model`), not Atomic. Atomic's chat command spawns the agent's native TUI — use the agent's own controls.
 
@@ -1183,7 +1217,7 @@ Ensure the agent CLI is in your PATH. Atomic uses `Bun.which()`, which handles `
 | **Data Flow**            | Manual — copy output between steps           | Controlled transcript passing via `ctx.transcript()` and `ctx.getMessages()`                        |
 | **Agent Support**        | GitHub Copilot CLI                           | Claude Code + OpenCode + Copilot CLI — switch with a flag                                           |
 | **Sub-Agents**           | Single general-purpose agent                 | 12 specialized sub-agents with scoped tools and isolated contexts                                   |
-| **Skills**               | Not available                                | 55 built-in skills (development, design, docs, agent architecture)                                  |
+| **Skills**               | Not available                                | 57 built-in skills (development, design, docs, agent architecture)                                  |
 | **Autonomous Execution** | Not available                                | Ralph — multi-hour autonomous sessions with plan/implement/review/debug loop                        |
 | **Execution Guarantees** | Non-deterministic                            | Deterministic — strict step ordering, frozen definitions, controlled transcript access              |
 | **Isolation**            | Not addressed                                | Devcontainer features for containerized execution                                                   |
@@ -1206,7 +1240,7 @@ Ensure the agent CLI is in your PATH. Atomic uses `Bun.which()`, which handles `
 | **Execution Model**     | DAG-based with conditional edges                | Deterministic — strict step ordering, frozen definitions, controlled transcript passing       |
 | **Parallelism**         | Via LangGraph branch nodes                      | Native parallel sessions via `Promise.all()` with `ctx.session()` in isolated context windows |
 | **Sub-Agents**          | Researcher, coder, reporter nodes               | 12 specialized sub-agents with scoped tools (planner, worker, reviewer, debugger, etc.)       |
-| **Skills**              | Not available                                   | 55 built-in skills auto-invoked by context                                                    |
+| **Skills**              | Not available                                   | 57 built-in skills auto-invoked by context                                                    |
 | **Isolation**           | Sandbox containers                              | Devcontainer features + git worktrees                                                         |
 | **Interface**           | Web UI (Streamlit)                              | Terminal chat with tmux-based session management                                              |
 | **Autonomous**          | Not available                                   | Ralph — bounded iteration with plan/implement/review/debug loop                               |
@@ -1231,7 +1265,7 @@ Ensure the agent CLI is in your PATH. Atomic uses `Bun.which()`, which handles `
 | **Data Flow**             | In-context within a single conversation                                                      | Controlled transcript passing via `ctx.transcript()` and `ctx.getMessages()`                                                                 |
 | **Self-Improvement**      | Closed learning loop — auto-creates skills from experience, persistent user model via Honcho | Skills authored by developers; memory via CLAUDE.md / AGENTS.md context files                                                                |
 | **Sub-Agents**            | `delegate_task` spawns isolated subagents                                                    | 12 specialized sub-agents with scoped tools and model tiers (Opus, Sonnet, Haiku)                                                            |
-| **Skills**                | 40+ tools + community Skills Hub (agentskills.io)                                            | 55 built-in skills (development, design, docs, agent architecture)                                                                           |
+| **Skills**                | 40+ tools + community Skills Hub (agentskills.io)                                            | 57 built-in skills (development, design, docs, agent architecture)                                                                           |
 | **Interface**             | Terminal TUI + multi-platform messaging gateway (Telegram, Discord, Slack, WhatsApp, etc.)   | Terminal chat with tmux-based session management                                                                                             |
 | **Isolation**             | Six terminal backends (local, Docker, SSH, Daytona, Singularity, Modal)                      | Devcontainer features + git worktrees                                                                                                        |
 | **Autonomous Execution**  | Cron scheduler with inactivity-based timeouts                                                | Ralph — bounded iteration with plan/implement/review/debug loop                                                                              |

package/assets/settings.schema.json

@@ -14,8 +14,8 @@
     },
     "scm": {
       "type": "string",
-      "enum": ["github", "sapling"],
-      "description": "Selected source control management system."
+      "enum": ["github", "azure-devops", "sapling"],
+      "description": "Selected source control provider. On atomic startup, the corresponding GitHub / Azure DevOps MCP servers are enabled in `.claude/settings.json` and `.opencode/opencode.json`; the others are disabled to avoid unnecessary token consumption."
     },
     "lastUpdated": {
       "type": "string",

package/dist/sdk/runtime/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/executor.ts"],"names":[],"mappings":"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"}

package/dist/sdk/workflows/builtin/open-claude-design/claude/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * open-claude-design / claude
+ *
+ * An open-source replica of Anthropic's Claude Design product, implemented
+ * as an Atomic CLI workflow. Orchestrates the design skill ecosystem
+ * (impeccable, critique, shape, polish, audit, etc.) into a deterministic
+ * 5-phase pipeline:
+ *
+ *   Phase 1: Design System Onboarding — extract tokens, build Design.md (HIL)
+ *   Phase 2: Import — aggregate text/URL/file references
+ *   Phase 3: Generation — produce first design version
+ *   Phase 4: Refinement Loop — bounded iterate with critique + user feedback
+ *   Phase 5: Export/Handoff — HTML export + Claude Code handoff bundle
+ *
+ * Topology:
+ *
+ *   ┌─→ ds-locator (headless)  ∥  ds-analyzer (headless)  ∥  ds-patterns (headless)
+ *   │                          │
+ *   │                          ▼
+ *   │                design-system-builder (visible, HIL)
+ *   │                          │
+ *   │                          ▼
+ *   │   web-capture (headless, if URL)  ∥  file-parser (headless, if file)
+ *   │                          │
+ *   │                          ▼
+ *   │                     generator (visible)
+ *   │                          │
+ *   │                          ▼
+ *   │   ┌─→ user-feedback-i (visible, HIL)
+ *   │   │         │
+ *   │   │         ├─→ critique-i (headless)  ∥  screenshot-i (headless)
+ *   │   │         │
+ *   │   │         ▼
+ *   │   │   apply-changes-i (visible)
+ *   │   │         │
+ *   │   └─────────┘ (loop until approved or MAX_REFINEMENTS)
+ *   │                          │
+ *   │                          ▼
+ *   │                     exporter (visible)
+ *   └──────────────────────────────────────
+ *
+ * Run: atomic workflow -n open-claude-design -a claude "design a dashboard"
+ */
+declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", "prompt" | "reference" | "output-type" | "design-system">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/claude/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;;AA8CH,wBA0Za"}

package/dist/sdk/workflows/builtin/open-claude-design/copilot/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * open-claude-design / copilot
+ *
+ * Copilot replica of the Claude open-claude-design workflow. Orchestrates
+ * the design skill ecosystem (impeccable, critique, shape, polish, audit,
+ * etc.) into a deterministic 5-phase pipeline:
+ *
+ *   Phase 1: Design System Onboarding — extract tokens, build Design.md (HIL)
+ *   Phase 2: Import — aggregate text/URL/file references
+ *   Phase 3: Generation — produce first design version
+ *   Phase 4: Refinement Loop — bounded iterate with critique + user feedback
+ *   Phase 5: Export/Handoff — HTML export + Claude Code handoff bundle
+ *
+ * Copilot-specific concerns (see references/failure-modes.md):
+ *
+ *   • F5 — every `ctx.stage()` is a FRESH session. Every specialist receives
+ *     its required context verbatim in its first prompt.
+ *   • F1 — Copilot's last assistant turn is often empty when the agent ends
+ *     on a tool call. Use `getAssistantText()` (concatenation of every
+ *     top-level non-empty assistant turn, ignoring sub-agent
+ *     `parentToolCallId` traffic) instead of `.at(-1).data.content`.
+ *   • F9 — `s.save()` receives `SessionEvent[]` from `s.session.getMessages()`.
+ *
+ * Sub-agents are dispatched via `sessionOpts.agent` (the Copilot-native way
+ * to bind a session to a single named sub-agent). Permissions default to
+ * `approveAll` so headless stages run unattended.
+ *
+ * See claude/index.ts for the full topology diagram and design rationale.
+ *
+ * Run: atomic workflow -n open-claude-design -a copilot "design a dashboard"
+ */
+declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", "prompt" | "reference" | "output-type" | "design-system">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/copilot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;AA2DH,wBAiaa"}

package/dist/sdk/workflows/builtin/open-claude-design/helpers/constants.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Constants for the open-claude-design workflow.
+ *
+ * Design-rule constants (REFLEX_FONTS, IMPECCABLE_BANS, DESIGN_DONTS) mirror
+ * the canonical impeccable skill shipped at
+ * `~/.claude/skills/impeccable/SKILL.md`. The skill itself is only loaded
+ * opportunistically by the agent — so we inline the load-bearing rules here
+ * to guarantee every generation/refinement/critique turn sees them even if
+ * the skill is missing or fails to load. Re-sync when the skill updates.
+ */
+/** Maximum refinement iterations before the loop exits unconditionally. */
+export declare const MAX_REFINEMENTS = 5;
+/**
+ * Headless stages: structured analysis, tool orchestration, rubric-following.
+ * Uses Sonnet for cost efficiency. Bypasses permissions for unattended operation.
+ */
+export declare const HEADLESS_OPTS: {
+    readonly permissionMode: "bypassPermissions";
+    readonly allowDangerouslySkipPermissions: true;
+    readonly model: "sonnet";
+};
+/**
+ * Visible/creative stages: inherit orchestrator model (Opus).
+ * No model override — inherits from the parent session.
+ */
+export declare const VISIBLE_OPTS: {
+    readonly permissionMode: "bypassPermissions";
+    readonly allowDangerouslySkipPermissions: true;
+};
+/** Name of the design system file written to the project root. */
+export declare const DESIGN_SYSTEM_FILENAME = "Design.md";
+/** Directory under project root where final design outputs are stored. */
+export declare const DESIGNS_DIR = "research/designs";
+/** Name of the existing impeccable brand context file. */
+export declare const IMPECCABLE_FILENAME = ".impeccable.md";
+/**
+ * Structured ban — rendered into generation/refinement/critique prompts as a
+ * `rule` (what is forbidden) plus `detail` (the CSS pattern + the rewrite).
+ */
+export interface ImpeccableBan {
+    readonly id: string;
+    readonly rule: string;
+    readonly detail: string;
+}
+/**
+ * Absolute CSS bans from the canonical impeccable skill's `<absolute_bans>`
+ * section. These are the two patterns that the skill flags as "NEVER
+ * acceptable" regardless of color, radius, or CSS variable naming. If you
+ * change this list, re-sync with `~/.claude/skills/impeccable/SKILL.md`.
+ */
+export declare const IMPECCABLE_BANS: readonly ImpeccableBan[];
+/**
+ * Canonical reflex fonts from the impeccable skill's
+ * `<reflex_fonts_to_reject>` list. These are the training-data defaults that
+ * create monoculture across projects; every one of them is banned.
+ */
+export declare const REFLEX_FONTS: readonly string[];
+/**
+ * Non-ban DON'Ts distilled from the impeccable skill sections on Typography,
+ * Color, Layout/Space, Motion, UX Writing, and Responsive. These are not
+ * absolute bans, but they are the recognizable AI fingerprints from
+ * 2024-2025 and must be avoided in generated designs.
+ */
+export declare const DESIGN_DONTS: readonly string[];
+/**
+ * Command invocation for the impeccable scanner. The correct subcommand is
+ * `detect`; a bare `impeccable --json` just prints the top-level help.
+ * Exit code is always 0 — callers must parse the JSON array and check length
+ * to know whether findings exist.
+ */
+export declare const IMPECCABLE_SCAN_CMD: readonly ["bunx", "impeccable", "detect", "--json"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/helpers/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/helpers/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAElD,0EAA0E;AAC1E,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAE9C,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAoB1C,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAwBhC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EA4BhC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,qDAKtB,CAAC"}