Skip to content

Home

Jump to bottom
coo1white edited this page Jun 11, 2026 · 15 revisions

Cool Workflow Wiki

Cool Workflow, or CW, is an independent auditable workflow control-plane by COOLWHITE LLC.

Its goal is to turn agent work from one-off prompt improvisation into an inspectable workflow runtime:

define -> dispatch -> observe -> verify -> commit -> report

CW is a small workflow kernel for coding-agent-era work. It is CLI-backed, MCP-first, skill-packaged, and runtime-compatible with Node-compatible TypeScript output.

Start Here

The differentiator (v0.1.77–v0.1.78):

Core Loop

CW records the agent loop explicitly:

interpret -> act -> observe -> adjust -> checkpoint

That loop is reflected in durable run state, task records, dispatch manifests, worker results, verifier decisions, commit snapshots, reports, and audit records.

Current Capability Map

  • Workflow App framework for versioned, validated, reusable workflow apps.
  • CLI runtime for planning, dispatching, result recording, scoring, committing, reporting, scheduling, and routine triggers.
  • MCP JSON-RPC surface for host integrations.
  • Sandbox Profiles for named worker policy contracts.
  • Worker isolation and candidate scoring.
  • Verifier-gated commits and explicit checkpoints.
  • Operator UX for human-readable status, graph, report, worker, candidate, feedback, commit, topology, multi-agent, blackboard, coordinator, and trust summaries.
  • Coordinator / Blackboard for shared topics, messages, context frames, artifact refs, snapshots, decisions, conflicts, and fanin evidence.
  • Multi-Agent Runtime Core for runs, roles, groups, memberships, fanout, fanin, and lifecycle state.
  • Multi-Agent Topologies for official map-reduce, debate, and judge-panel recipes — plus custom topologies via registerTopology().
  • Multi-Agent trust / policy / audit, operator UX, and a deterministic eval / replay harness with regression gates.
  • State Explosion Management: derived, fingerprinted summaries and compact graph views for large runs.
  • Evidence Adoption Reasoning Chain: records why a result was adopted or rejected (basis, authority, rationale, counterfactual), fail-closed.
  • CLI ↔ MCP Parity: one capability registry as the single source of truth for both surfaces, enforced fail-closed.
  • Run Registry / Control Plane: cross-repo search, resume, queue, archive, history, and failed-run rerun over a rebuildable, fingerprinted index.
  • Execution Backends: a pluggable driver layer (node/bun/shell/ container/remote/ci) with identical evidence envelopes and fail-closed sandbox attestation.
  • Cross-vendor distribution: one source-of-truth manifest generates every vendor plugin manifest (Claude/Codex/…) with a fail-closed drift gate.
  • Release and migration discipline with fixture compatibility, version sync, and dry-run release checks.
  • Capability & Topology Registry (v0.1.53): agents extend CW at runtime — registerCapabilityHandler / registerTopology with data-driven role expansion.
  • Workflow orchestration (v0.1.77): ed25519-attested, tamper-evident telemetry (Track 1); concurrent parallel() batches with collect-all + kill-on-timeout (Track 2); per-task schema validation, tokenBudget enforcement, and a compile-time one-way executor boundary (Track 3).
  • Distribution (v0.1.78): published to npm (npm i -g cool-workflow / npx cool-workflow); --agent-command builtin:claude completes real-agent workers; cw demo tamper proves tamper-evidence in one hermetic command.

Install

npm install -g cool-workflow     # then: cw …
npx cool-workflow demo tamper    # 30-second tamper-evidence proof

Repository

  • Main repo: https://github.com/coo1white/cool-workflow
  • Package root: plugins/cool-workflow/
  • Runtime source: plugins/cool-workflow/src/
  • Committed runtime output: plugins/cool-workflow/dist/
  • License: BSD-2-Clause
  • Version: v0.1.53

Source Notes

This wiki was organized from local Obsidian notes under:

/Users/lukebai/Documents/Nick/Cool Workflow/

It was first organized on 2026-06-07, last reconciled on 2026-06-10 (36 source modules · 46 docs · 45 smoke tests · 6 workflow apps · 53 releases).

Organized from local Obsidian notes and reconciled with the current coo1white/cool-workflow repository state.

Cool Workflow

Start here

Go deeper

Source docs

Clone this wiki locally