feat(aidd-vcs): feature-branch and optional worktree setup before implementation
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 55/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- git
- Domain
- developer-experience, documentation, tooling
Research direction
Start with plugins/aidd-dev/skills/00-sdlc/SKILL.md and plugins/aidd-vcs/skills/00-repo-init/ to understand the existing branch and repository setup guidance. Review .aidd/config.yml and the issue's branch.base, branch.pattern, and mode requirements. Done means branch-only is the default, worktree mode reports real isolation or fails explicitly, existing work is not clobbered, and SDLC docs name a branch-setup capability.
Written by the indexing model from the issue text.
Description
Problem
SDLC requires a non-default branch before shipping, but nothing creates that branch or optional isolation. Implementation often lands on the default branch or a shared dirty tree and collides with parallel work.
Scope
- Skill for branch setup (semantic name e.g.
worktree/branch-setup):- Modes from config/args:
branch-only(default) |worktree|failif requested mode unavailable. - Create feature branch from
branch.base+branch.pattern(.aidd/config.yml) or args. worktreemode only whengit worktreeis available; otherwise error or explicit fallback — never claim isolation that was not obtained.- Print path + branch for implement hand-off.
- Modes from config/args:
- v1 promise: implement on a non-default branch. Stronger “base tree unchanged” only when worktree mode succeeds.
- Optional pre-implement capability: SDLC docs use capability language only (no hardcoded plugin addresses — orthogonality).
Standalone value: Implement need not use the default branch if this skill runs first.
Acceptance criteria
- Default mode
branch-only: non-default branch created/checked out for work; no worktree required. - Mode
worktree: when available, second worktree on feature branch; original tree can remain on base. - Mode
worktreewhen unsupported: non-zero or explicit fallback — never claims isolation it did not get. - No clobber of existing branch/worktree without reuse flag.
- No commit/push unless opted in.
- SDLC docs reference a branch-setup capability, not a hardcoded plugin id.
Prior art in this repo
plugins/aidd-dev/skills/00-sdlc/SKILL.md(L31) — “Never auto-branch; the caller sets a non-default branch before shipping”plugins/aidd-vcs/skills/00-repo-init/— repo bootstrap, no feature worktree- #413 — commit-on-branch guidance in project memory / VCS templates
Relations
Intended graph (same fields as GitHub parent / blocked-by / blocks). Formal GraphQL edges need maintainer write — see comment on #584.
| Field | Value |
|---|---|
| parent | #584 |
| blocked-by | — |
| blocks | — |
| related | #585 |
| MVP | 1 |
Out of scope
- Remote concurrency scan (recheck child)
- Issue linking policy
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 14h 27m
- Merged PRs (30d)
- 111
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
blocklist removal
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
MetaMask/eth-phishing-detect#296544 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
pastelsky/bundlephobia#1122 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
category/development priority/P2 scope/file-operations scope/testing type/enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Enatega Customer and Rider app: Add-ons price is not visible to customer after order is placed. Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100