Pack capabilities
Packs
- Package reusable capabilities in
packs/<slug>/with immutable versions. Publish changes as new versions; projects choose when to update. - Installed Pack files belong to the project.
.yoke/packs.jsonrecords the baseline for a three-way update (yoke packs update --help). - An unreleased version installs with
--catalog commit:SHA; served-catalog updates refuse withpack-source-unreleaseduntil a release carries it. - Config lives in DB settings (
project_capabilities,sites.settings,environments.settings) or project.yoke/policy, not in the Pack.
Credentials
Credentials belong to project capabilities; bare aws ... may fail. Use Yoke's capability
resolver for subprocess credentials. Verify keys or redacted evidence;
never print secrets.
Storage: capabilities.
Declared infrastructure
Declare external resources and settings in project IaC in the same change. Import or remove anything created by hand during investigation; record which you did. Emergency patches need operator approval and immediate IaC catch-up. Put reusable infrastructure in Packs.