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

Uploaded Python 3

File details

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

File metadata

  • Download URL: scafld-2.5.7.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.7.tar.gz
Algorithm Hash digest
SHA256 22dd6765aadafeb654074ca795f7699b0e11bc9c955cf09b1c59e994a70a3445
MD5 40ac6c8600c87352c42dccb5dd7b2f3c
BLAKE2b-256 b4276f68c651963ef096e25c92a870581a13864c800c11b54f6717b0f00f2da7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: scafld-2.5.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 2fa29a13963b5350e0f68365de97c07b4bdd73188f4809dc859f8ba5c24a0e0b
MD5 e64a5c3a0c1ced78dc8af57442e0cf94
BLAKE2b-256 715ba0acc8bfcb2eb3f8278c480de4e5d3ed73e52af1c6d4b09dfd60f274a4ae

See more details on using hashes here.

Release history Release notifications | RSS feed

2.5.8

2 files

This release

2.5.7 This release

2 files

2.5.6

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