Skip to content

Releases: navapbc/agentic-workspace

v0.2.0 — the support layer becomes an installable engine

Choose a tag to compare

@joseoyolas joseoyolas released this 29 Jul 21:49
c4c0d19

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.yaml and 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.sh and 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.env is retired in favor of the machine-local descriptor. A machine path in a shared file is now a hard validation failure.
  • templates/skills/ and templates/context-fabric/ are consolidated into templates/support/.
  • skill-manifest.yaml entries are now id / path / status, and a paused entry requires a review_by date.
  • Records require contentLocations; repository resources require organization, repository, checkoutDirectory; accessState uses available (was accessible).

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

Choose a tag to compare

@joseoyolas joseoyolas released this 29 Jul 21:50

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.