Skip to content

feat(templates): drop the worktree from the delivery rule and §9 - #26

Merged
protonspy merged 1 commit into
mainfrom
feat/no-worktree-in-delivery
Aug 19, 2026
Merged

feat(templates): drop the worktree from the delivery rule and §9#26
protonspy merged 1 commit into
mainfrom
feat/no-worktree-in-delivery

Conversation

@protonspy

Copy link
Copy Markdown
Owner

What changed

The worktree is gone from the development flow — the mention as well as the use.

  • internal/assets/templates/rules/delivery.md — the sentence offering the user a git worktree becomes "how a user runs several sessions against one repo at once is theirs to set up". Same discipline (branch in the checkout you are in, leave it back on main and clean), no mechanics named.
  • design/orchestration.md §9 — the **A git worktree is not part of this...** paragraph is rewritten as **Nothing here needs a second directory, and the procedure used to make one.**, keeping the cost that motivated the removal. In "What running several sessions still costs", Separate checkoutsSeparate sessions, and namespaces those per checkoutper session.
  • internal/assets/assets.go — template set 1718, required by the convention whenever a workspace template changes, with the changelog entry for it.

Why

Version 15 took the worktree out of the procedure and left the rule pointing at one anyway. That is the same cost in a smaller font: <harness>/rules/*.md is preloaded into every request on a harness that reads it, so a line describing a step nothing in the flow performs is paid continuously.

What deliberately stays

The record that the worktree was rejecteddesign/orchestration.md §5 (the removed worktree: frontmatter key), §8 (worktree-per-task in the rejected design), and changelog entry 15 in assets.go. Deleting the rationale is how the idea gets re-proposed. design/research.md §3.2 and design/plan-format-v2.md also keep theirs: community research and a risk note, not scc's flow.

Verified

gofmt -l, go vet ./..., and the full suite pass locally (make check equivalent — make is not on this machine).

🤖 Generated with Claude Code

https://claude.ai/code/session_01KA9xRzo3xpYLMZjrtRbcge

Version 15 took the worktree out of the procedure and left `delivery.md`
pointing at one anyway — a line preloaded into every request describing a
step nothing in the flow performs. How a user arranges several sessions
against one repo is theirs to set up, and saying that is enough; the rule
keeps only what the worktree was ever really carrying, which is to leave
the checkout back on `main` and clean.

design/orchestration.md §9 loses the same offer, and "separate checkouts"
becomes "separate sessions" where the cost of parallel runs is named.
The record that it was rejected stays in §5, §8, and changelog entry 15.

Template set 17 -> 18.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KA9xRzo3xpYLMZjrtRbcge
@protonspy
protonspy merged commit 6fbf6d8 into main Aug 19, 2026
4 checks passed
@protonspy
protonspy deleted the feat/no-worktree-in-delivery branch August 19, 2026 23:47
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.

1 participant