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.5.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.5-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: scafld-2.5.5.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.5.tar.gz
Algorithm Hash digest
SHA256 bc56b1ca429fa5017cce29f69a7107c68d7f8ef28df77a2191d90455e90d767c
MD5 9cf03457e0d9d91a5f21bbf555d5e1f2
BLAKE2b-256 fb5dd48a13a9458779c6fc6e956008670442576c60221e4a6369233fd2ec5343

See more details on using hashes here.

File details

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

File metadata

  • Download URL: scafld-2.5.5-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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 6d43a10f16bdc9132c97bd32a4c52c32277f9f08d086369f0d153cc4b2908981
MD5 a717f154bf06680cc2dab66de8cbe88a
BLAKE2b-256 864826fa44c6c6e7dc19044fe1382c3a4d33d812401697fcf03fe468059a0d8f

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

This release

2.5.5 This release

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