Distribution Documentation

August 19, 2026 · View on GitHub

Generated by fab memory-index — do not hand-edit. Descriptions come from each file's description: frontmatter.

FileDescription
distributionHow src/kit/ is distributed — Homebrew binaries, version caches, the environment-only FAB_KIT_PATH content override, fab init/sync/doctor/upgrade-repo lifecycle contracts, releases, hardened auto-download, fail-loud exit codes, update safety, version-triplet/bottle-skew detection (fab setup check), and the shll.ai documentation and toolkit-standards surfaces.
kit-architecturesrc/kit/ structure (binary-free, content-only) and the three-binary architecture — fab router, fab-kit workspace lifecycle, and fab-go workflow engine. Covers the environment-only FAB_KIT_PATH content override, sync/cache resolution, lifecycle stamping guards, skill deployment, version tracking, config, dispatch, help, exit-code conventions, the fab setup family (setup wizard, check doctor), the operator state-file verb family, and the internal package map.
migrationsThe migration system — engine/local versions, range-based migration files, binary-owned discovery via fab migrations-status (including FAB_KIT_PATH reader resolution and exit codes), the /fab-setup migrations runner, version-drift detection, and the shipped migration catalog.
setupThe /fab-setup skill — structural bootstrap (doctor → config → constitution → fab sync), subcommands, config create-mode, and delegation to fab-kit sync's resolved kit source. Covers the seven-check doctor gate, fail-loud scaffold merge, gitignore-aware .gitignore dedup, the bare-fab-setup interactive wizard (probe-driven interview, --defaults/--project, surgical config-set writes), and the read-only fab setup check doctor (probe set, exit contract, coexistence with fab doctor).