Releases: navapbc/agentic-workspace
Release list
v0.2.0 — the support layer becomes an installable engine
The support layer stops being something you build and becomes something you install.
templates/support/ ships the engine whole — 55 files — and scripts/install-support.sh installs or upgrades it in place. Exactly two files are team-authored (CONCEPTS.md, docs/context-source-ladder.md), which is what makes upgrades possible without re-merging your own work.
Three failures the previous model walked teams into
Each is now prevented in code and documented as a seeded docs/solutions/ learning:
- Symlink-assembled roots. Harness file viewers do not display symlinked folders' contents, so the workspace vanishes from the UI members work in — while every script still reports success.
- Tools that derive machine paths. Right on the author's machine, quietly wrong on everyone else's. Now declared-only and fail-closed.
- A synced shared folder as the session's primary folder. The harness writes personal settings there and sync distributes them to the team, repeatedly. The launch shape is the fix, not the cleanup.
Added
- Multi-root topology — several physical directories handed to the harness, declared per machine in
~/.agentic-workspace/workspace-descriptor.yamland referenced from shared docs by binding token. workspace-doctor.sh— read-only session-start probe: declared roots, capability tiers, and the one step that unlocks each locked tier. Fail-closed exit codes.- Repo digests — repository questions answered with no git installed and no checkout open.
- Digest-bound checkout sync — preview→apply, full preflight, fetch and fast-forward only, host-agnostic, auth delegated to your git credential helper.
- Deterministic artifact routing with typed, rationalized area exceptions.
- Snapshot-first record editing plus a dependency-free record lint.
check-workspace.shand two behavioral test suites.- Three enabled skills, including
workspace-setup, which interviews a new member from folder access to doctor-green.
Requires bash and jq; git only for checkouts. No language runtime.
Breaking changes
bindings.envis retired in favor of the machine-local descriptor. A machine path in a shared file is now a hard validation failure.templates/skills/andtemplates/context-fabric/are consolidated intotemplates/support/.skill-manifest.yamlentries are nowid/path/status, and a paused entry requires areview_bydate.- Records require
contentLocations; repository resources requireorganization,repository,checkoutDirectory;accessStateusesavailable(wasaccessible).
Upgrading from v0.1.0: run ./scripts/install-support.sh <workspace> --check first — it reports what would change and never overwrites a locally modified file without --force.
Full detail in CHANGELOG.md. New here? Open reference/sandbox/ and follow its five-minute tour.
v0.1.0
The initial Agentic Workspace Starter Kit: the three-layer operating model (guidance / support / product-work), harness- and model-agnostic.
Docs (architecture, phased adoption, local setup, collaboration and governance, Context Fabric, naming standard, glossary), workspace and Context Fabric record templates, a portable skill bundle with adapters and a sync script, the scaffolding and validation scripts, and a generated fictional sandbox workspace.
Tagged retroactively so the CHANGELOG's compare links resolve. The tagged commit is the genericized initial import; the public open-source scaffolding (license, community health files, CI) and everything after it shipped in v0.2.0.
Superseded by v0.2.0, which retires bindings.env and consolidates the templates. See its notes for the upgrade path.