@guyghost/swarm-dao-claude-adapter 0.2.0

package/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "swarm-dao": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@guyghost/swarm-dao-claude-adapter"],
+      "env": {
+        "DAO_ROOT": "."
+      }
+    }
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,52 @@
+# CLAUDE.md — Swarm DAO governance
+
+This repository is governed by **Swarm DAO**, a multi-agent governance layer.
+Proposals are deliberated by a swarm of agents, validated by quality-control
+gates, then executed and tracked.
+
+## Workflow (always follow this order)
+
+1. `dao_setup` — create the default 7 product agents (once per repo).
+2. `dao_propose` — open a proposal (`title`, `type`, `description`).
+3. `dao_deliberate proposalId=N` — returns a dispatch plan naming the agents and
+   the model each should use.
+4. Spawn one sub-agent per dispatch-plan entry (use the `Task` tool / subagents).
+5. `dao_record_outputs proposalId=N outputs=[...]` — feed each sub-agent's
+   `agentId` + `content` back into the DAO.
+6. `dao_control proposalId=N` — run the quality gates.
+7. `dao_execute proposalId=N` — apply the approved change.
+8. `dao_ship proposalId=N` — cascade and finalize dependencies.
+
+## Rules
+
+- Treat `dao_*` tool results as the source of truth for DAO state.
+- Never hand-edit files under `.swarm-dao/` — always use the DAO tools.
+- If a gate fails in `dao_control`, fix the root cause; do not force-skip.
+- Run `dao_dry_run` before `dao_execute` for risky changes.
+- Use `dao_rollback` to revert a misbehaving executed proposal.
+- Rate outcomes with `dao_rate` to keep the governance health score accurate.
+
+## Slash commands
+
+This package ships a full `/dao:*` namespace with native tab completion.
+Copy `commands/` into `.claude/commands/` to enable them. The colon-namespaced
+commands are auto-generated as flat files `commands/dao:<id>.md` (colons in
+filenames, not subdirectories).
+
+### `/dao:*` namespace (generated from the registry)
+
+Every lifecycle, discovery, governance, and GitHub command is available as
+`/dao:<id>`:
+
+- `/dao:setup`, `/dao:propose`, `/dao:deliberate`, `/dao:record-outputs`,
+  `/dao:control`, `/dao:execute`, `/dao:ship`, `/dao:rollback`
+- `/dao:help`, `/dao:status`, `/dao:list`, `/dao:agents`, `/dao:plan`,
+  `/dao:artefacts`, `/dao:audit`, `/dao:dry-run`, `/dao:roundtable`
+- `/dao:rate`, `/dao:update-proposal`, `/dao:propose-amendment`
+- `/dao:github-config`, `/dao:github-branch`, `/dao:github-pr`
+
+Run `bun run generate-commands` to regenerate the namespace from the registry.
+
+## Discovery
+
+- `dao_help`, `dao_list`, `dao_agents`, `dao_dashboard`, `dao_audit`

package/README.md

@@ -0,0 +1,57 @@
+# @guyghost/swarm-dao-claude-adapter
+
+Swarm DAO governance adapter for **Claude Code** (Anthropic).
+
+It bundles:
+
+- the Swarm DAO MCP server (`swarm-dao-claude` bin)
+- a native `.mcp.json` template
+- a `CLAUDE.md` instructions file
+- ready-made slash commands (`/dao-propose`, `/dao-deliberate`, `/dao-ship`)
+- a `HostAdapter` implementation for programmatic use
+
+## Install
+
+```bash
+npm install @guyghost/swarm-dao-claude-adapter
+```
+
+## Configure
+
+### MCP server
+
+Copy `.mcp.json` into your project root. Claude Code auto-detects it and
+registers the `swarm-dao` MCP server. The `dao_*` tools then become available
+as `mcp__swarm-dao__dao_*`.
+
+### Instructions
+
+Append the contents of `CLAUDE.md` to your repo's `CLAUDE.md` so Claude Code
+follows the DAO workflow.
+
+### Slash commands
+
+Copy the `commands/` directory into `.claude/commands/` to enable:
+
+- `/dao-propose` — scaffold a proposal
+- `/dao-deliberate` — deliberate and record sub-agent outputs
+- `/dao-ship` — control, execute, and ship a proposal
+
+## Run the server directly
+
+```bash
+swarm-dao-claude   # uses $DAO_ROOT or cwd
+```
+
+## Programmatic API
+
+```ts
+import { createClaudeHostAdapter, startClaudeServer } from "@guyghost/swarm-dao-claude-adapter";
+
+const adapter = createClaudeHostAdapter("/path/to/repo");
+await startClaudeServer();
+```
+
+## License
+
+MIT

package/commands/dao-commands.README.md

@@ -0,0 +1,48 @@
+# `/dao:*` commands (generated)
+
+> Auto-generated from `@guyghost/swarm-dao-core`'s `DaoCommandRegistry`.
+> Do not edit by hand — run `bun run scripts/generate-commands.ts`.
+> Claude Code derives command names from filenames (colon namespace in filename).
+
+## Setup
+- [`/dao:setup`](dao:setup.md) `[useDefaults=true]` — Initialize the DAO with the default 7 product agents
+
+## Propose
+- [`/dao:propose`](dao:propose.md) `title type description [acceptanceCriteria...] [affectedPaths...]` — Create a new proposal
+- [`/dao:update-proposal`](dao:update-proposal.md) `proposalId [problemStatement] [acceptanceCriteria] [successMetrics] [rollbackConditions]` — Update structured fields on an open proposal
+
+## Deliberate
+- [`/dao:deliberate`](dao:deliberate.md) `proposalId` — Run swarm deliberation / build the dispatch plan
+- [`/dao:record-outputs`](dao:record-outputs.md) `proposalId outputs[]` — Record sub-agent outputs and finalize deliberation
+
+## Control
+- [`/dao:control`](dao:control.md) `proposalId` — Run the quality-control gates
+
+## Execute
+- [`/dao:execute`](dao:execute.md) `proposalId` — Execute an approved / controlled proposal
+
+## Ship
+- [`/dao:ship`](dao:ship.md) `proposalId [cascade] [force]` — Ship a controlled proposal (optionally cascade dependencies)
+
+## Retro
+- [`/dao:rollback`](dao:rollback.md) `proposalId` — Revert an executed proposal to its pre-execution snapshot
+- [`/dao:rate`](dao:rate.md) `proposalId score comment` — Rate a proposal outcome (1–5 stars)
+
+## Discover
+- [`/dao:help`](dao:help.md) — Show the DAO workflow and every available command
+- [`/dao:status`](dao:status.md) — Show the governance health dashboard
+- [`/dao:list`](dao:list.md) `[--status] [--type]` — List all proposals
+- [`/dao:agents`](dao:agents.md) — List the configured DAO agents
+- [`/dao:plan`](dao:plan.md) `proposalId` — Show the delivery plan for a proposal
+- [`/dao:artefacts`](dao:artefacts.md) `proposalId` — View the auto-generated artefacts for a proposal
+- [`/dao:audit`](dao:audit.md) `[proposalId]` — View the audit trail
+- [`/dao:dry-run`](dao:dry-run.md) `proposalId` — Preview execution without applying changes
+- [`/dao:roundtable`](dao:roundtable.md) — Ask every agent to suggest a proposal idea
+
+## Governance
+- [`/dao:propose-amendment`](dao:propose-amendment.md) `title description amendmentType [agentId] [agentChanges] [configChanges] [addGates] [removeGates]` — Propose an amendment (agents, config, quorum, gates)
+
+## GitHub
+- [`/dao:github-config`](dao:github-config.md) `--token <t> --owner <o> --repo <r>` — Configure the GitHub integration
+- [`/dao:github-branch`](dao:github-branch.md) `proposalId` — Create a GitHub branch for a proposal
+- [`/dao:github-pr`](dao:github-pr.md) `proposalId --head-branch <b>` — Open a GitHub pull request for a proposal

package/commands/dao:agents.md

@@ -0,0 +1,10 @@
+---
+description: List the configured DAO agents
+allowed-tools: mcp__swarm-dao__dao_agents
+---
+
+List the configured DAO agents.
+
+`/dao:agents`
+
+Call the `mcp__swarm-dao__dao_agents` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:artefacts.md

@@ -0,0 +1,10 @@
+---
+description: View the auto-generated artefacts for a proposal
+allowed-tools: mcp__swarm-dao__dao_artefacts
+---
+
+View the auto-generated artefacts for a proposal.
+
+`/dao:artefacts proposalId`
+
+Call the `mcp__swarm-dao__dao_artefacts` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:audit.md

@@ -0,0 +1,10 @@
+---
+description: View the audit trail
+allowed-tools: mcp__swarm-dao__dao_audit
+---
+
+View the audit trail.
+
+`/dao:audit [proposalId]`
+
+Call the `mcp__swarm-dao__dao_audit` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:control.md

@@ -0,0 +1,10 @@
+---
+description: Run the quality-control gates
+allowed-tools: mcp__swarm-dao__dao_control
+---
+
+Run the quality-control gates.
+
+`/dao:control proposalId`
+
+Call the `mcp__swarm-dao__dao_control` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:deliberate.md

@@ -0,0 +1,10 @@
+---
+description: Run swarm deliberation / build the dispatch plan
+allowed-tools: mcp__swarm-dao__dao_deliberate, mcp__swarm-dao__dao_record_outputs, mcp__swarm-dao__dao_control, Task
+---
+
+Run swarm deliberation / build the dispatch plan.
+
+`/dao:deliberate proposalId`
+
+Call the `mcp__swarm-dao__dao_deliberate` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:dry-run.md

@@ -0,0 +1,10 @@
+---
+description: Preview execution without applying changes
+allowed-tools: mcp__swarm-dao__dao_dry_run
+---
+
+Preview execution without applying changes.
+
+`/dao:dry-run proposalId`
+
+Call the `mcp__swarm-dao__dao_dry_run` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:execute.md

@@ -0,0 +1,10 @@
+---
+description: Execute an approved / controlled proposal
+allowed-tools: mcp__swarm-dao__dao_execute
+---
+
+Execute an approved / controlled proposal.
+
+`/dao:execute proposalId`
+
+Call the `mcp__swarm-dao__dao_execute` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:github-branch.md

@@ -0,0 +1,10 @@
+---
+description: Create a GitHub branch for a proposal
+allowed-tools: mcp__swarm-dao__dao_github_create_branch
+---
+
+Create a GitHub branch for a proposal.
+
+`/dao:github-branch proposalId`
+
+Call the `mcp__swarm-dao__dao_github_create_branch` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:github-config.md

@@ -0,0 +1,10 @@
+---
+description: Configure the GitHub integration
+allowed-tools: mcp__swarm-dao__dao_config_github
+---
+
+Configure the GitHub integration.
+
+`/dao:github-config --token <t> --owner <o> --repo <r>`
+
+Call the `mcp__swarm-dao__dao_config_github` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:github-pr.md

@@ -0,0 +1,10 @@
+---
+description: Open a GitHub pull request for a proposal
+allowed-tools: mcp__swarm-dao__dao_github_open_pr
+---
+
+Open a GitHub pull request for a proposal.
+
+`/dao:github-pr proposalId --head-branch <b>`
+
+Call the `mcp__swarm-dao__dao_github_open_pr` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:help.md

@@ -0,0 +1,10 @@
+---
+description: Show the DAO workflow and every available command
+allowed-tools: mcp__swarm-dao__dao_help
+---
+
+Show the DAO workflow and every available command.
+
+`/dao:help`
+
+Call the `mcp__swarm-dao__dao_help` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:list.md

@@ -0,0 +1,10 @@
+---
+description: List all proposals
+allowed-tools: mcp__swarm-dao__dao_list
+---
+
+List all proposals.
+
+`/dao:list [--status] [--type]`
+
+Call the `mcp__swarm-dao__dao_list` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:plan.md

@@ -0,0 +1,10 @@
+---
+description: Show the delivery plan for a proposal
+allowed-tools: mcp__swarm-dao__dao_plan
+---
+
+Show the delivery plan for a proposal.
+
+`/dao:plan proposalId`
+
+Call the `mcp__swarm-dao__dao_plan` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:propose-amendment.md

@@ -0,0 +1,10 @@
+---
+description: Propose an amendment (agents, config, quorum, gates)
+allowed-tools: mcp__swarm-dao__dao_propose_amendment
+---
+
+Propose an amendment (agents, config, quorum, gates).
+
+`/dao:propose-amendment title description amendmentType [agentId] [agentChanges] [configChanges] [addGates] [removeGates]`
+
+Call the `mcp__swarm-dao__dao_propose_amendment` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:propose.md

@@ -0,0 +1,10 @@
+---
+description: Create a new proposal
+allowed-tools: mcp__swarm-dao__dao_propose
+---
+
+Create a new proposal.
+
+`/dao:propose title type description [acceptanceCriteria...] [affectedPaths...]`
+
+Call the `mcp__swarm-dao__dao_propose` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:rate.md

@@ -0,0 +1,10 @@
+---
+description: Rate a proposal outcome (1–5 stars)
+allowed-tools: mcp__swarm-dao__dao_rate
+---
+
+Rate a proposal outcome (1–5 stars).
+
+`/dao:rate proposalId score comment`
+
+Call the `mcp__swarm-dao__dao_rate` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:record-outputs.md

@@ -0,0 +1,10 @@
+---
+description: Record sub-agent outputs and finalize deliberation
+allowed-tools: mcp__swarm-dao__dao_record_outputs
+---
+
+Record sub-agent outputs and finalize deliberation.
+
+`/dao:record-outputs proposalId outputs[]`
+
+Call the `mcp__swarm-dao__dao_record_outputs` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:rollback.md

@@ -0,0 +1,10 @@
+---
+description: Revert an executed proposal to its pre-execution snapshot
+allowed-tools: mcp__swarm-dao__dao_rollback
+---
+
+Revert an executed proposal to its pre-execution snapshot.
+
+`/dao:rollback proposalId`
+
+Call the `mcp__swarm-dao__dao_rollback` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:roundtable.md

@@ -0,0 +1,10 @@
+---
+description: Ask every agent to suggest a proposal idea
+allowed-tools: mcp__swarm-dao__dao_roundtable
+---
+
+Ask every agent to suggest a proposal idea.
+
+`/dao:roundtable`
+
+Call the `mcp__swarm-dao__dao_roundtable` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:setup.md

@@ -0,0 +1,10 @@
+---
+description: Initialize the DAO with the default 7 product agents
+allowed-tools: mcp__swarm-dao__dao_setup
+---
+
+Initialize the DAO with the default 7 product agents.
+
+`/dao:setup [useDefaults=true]`
+
+Call the `mcp__swarm-dao__dao_setup` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:ship.md

@@ -0,0 +1,10 @@
+---
+description: Ship a controlled proposal (optionally cascade dependencies)
+allowed-tools: mcp__swarm-dao__dao_ship, mcp__swarm-dao__dao_control, mcp__swarm-dao__dao_execute, mcp__swarm-dao__dao_rate
+---
+
+Ship a controlled proposal (optionally cascade dependencies).
+
+`/dao:ship proposalId [cascade] [force]`
+
+Call the `mcp__swarm-dao__dao_ship` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:status.md

@@ -0,0 +1,10 @@
+---
+description: Show the governance health dashboard
+allowed-tools: mcp__swarm-dao__dao_dashboard
+---
+
+Show the governance health dashboard.
+
+`/dao:status`
+
+Call the `mcp__swarm-dao__dao_dashboard` MCP tool. Pass `$ARGUMENTS` through.

package/commands/dao:update-proposal.md

@@ -0,0 +1,10 @@
+---
+description: Update structured fields on an open proposal
+allowed-tools: mcp__swarm-dao__dao_update_proposal
+---
+
+Update structured fields on an open proposal.
+
+`/dao:update-proposal proposalId [problemStatement] [acceptanceCriteria] [successMetrics] [rollbackConditions]`
+
+Call the `mcp__swarm-dao__dao_update_proposal` MCP tool. Pass `$ARGUMENTS` through.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startClaudeServer } from "./index.js";
+startClaudeServer().catch((error) => {
+    console.error("[swarm-dao-claude] fatal:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAClC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { HostAdapter } from "@guyghost/swarm-dao-core";
+import { resolveDaoRoot } from "@guyghost/swarm-dao-mcp";
+export { resolveDaoRoot };
+/** Host adapter specialized for Claude Code (`hostId = "claude"`). */
+export declare function createClaudeHostAdapter(workDir?: string): HostAdapter;
+/** Boot the Swarm DAO MCP server with Claude defaults. */
+export declare function startClaudeServer(workDir?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAA0B,cAAc,EAA0B,MAAM,yBAAyB,CAAC;AAEzG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,OAAO,SAAmB,GAAG,WAAW,CAE/E;AAED,0DAA0D;AAC1D,wBAAsB,iBAAiB,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { createStdioHostAdapter, resolveDaoRoot, startSwarmDaoMcpServer } from "@guyghost/swarm-dao-mcp";
+export { resolveDaoRoot };
+/** Host adapter specialized for Claude Code (`hostId = "claude"`). */
+export function createClaudeHostAdapter(workDir = resolveDaoRoot()) {
+    return createStdioHostAdapter("claude", workDir);
+}
+/** Boot the Swarm DAO MCP server with Claude defaults. */
+export async function startClaudeServer(workDir = resolveDaoRoot()) {
+    await startSwarmDaoMcpServer(workDir);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEzG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,sEAAsE;AACtE,MAAM,UAAU,uBAAuB,CAAC,OAAO,GAAG,cAAc,EAAE;IAChE,OAAO,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAO,GAAG,cAAc,EAAE;IAChE,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@guyghost/swarm-dao-claude-adapter",
+  "version": "0.2.0",
+  "description": "Swarm DAO governance adapter for Claude Code — MCP server, native config, slash commands, and CLAUDE.md",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "bin": {
+    "swarm-dao-claude": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".mcp.json",
+    "CLAUDE.md",
+    "commands"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "generate-commands": "bun run scripts/generate-commands.ts",
+    "prebuild": "bun run generate-commands",
+    "build": "tsc",
+    "test": "bun test",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@guyghost/swarm-dao-core": "^0.3.0",
+    "@guyghost/swarm-dao-mcp": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "keywords": [
+    "swarm-dao",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "mcp",
+    "dao",
+    "governance",
+    "multi-agent",
+    "deliberation",
+    "quality-gates"
+  ],
+  "author": "guyghost",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guyghost/swarm-dao.git",
+    "directory": "packages/claude-adapter"
+  },
+  "bugs": {
+    "url": "https://github.com/guyghost/swarm-dao/issues"
+  },
+  "homepage": "https://github.com/guyghost/swarm-dao#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}