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/scafldruns a local binary instead of downloading.SCAFLD_INSTALL_DIR=/custom/cachecontrols where downloaded binaries are cached.SCAFLD_INSTALL_BASE_URL=https://host/assetsdownloads release assets from a mirror.
Links
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file scafld-2.5.8.tar.gz.
File metadata
- Download URL: scafld-2.5.8.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
365bb55fe54fe603bc93495e46f6056847086076c4f479ed8612ee6b83f2db60
|
|
| MD5 |
0381a6062f839e3b169efbdf7fb60740
|
|
| BLAKE2b-256 |
56faf59685e09ce90d99edfc1e65c4685c2f357619cfd1fc970a6cf16115fd92
|
File details
Details for the file scafld-2.5.8-py3-none-any.whl.
File metadata
- Download URL: scafld-2.5.8-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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d9cf9d2a2c3b3fa0870f00b45f73d566b51a91cc79b6c4b7e5f9e20fd7e7eea1
|
|
| MD5 |
5827545006765ad44e0502df232bd6fd
|
|
| BLAKE2b-256 |
7d818dfceeea86c8d53c238998223f7ccb8fee7ca9e5c7aa48f34b8333b44e04
|
