scafld

A deterministic protocol for multi-phase agent work. The agent passes through. The protocol stays.

Plans outlive agents. Sessions hold the receipts. Reviews take nothing on faith.

Given the same spec and session ledger, scafld derives the same state, next command, and review gate.

scafld is spec-driven orchestration for AI coding agents. The work starts from an explicit spec, gets hardened before real effort, executes phase-bounded, and ships only through adversarial review. The differentiator is simple: the agent does not get to grade its own homework.

Install

pipx install scafld
scafld --version

This PyPI package installs a scafld console script that downloads and runs the native Go binary from the matching GitHub release.

Quick Start

scafld init
scafld plan add-cache --command "go test ./..."
scafld harden add-cache
scafld harden add-cache --mark-passed
scafld approve add-cache
scafld build add-cache
scafld review add-cache
scafld complete add-cache

The lifecycle is deliberately small:

draft -> harden -> approved -> active -> review -> completed

complete only closes reviewed work. If adversarial review finds a blocking issue, scafld sends the task to repair instead of letting the implementation agent wave itself through.

Distribution Shim

The Go binary is the product. This PyPI package is a distribution shim that fetches the matching native binary from GitHub releases.

Environment overrides:

  • SCAFLD_BINARY=/path/to/scafld runs a local binary instead of downloading.
  • SCAFLD_INSTALL_DIR=/custom/cache controls where downloaded binaries are cached.
  • SCAFLD_INSTALL_BASE_URL=https://host/assets downloads release assets from a mirror.

Links

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.5.8)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for 0state from gravatar.com 0state

Credits

Author: 0state

License expression

MIT
View SPDX License List

Requires

Python >=3.9

Tags

cli go markdown agents workflow

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scafld-2.5.3.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scafld-2.5.3-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file scafld-2.5.3.tar.gz.

File metadata

  • Download URL: scafld-2.5.3.tar.gz
  • Upload date:
  • Size: 4.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for scafld-2.5.3.tar.gz
Algorithm Hash digest
SHA256 93c27a1a30089e6d4b2d10899975113e464953046a537a28ddd2dc6a30a56137
MD5 20fae6ee544a21ddc34b7f8c5be88b65
BLAKE2b-256 aebe62fe9cf8c21024fac7b80d88111764efdda1ca56f42bd3f44670176697a3

See more details on using hashes here.

File details

Details for the file scafld-2.5.3-py3-none-any.whl.

File metadata

  • Download URL: scafld-2.5.3-py3-none-any.whl
  • Upload date:
  • Size: 5.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for scafld-2.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d1202d9d201d7344dae11b3ddd5a9d8373ec1ff38a094c5d468905f9a07f9844
MD5 7309b011ac0d63aa960c9d47e3cfb7be
BLAKE2b-256 606421fc7a751489963784b2e48c51f31e5a5d47cec1496bcaca56f9ba43fdda

See more details on using hashes here.

Release history Release notifications | RSS feed

2.5.8

2 files

2.5.7

2 files

2.5.6

2 files

2.5.5

2 files

2.5.4

2 files

This release

2.5.3 This release

2 files

2.5.2

2 files

2.5.1

2 files

2.5.0

2 files

2.4.8

2 files

2.4.7

2 files

2.4.6

2 files

2.4.5

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.12

2 files

2.3.11

2 files

2.3.10

2 files

2.3.9

2 files

2.3.8

2 files

2.3.7

2 files

2.3.6

2 files

2.3.5

2 files

2.3.4

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.4

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.1

2 files

2.1.0

2 files

2.0.0

2 files

1.7.2

2 files

1.7.0

2 files

1.6.6

2 files

1.6.5

2 files

1.6.0

2 files

1.5.1

2 files

1.5.0

2 files

1.4.6

2 files

1.4.5

2 files

1.4.4

2 files

1.4.3

2 files

1.4.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page