Skip to content

Guide agents toward one branch, one worktree per issue - #163

Merged
androidand merged 1 commit into
mainfrom
feat/162-guide-agents-on-branch-per-issue
Sep 10, 2026
Merged

androidand merged 1 commit into
mainfrom
feat/162-guide-agents-on-branch-per-issue

Conversation

@androidand

Copy link
Copy Markdown
Owner
  • `specsync agent-help` (overview, text + `-json`) now states the one-issue/one-branch/one-worktree convention directly, and softens the AGENTS.md pointer to "if the project has one" — previously the only guidance was "read AGENTS.md," which is silently false for any project other than this repo (AGENTS.md and `skills/specsync/docs/*.md` never ship past this repo).
  • `specsync agent-help pull` documents the existing `-worktree`/`-worktree-dir` flags (previously undocumented anywhere reachable) and adds a matching safety rule.
  • The skill (`SKILL.md`, `docs/reference.md`, `docs/workflow.md`) mentions the same convention and the flag, including the honest caveat that spec-first has no equivalent automation yet.

No new command or flag — `pull -worktree` already existed and did the right thing; this only makes it discoverable.

Closes #162

specsync agent-help (the one thing reachable from any consuming
project, since it ships with the binary) previously just said "read
AGENTS.md" for workflow guidance -- silently false for any project
other than this repo, since AGENTS.md and skills/specsync/docs/*.md
never leave here. Neither documented the existing pull -worktree flag.

Now: agent-help overview and agent-help pull state the branch/worktree-
per-issue convention directly; the skill mentions the same, honestly
noting spec-first has no equivalent automation yet.

Closes #162
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying specsync with  Cloudflare Pages  Cloudflare Pages

Latest commit: 44efacf
Status: ✅  Deploy successful!
Preview URL: https://14a39649.specsync.pages.dev
Branch Preview URL: https://feat-162-guide-agents-on-bra.specsync.pages.dev

View logs

@androidand
androidand merged commit c4a6470 into main Sep 10, 2026
2 checks passed
@androidand
androidand deleted the feat/162-guide-agents-on-branch-per-issue branch September 10, 2026 10:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Guide agents toward one branch, one worktree per issue

1 participant