Millrace Plus

Millrace Plus is the official collection of ready-to-run Millrace workflows and agent-authoring skills.

Millrace itself is a generic workflow runtime. This package supplies the workflow definitions, entrypoint prompts, stage skills, and examples that make the runtime useful out of the box. It contains data only: no daemon, CLI, runner, provider, plugin, or installation hook.

Release line: millrace-plus 0.22.3 accompanies Core 0.22.3 (fresh store schema 11 and compiled-plan schema 18) with Millforge 0.1.1. Install the complete bundle with pip install millrace==0.22.3 on Python 3.12+. OS/provider qualification and the complete ecosystem MVP remain separate.

Included Workflows

Every workflow is ordinary package data. Names such as Management, Planning, Execution, Learning, and Review do not have special meaning inside the Millrace kernel.

The experimental execution.lad_codex_semantic_worktree workflow is deferred from this MVP release. It is not selectable or distributed; the preserved campaign evidence does not establish semantic-workspace efficacy or incompatibility.

Read Workflow guide for the intended use and shape of each configuration.

Included Agent Skills

Millrace Plus also ships three guides for agents that operate or configure Millrace:

• millrace-instruction-manual explains when to use Millrace and how to operate it through the CLI.
• millrace-loop-configuration helps turn a fully specified decision tree into a valid workflow package.
• millrace-entrypoint-authoring explains how to write stage prompts and their paired core skills.

These files are advisory documentation. Installing the package does not copy them into Codex, Claude Code, or another agent's skill directory.

How The Package Is Used

The workflow package lives under millrace_workflow_package/. Its manifest declares package ID millrace.plus.official, the selectable workflows, and the exact path, size, and digest of every workflow asset.

Millrace imports those files as bytes, validates them, and compiles one selected workflow entrypoint. It does not import millrace_plus modules or execute package code to discover workflows.

The installed resource root is millrace_workflow_package; package data is non-executable. A direct installation contains package metadata and data only and does not transitively install millrace-ai or another member distribution.

The millrace==0.22.3 convenience bundle installs Core and Plus 0.22.3 with Millforge 0.1.1. Maintainers can validate exact member wheels using Validation. Member distributions version independently. Each millrace meta-distribution release pins one tested combination and may reuse an unchanged compatible member. A future millrace bundle must publish and pin its own tested combination.

Authoring Model

Each agent stage normally selects two text assets:

The workflow graph owns routing, queue movement, retries, waits, and completion. Prompt text can explain those rules to an agent, but it cannot create them.

Start with Authoring workflows. The frozen manifest rules are documented in Manifest maintenance.

Repository Layout

millrace_workflow_package/
  manifest.json
  assets/workflows/
src/millrace_plus/skills/
docs/
tests/

millrace_workflow_package/ is the runtime-readable workflow package. src/millrace_plus/skills/ contains the advisory agent skills outside the workflow manifest.

Validation

The package can be validated without a Millrace source checkout:

env -u PYTHONPATH PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 \
  PYTHONDONTWRITEBYTECODE=1 \
  uv run --no-project --with pytest --with hatchling pytest -q \
    tests/test_package_metadata.py \
    tests/test_manifest_authoring_policy.py \
    tests/test_official_package_layout_plan.py \
    tests/test_workflow_package_manifest.py \
    tests/test_workflow_package_installed_smoke.py \
    tests/test_public_package_boundary.py \
    tests/test_agent_skill_assets.py

See Validation for build and artifact checks, and Release details for packaging and versioning rules.

License

Millrace Plus is licensed under the Apache License 2.0.