From 8f9e6e796e549065923747e1e494b99918f2be49 Mon Sep 17 00:00:00 2001 From: Suleiman Shahbari Date: Sat, 29 Aug 2026 00:42:37 +0300 Subject: [PATCH] The skill's SPECs stop narrating the caller's dashboard --- packages/skill-branches/SPEC.md | 2 +- packages/skill-branches/src/cli.SPEC.md | 2 +- packages/skill-branches/src/reclaim.SPEC.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/skill-branches/SPEC.md b/packages/skill-branches/SPEC.md index 8f7b1c59..2c7bc1fa 100644 --- a/packages/skill-branches/SPEC.md +++ b/packages/skill-branches/SPEC.md @@ -1,6 +1,6 @@ Branch management for coding agents, as an npm package: one git checkout per agent under a project's `.branches/`, named as its branch; the parent checkout's dependencies shared into it; a navigable link per branch name; one retention rule under which a checkout is reclaimed — only once everything it holds is on the remote; and the instructions an agent follows to live inside that rule (`SKILL.md`). -The package knows git and the filesystem, nothing else. The same functions serve every caller: a daemon that starts agents (allocation, teardown, the reclaim sweep), a dashboard (the retained-checkouts list, the Remove and Prune buttons), and an agent's own shell, through the `branches` command a daemon puts on the PATH of every agent it starts on its machine. What a caller knows beyond git — whether an agent is still running, whether its handoff allows a push, what a cloud hand-off already pushed — is passed in; the package never reads an agent's record. +The package knows git and the filesystem, nothing else. The same functions serve every caller: a daemon that starts agents, a dashboard that lists and reclaims checkouts, and an agent's own shell, through the `branches` command a daemon puts on the PATH of every agent it starts on its machine. What a caller knows beyond git — whether an agent is still running, whether its handoff allows a push, what a cloud hand-off already pushed — is passed in; the package never reads an agent's record. ## Business logic — TL;DR diff --git a/packages/skill-branches/src/cli.SPEC.md b/packages/skill-branches/src/cli.SPEC.md index 2939202c..1396bdd0 100644 --- a/packages/skill-branches/src/cli.SPEC.md +++ b/packages/skill-branches/src/cli.SPEC.md @@ -4,7 +4,7 @@ The package's command line: the same operations a daemon calls, for an agent (or - An agent, started inside its own checkout, names its session and learns the branch name it got. - An agent checks, before it finishes, that it has left nothing uncommitted. -- The user, in a terminal, lists and reclaims the checkouts under a project without opening the dashboard. +- The user, in a terminal, lists and reclaims the checkouts under a project without any other tool. ## Glossary diff --git a/packages/skill-branches/src/reclaim.SPEC.md b/packages/skill-branches/src/reclaim.SPEC.md index ef4a6021..6ad7a739 100644 --- a/packages/skill-branches/src/reclaim.SPEC.md +++ b/packages/skill-branches/src/reclaim.SPEC.md @@ -1,4 +1,4 @@ -Reclaiming an agent's checkout: the one implementation behind every surface that removes one — a daemon's sweep and teardown, a dashboard's Remove button, an agent's own command line — so a second surface is never a second behaviour. +Reclaiming an agent's checkout: the one implementation behind every surface that removes one — a daemon's sweep and teardown, a dashboard's remove action, an agent's own command line — so a second surface is never a second behaviour. ## User story