Retire the git-context and os:worktree names after os-git owns them #1631

Closed
opened 2026-11-07 07:08:33 +00:00 by jared · 2 comments
Owner

Problem

The names git-context and os:worktree still exist after the os-git build (#1610). #1607 AC 5 asks for their removal. The removal cannot run yet: os-git has no commit or repo-init agent, plugins/os-git/bin is not confirmed on PATH, and ruby-gems/git-context has its own remote and three uncommitted files. Each old name now only delegates to os-git, so two names exist for one job.

Reproduce

n/a: this is a removal ticket.

Approach

Move the commit and repo-init agents from cc-plugins/git-context/agents/ into plugins/os-git/agents/. Confirm that plugins/os-git/bin reaches PATH in a new session. Live sessions call worktree from plugins/os/bin, so the worktree command must stay reachable. Then remove plugins/os/skills/worktree/, plugins/os/bin/worktree, and the /os:worktree text in the 12 files that name it. The owner of the three uncommitted files in ruby-gems/git-context must commit or drop them before that repository is retired.

Required work: none beyond the acceptance criteria.

Orchestrator work: remove cc-plugins/git-context and its entry in ~/.claude/settings.json; retire ruby-gems/git-context in that repository.

Acceptance criteria

  1. Given a new session, when os-git and worktree run with no absolute path, then both resolve to plugins/os-git/bin.
  2. Given a new session, when the agent list loads, then os-git:commit and os-git:repo-init are present and git-context:commit is absent.
  3. Given plugins/ and docs/, when they are searched for os:worktree, then only history records and ADRs name it.

Origin

  • Trigger: #1607 ruling 1 in docs/crc/os-sdlc/fast-batch-os-git-final/rulings.tsv
  • Improvised this session: agents and skills call ~/.claude/plugins/os-git/bin/os-git by absolute path
  • Chain: old names remain ← #1607 ruling 1 ← os-git has no agents and its bin is not confirmed on PATH (DESIGN: docs/os-git/use-cases-and-domain.md section 1)
  • Root candidate: none found; searched git-context, os:worktree, retire, os-git, commit/repo-init agents (nearest: #1591, #1607 parent, #1630, none the same fault)
  • Where: cc-plugins/git-context, plugins/os/bin/worktree, plugins/os/skills/worktree
  • Session: 5b14a4ef-91b2-45c0-a729-baa17682a39a
  • Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os--claude-worktrees-ticket-1591/5b14a4ef-91b2-45c0-a729-baa17682a39a.jsonl

VERDICT: CREATE

## Problem The names `git-context` and `os:worktree` still exist after the os-git build (#1610). #1607 AC 5 asks for their removal. The removal cannot run yet: os-git has no commit or repo-init agent, `plugins/os-git/bin` is not confirmed on PATH, and `ruby-gems/git-context` has its own remote and three uncommitted files. Each old name now only delegates to os-git, so two names exist for one job. ## Reproduce n/a: this is a removal ticket. ## Approach Move the `commit` and `repo-init` agents from `cc-plugins/git-context/agents/` into `plugins/os-git/agents/`. Confirm that `plugins/os-git/bin` reaches PATH in a new session. Live sessions call `worktree` from `plugins/os/bin`, so the `worktree` command must stay reachable. Then remove `plugins/os/skills/worktree/`, `plugins/os/bin/worktree`, and the `/os:worktree` text in the 12 files that name it. The owner of the three uncommitted files in `ruby-gems/git-context` must commit or drop them before that repository is retired. Required work: none beyond the acceptance criteria. Orchestrator work: remove `cc-plugins/git-context` and its entry in `~/.claude/settings.json`; retire `ruby-gems/git-context` in that repository. ## Acceptance criteria 1. Given a new session, when `os-git` and `worktree` run with no absolute path, then both resolve to `plugins/os-git/bin`. 2. Given a new session, when the agent list loads, then `os-git:commit` and `os-git:repo-init` are present and `git-context:commit` is absent. 3. Given `plugins/` and `docs/`, when they are searched for `os:worktree`, then only history records and ADRs name it. ## Origin - Trigger: #1607 ruling 1 in `docs/crc/os-sdlc/fast-batch-os-git-final/rulings.tsv` - Improvised this session: agents and skills call `~/.claude/plugins/os-git/bin/os-git` by absolute path - Chain: old names remain ← #1607 ruling 1 ← os-git has no agents and its bin is not confirmed on PATH (DESIGN: docs/os-git/use-cases-and-domain.md section 1) - Root candidate: none found; searched git-context, os:worktree, retire, os-git, commit/repo-init agents (nearest: #1591, #1607 parent, #1630, none the same fault) - Where: cc-plugins/git-context, plugins/os/bin/worktree, plugins/os/skills/worktree - Session: 5b14a4ef-91b2-45c0-a729-baa17682a39a - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os--claude-worktrees-ticket-1591/5b14a4ef-91b2-45c0-a729-baa17682a39a.jsonl VERDICT: CREATE
Author
Owner

cc-os side done, main 1177851e3 (feb6aa95f, 0a52ae9cb, b3fa3829a), ADR-0311 bee1c0e97.

  • AC1 met: which -a worktree gives only ~/.claude/plugins/os-git/bin/worktree; os-git resolves to plugins/os-git/bin. Skill and reference text calls os-git by name.
  • AC2, cc-os half: the refreshed cache has agents os-git:committer and os-git:repo-initializer, and skills /os-git:commit, /os-git:repo-init, and /os-git:worktree. The agents use role-noun names under cc-os-naming.md, not the os-git:commit name in AC2 (a predicted ruling: conventions first). git-context:commit is still present until cc-plugins removes it.
  • AC3 met: outside ADRs and dated records, os:worktree remains only in a History row and in the design record's source citations.
  • plugins/os/bin/worktree and plugins/os/skills/worktree are deleted. OsGit::Worktree::Command tests moved to plugins/os-git/test (os-git 407 runs, os 192 runs, 0 failures; rubocop 0 offenses on the moved files).

Waiting on github jaredswanson/cc-plugins#94 (remove git-context and its settings.json entry; retire ruby-gems/git-context after its owner commits or drops 3 uncommitted changes). Close this ticket when #94 ships and a new session shows no git-context:* agents.

cc-os side done, main 1177851e3 (feb6aa95f, 0a52ae9cb, b3fa3829a), ADR-0311 bee1c0e97. - AC1 met: `which -a worktree` gives only `~/.claude/plugins/os-git/bin/worktree`; `os-git` resolves to `plugins/os-git/bin`. Skill and reference text calls `os-git` by name. - AC2, cc-os half: the refreshed cache has agents `os-git:committer` and `os-git:repo-initializer`, and skills `/os-git:commit`, `/os-git:repo-init`, and `/os-git:worktree`. The agents use role-noun names under cc-os-naming.md, not the `os-git:commit` name in AC2 (a predicted ruling: conventions first). `git-context:commit` is still present until cc-plugins removes it. - AC3 met: outside ADRs and dated records, `os:worktree` remains only in a History row and in the design record's source citations. - `plugins/os/bin/worktree` and `plugins/os/skills/worktree` are deleted. `OsGit::Worktree::Command` tests moved to `plugins/os-git/test` (os-git 407 runs, os 192 runs, 0 failures; rubocop 0 offenses on the moved files). Waiting on github jaredswanson/cc-plugins#94 (remove git-context and its settings.json entry; retire ruby-gems/git-context after its owner commits or drops 3 uncommitted changes). Close this ticket when #94 ships and a new session shows no `git-context:*` agents.
Author
Owner

Resolution

Done: cc-os side (main 1177851e3, ADR-0311) plus cc-plugins e0d9700: git-context removed from cc-plugins and uninstalled; os-git owns /os-git:worktree, /os-git:commit, /os-git:repo-init and agents os-git:committer, os-git:repo-initializer; plugins/os worktree skill and bin deleted.

Evidence: AC1: which -a worktree gives only plugins/os-git/bin/worktree. AC2: git-context@cc-plugins absent from settings.json and installed_plugins.json; refreshed os-git cache holds agents/committer.md and agents/repo-initializer.md (a new session lists them). AC3: os:worktree remains only in ADRs, dated records, one History row, and the design record. No skill, agent, or plugin calls git-context.

Follow-ups: ~/dev/ruby-gems/git-context retirement waits on Jared (3 uncommitted changes); no ticket, recorded on cc-plugins#94.

## Resolution **Done:** cc-os side (main 1177851e3, ADR-0311) plus cc-plugins e0d9700: git-context removed from cc-plugins and uninstalled; os-git owns /os-git:worktree, /os-git:commit, /os-git:repo-init and agents os-git:committer, os-git:repo-initializer; plugins/os worktree skill and bin deleted. **Evidence:** AC1: which -a worktree gives only plugins/os-git/bin/worktree. AC2: git-context@cc-plugins absent from settings.json and installed_plugins.json; refreshed os-git cache holds agents/committer.md and agents/repo-initializer.md (a new session lists them). AC3: os:worktree remains only in ADRs, dated records, one History row, and the design record. No skill, agent, or plugin calls git-context. **Follow-ups:** ~/dev/ruby-gems/git-context retirement waits on Jared (3 uncommitted changes); no ticket, recorded on cc-plugins#94. <!-- os-backlog kind: resolution -->
jared closed this issue 2026-11-09 18:15:24 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jared/cc-os#1631
No description provided.