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 finalize add-cache

The lifecycle is deliberately small:

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

review is the only provider/model call. finalize consumes its accepted evidence, runs deterministic acceptance, signs the receipt, and archives the spec without another model call. 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.6.tar.gz (4.5 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.6-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: scafld-2.5.6.tar.gz
  • Upload date:
  • Size: 4.5 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.6.tar.gz
Algorithm Hash digest
SHA256 cf3907b38d763d3b0fbcc887e65da719ca81c3501e200d61e056fffc5b68e966
MD5 4bfddf6b804fc9dba7751e1a39e6aa83
BLAKE2b-256 e090f7503f6af8c5e477b6b34f26152e16ec5bbe19c7905aed2ab244a8a1b682

See more details on using hashes here.

File details

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

File metadata

  • Download URL: scafld-2.5.6-py3-none-any.whl
  • Upload date:
  • Size: 5.5 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 c2f582c007f60bdeb49705768303fd46decfef23fd2761e07e9af812a1605b31
MD5 2b37fa3914c1e53b938a316cbaf33061
BLAKE2b-256 3b0103f48535109cb1594147e6b739766342f98d0118733b09d5f51bff4b4a62

See more details on using hashes here.

Release history Release notifications | RSS feed

2.5.8

2 files

2.5.7

2 files

This release

2.5.6 This release

2 files

2.5.5

2 files

2.5.4

2 files

2.5.3

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