claude-mcp-workflow 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "workflow",
+  "version": "1.0.0",
+  "description": "Structured workflow orchestration for AI agents via finite-state machines",
+  "author": {
+    "name": "AxGord",
+    "email": "axgord@gmail.com",
+    "url": "https://github.com/AxGord"
+  },
+  "homepage": "https://github.com/AxGord/claude-workflow",
+  "repository": "https://github.com/AxGord/claude-workflow",
+  "license": "MIT"
+}

package/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "wf": {
+      "command": "node",
+      "args": ["./build/index.js"],
+      "env": {}
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AxGord
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,260 @@
+<p align="center">
+  <img src="docs/banner.png" alt="Claude Workflow" width="100%">
+</p>
+
+<p align="center">
+  <a href="package.json"><img src="https://img.shields.io/badge/version-1.0.0-blue" alt="Version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.7-3178c6" alt="TypeScript"></a>
+  <a href="https://code.claude.com/docs/en/plugins"><img src="https://img.shields.io/badge/Claude_Code-Plugin-ff6600" alt="Claude Code Plugin"></a>
+</p>
+
+A Claude Code plugin that drives agents through YAML-defined state machines. The engine tracks state, enforces guards, manages nested sub-workflow stacks, and visualizes everything in a web dashboard.
+
+![Master workflow graph](docs/screenshots/workflow-master.png)
+
+## Features
+
+- **FSM-based state machines** — define workflows in YAML with states, transitions, and prompts
+- **Stack-based sub-workflows** — states can push nested workflows (max depth 10), auto-pop on completion
+- **Three-tier loading** — bundled templates < global (`~/.claude/workflows/`) < project (`.claude/workflows/`)
+- **Snapshot isolation** — workflow definitions frozen at session start; hot-reloads don't affect running sessions
+- **Runtime overlays** — modify workflows on the fly without touching YAML files
+- **Web dashboard** — real-time session monitoring with DAG graph visualization
+- **16 bundled workflows** — complete agent lifecycle from routing to reflection
+- **8 bundled skills** — reusable knowledge modules auto-provisioned on first run
+- **SessionStart hook** — auto-provisions missing skills and injects workflow context
+
+## Quick Start
+
+### From the Official Marketplace
+
+```
+/plugin install workflow@claude-plugin-directory
+```
+
+### From GitHub
+
+```bash
+# 1. Add the repository as a marketplace source
+/plugin marketplace add AxGord/claude-workflow
+
+# 2. Install the plugin
+/plugin install workflow@AxGord-claude-workflow
+```
+
+### Manual (for development)
+
+```bash
+git clone https://github.com/AxGord/claude-workflow.git
+cd claude-workflow
+npm install
+npm run build
+claude --plugin-dir ./
+```
+
+## How It Works
+
+```
+Agent                       Engine                          Storage
+  │                           │                               │
+  ├── start() ───────────────►├─ snapshot workflows ─────────►├ session.json
+  │◄── initial state prompt ──┤                               │
+  │                           │                               │
+  ├── transition() ──────────►├─ validate & advance ─────────►├ update JSON
+  │◄── new state prompt ──────┤  (push/pop sub-workflows)     │
+  │                           │                               │
+  ├── transition() ──────────►├─ terminal state? ────────────►├ mark complete
+  │◄── done ──────────────────┤  (auto-pop to parent)         │
+```
+
+1. `start()` — creates a session, snapshots all workflow definitions, returns the initial state prompt
+2. `transition()` — validates the transition, advances state, handles sub-workflow push/pop, returns the new prompt
+3. Every mutation is atomically persisted to JSON (temp file + rename + lockfile)
+4. Dashboard visualizes sessions and workflow graphs at `localhost:3100`
+
+## Workflow YAML
+
+```yaml
+name: my-workflow
+description: "Example workflow"
+initial: start
+max_transitions: 50
+
+states:
+  start:
+    prompt: "Analyze the task and decide on approach"
+    transitions:
+      implement: write_code
+      explore: research
+
+  research:
+    sub_workflow: explore        # pushes nested workflow
+    on_complete: write_code      # returns here on success
+    on_fail: start               # returns here on failure
+
+  write_code:
+    prompt: "Write the implementation"
+    transitions:
+      done: finish
+
+  finish:
+    terminal: true
+    outcome: complete            # or "fail"
+```
+
+## Three-Tier Loading
+
+Workflows load from three sources in ascending priority — later tiers override earlier ones:
+
+| Tier | Path | Purpose |
+|------|------|---------|
+| Bundled | `templates/` (plugin root) | Base workflows shipped with the plugin |
+| Global | `~/.claude/workflows/` | User customizations shared across projects |
+| Project | `.claude/workflows/` | Project-specific workflows |
+
+A project workflow named `coding` overrides the bundled `coding` template. Same-name global workflows sit in between.
+
+## Bundled Workflows
+
+| Workflow | Description |
+|----------|-------------|
+| `master` | Single entry point — analyzes task, loads skills, routes to sub-workflows |
+| `coding` | Code writing pipeline: think → delegate → write → review → verify |
+| `bug-fix` | Standard bug fix: classify → diagnose → fix → verify |
+| `new-feature` | New feature implementation with planning and testing |
+| `refactoring` | Bring every touched file to current standards |
+| `debugging` | Diagnose first, fix never (until diagnosed) |
+| `code-review` | Code review with per-file deep analysis |
+| `explore` | Codebase exploration — understand structure, trace code, find patterns |
+| `investigate` | Resolve unknowns before deciding on action |
+| `planning` | Explore, design plan, record workflow context |
+| `testing` | Testing verification — unit tests first, then integration |
+| `web-research` | Check existing knowledge, then delegate to web subagents |
+| `reflection` | Self-reflection after significant tasks — evaluate, classify, act |
+| `subagent` | Lightweight routing for sub-agents (no chat/plan/reflect) |
+| `file-code` | Per-file coding — spawned by coding/bug-fix for each file |
+| `file-review` | Per-file deep review — spawned by code-review for each file |
+
+![Coding workflow graph](docs/screenshots/workflow-coding.png)
+
+## Bundled Skills
+
+Skills are reusable knowledge modules loaded by workflows via `Skill()`. Auto-provisioned to `~/.claude/skills/` on first run if missing.
+
+| Skill | Description |
+|-------|-------------|
+| `preferences` | User's general coding preferences |
+| `architecture` | Simplicity-first architecture decisions |
+| `task-delegation` | When and how to delegate to subagents |
+| `coding-skill-selector` | Select and load coding skills by file extensions and domains |
+| `lang-haxe` | Haxe language gotchas |
+| `lang-python` | Python language gotchas |
+| `math` | Math overflow boundary gotchas |
+| `web-reading` | Fetch web content via subagents |
+
+## MCP Tools
+
+All tools are registered under the `wf` server. Full tool prefix: `mcp__plugin_workflow_wf__`.
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `list` | List all available workflow definitions | — |
+| `start` | Start a workflow, return initial prompt | `workflow`, `actor`, `parent_session_id` |
+| `status` | Get current state, stack, transitions, history | `session_id` |
+| `transition` | Advance to next state (auto push/pop sub-workflows) | `session_id`, `transition` |
+| `context_set` | Save key-value data in session context | `session_id`, `key`, `value` |
+| `modify` | Runtime overlay — add/change/remove states and transitions | `session_id`, `add_state`, `add_transition` |
+| `create` | Create new workflow definition (saves YAML) | `name`, `definition`, `scope` |
+| `delete` | Delete a workflow definition | `name`, `scope` |
+| `abort` | Abort workflow, pop all stack frames | `session_id` |
+| `sessions` | List all sessions (active first) | — |
+
+## Dashboard
+
+The web dashboard runs on `localhost:3100` and provides real-time monitoring:
+
+- **Sessions panel** — active, completed, and abandoned sessions with status badges
+- **Workflow list** — all loaded workflows with state counts
+- **Session detail** — full state history, stack depth, context data
+- **Workflow graphs** — interactive DAG visualization rendered with dagre
+
+### REST API
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/sessions` | List all sessions |
+| `GET` | `/api/session/:id` | Get session detail |
+| `POST` | `/api/session/:id/abandon` | Abandon a session |
+| `GET` | `/api/workflows` | List all workflow definitions |
+
+## Configuration
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `WORKFLOW_DIR` | `~/.claude/workflows/` | Global workflow YAML directory |
+| `STATE_DIR` | `~/.claude/workflow-state/` | Session JSON persistence |
+| `DASHBOARD_PORT` | `3100` | Web dashboard HTTP port |
+
+## Status Line
+
+Show the active workflow and state in Claude Code's status bar:
+
+![Status line showing coding:think](docs/screenshots/statusline.png)
+
+Add this snippet to your statusline script:
+
+```sh
+# Workflow status — add to your ~/.claude/statusline-command.sh
+wf_state_dir="$HOME/.claude/workflow-state"
+if [ -d "$wf_state_dir" ]; then
+  for f in "$wf_state_dir"/*.json; do
+    [ -f "$f" ] || continue
+    slen=$(jq -r '.stack | length' "$f" 2>/dev/null)
+    if [ "$slen" -gt 0 ]; then
+      cpid=$(jq -r '.context.claude_code_pid // 0' "$f" 2>/dev/null)
+      [ "$cpid" != "$PPID" ] && continue
+      wf=$(jq -r '.stack[.active_frame].workflow // ""' "$f" 2>/dev/null)
+      st=$(jq -r '.stack[.active_frame].current_state // ""' "$f" 2>/dev/null)
+      printf "\033[96m\xE2\x9A\x99 %s:%s\033[0m" "$wf" "$st"
+      break
+    fi
+  done
+fi
+```
+
+Then in `~/.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bash ~/.claude/statusline-command.sh"
+  }
+}
+```
+
+## Development
+
+```bash
+npm run build    # tsc → compiles src/ to build/
+npm run dev      # tsc --watch
+npm start        # node build/index.js
+```
+
+### Architecture
+
+| File | Responsibility |
+|------|---------------|
+| `src/index.ts` | Entry point — resolves dirs, wires components, starts stdio transport |
+| `src/engine.ts` | FSM core — start, transition, abort, context, stack push/pop |
+| `src/loader.ts` | YAML loading + Zod validation + fs.watch hot-reload |
+| `src/storage.ts` | JSON persistence with atomic writes and lockfile mutex |
+| `src/modifier.ts` | Runtime overlays + create (YAML writer) |
+| `src/tools.ts` | MCP tool registrations + response formatting |
+| `src/dashboard.ts` | Express REST API + static file serving |
+| `src/types.ts` | Zod schemas, TypeScript types, constants |
+
+## License
+
+MIT

package/build/dashboard.d.ts

@@ -0,0 +1,4 @@
+import type { Storage } from "./storage.js";
+import type { Loader } from "./loader.js";
+export declare function createDashboard(storage: Storage, loader: Loader, port: number): void;
+//# sourceMappingURL=dashboard.d.ts.map

package/build/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiG1C,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGpF"}

package/build/dashboard.js

@@ -0,0 +1,91 @@
+import express from "express";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function buildApp(storage, loader) {
+    const app = express();
+    app.use(express.json());
+    // API endpoints
+    app.get("/api/sessions", (_req, res) => {
+        const sessions = storage.readAll();
+        res.json(sessions);
+    });
+    app.get("/api/session/:id", (req, res) => {
+        const session = storage.read(req.params.id);
+        if (!session) {
+            res.status(404).json({ error: "Session not found" });
+            return;
+        }
+        res.json(session);
+    });
+    app.get("/api/workflows", (_req, res) => {
+        const workflows = loader.getAll();
+        const result = {};
+        for (const [name, wf] of workflows) {
+            result[name] = {
+                name: wf.name,
+                description: wf.description,
+                initial: wf.initial,
+                max_transitions: wf.max_transitions,
+                states: wf.states,
+            };
+        }
+        res.json(result);
+    });
+    // Abandon a session via REST (used by SessionEnd hook)
+    app.post("/api/session/:id/abandon", async (req, res) => {
+        try {
+            const session = storage.read(req.params.id);
+            if (!session) {
+                res.status(404).json({ error: "Session not found" });
+                return;
+            }
+            // Idempotent: already inactive — return current outcome
+            if (session.stack.length === 0) {
+                res.json({ session_id: session.session_id, outcome: session.outcome ?? "completed" });
+                return;
+            }
+            const now = new Date().toISOString();
+            const updated = {
+                ...session,
+                stack: [],
+                active_frame: -1,
+                updated_at: now,
+                history: [...session.history, { frame: session.active_frame, event: "abandon", at: now }],
+                outcome: "abandoned",
+            };
+            await storage.write(session.session_id, updated);
+            res.json({ session_id: session.session_id, outcome: "abandoned" });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // Serve dashboard HTML
+    const dashboardDir = path.resolve(__dirname, "..", "dashboard");
+    app.use(express.static(dashboardDir));
+    app.get("/", (_req, res) => {
+        res.sendFile(path.join(dashboardDir, "index.html"));
+    });
+    return app;
+}
+function tryListen(app, port) {
+    const server = app.listen(port);
+    server.on("listening", () => {
+        console.error(`Dashboard running at http://localhost:${port}`);
+    });
+    server.on("error", (err) => {
+        if (err.code === "EADDRINUSE") {
+            console.error(`Dashboard port ${port} in use — retrying in 20s`);
+            setTimeout(() => tryListen(app, port), 20_000);
+        }
+        else {
+            console.error(`Dashboard error: ${err.message}`);
+        }
+    });
+}
+export function createDashboard(storage, loader, port) {
+    const app = buildApp(storage, loader);
+    tryListen(app, port);
+}
+//# sourceMappingURL=dashboard.js.map

package/build/dashboard.js.map

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

package/build/engine.d.ts

@@ -0,0 +1,55 @@
+import type { StackFrame, HistoryEntry, StateDefinition } from "./types.js";
+import type { Storage } from "./storage.js";
+import type { Loader } from "./loader.js";
+export interface TransitionResult {
+    readonly prompt: string;
+    readonly warnings: string[];
+    readonly autoTransitions: string[];
+}
+export interface TaskOp {
+    readonly action: "create" | "complete";
+    readonly subject: string;
+}
+export interface StatusResult {
+    readonly sessionId: string;
+    readonly stack: StackFrame[];
+    readonly activeFrame: number;
+    readonly currentState: StateDefinition;
+    readonly currentStateName: string;
+    readonly currentWorkflow: string;
+    readonly availableTransitions: Record<string, string>;
+    readonly prompt: string;
+    readonly history: HistoryEntry[];
+    readonly context: Record<string, unknown>;
+    readonly taskOps: TaskOp[];
+    readonly visitCount: number;
+}
+export declare class Engine {
+    private readonly _storage;
+    private readonly _loader;
+    private readonly _snapshots;
+    constructor(storage: Storage, loader: Loader);
+    /** Find the most recently updated active session for the current Claude Code PID. */
+    resolveSessionId(sessionId?: string): string;
+    start(workflowName: string, actor?: string, parentSessionId?: string): Promise<StatusResult>;
+    transition(sessionId: string, transitionName: string, actor?: string): Promise<StatusResult>;
+    abort(sessionId: string): Promise<void>;
+    getStatus(sessionId: string): StatusResult;
+    /**
+     * Retry a deferred pop. Called by Modifier after overlays change,
+     * in case on_complete/on_fail was added to the parent state.
+     * Returns the new status if pop succeeded, or null if still pending.
+     */
+    retryPendingPop(sessionId: string): Promise<StatusResult | null>;
+    setContext(sessionId: string, key: string, value: unknown, actor?: string): Promise<void>;
+    private _pushSubWorkflow;
+    private _popStack;
+    private _formatChildrenBlockError;
+    private _getActiveChildren;
+    private _cascadeAbandonChildren;
+    private _getWorkflow;
+    private _resolveState;
+    private _applyTransitionOverrides;
+    private _buildStatus;
+}
+//# sourceMappingURL=engine.d.ts.map

package/build/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,YAAY,EAEZ,eAAe,EAEhB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2D;gBAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAK5C,qFAAqF;IAC9E,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAWtC,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA0D5F,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA8G5F,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAMjD;;;;OAIG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAsBhE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAexF,gBAAgB;YAuChB,SAAS;IAiHvB,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,kBAAkB;YAMZ,uBAAuB;IAkBrC,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,yBAAyB;IAyBjC,OAAO,CAAC,YAAY;CA8CrB"}