Skip to content

Home

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

Cool Workflow Wiki

Cool Workflow, or CW, is an independent Agent Workflow SDK 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

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 SDK 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.
  • NEW v0.1.53: Capability & Topology Registry — agents can extend CW at runtime. registerCapabilityHandler({ descriptor, run }) auto-registers new tools across CLI + MCP + Workbench. registerTopology(definition) adds custom topologies with data-driven role expansion.

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