chore: complete workflow V2 migration and stop tracking .claude/#14
Merged
chore: complete workflow V2 migration and stop tracking .claude/#14
Conversation
Add .claude/ to .gitignore and remove tracked files from index. These are local IDE/agent configuration files that shouldn't be versioned.
Remove remaining V1 workflow files replaced by the V2 system: - guide/dev/task-workflow.md → .agent/workflows/session-workflow.md - guide/dev/git-workflow.md → .agent/workflows/git-workflow.md - scripts/branch-context.sh → .agent/scripts/branch_context.py Update root CLAUDE.md with V2 session protocol dispatcher pointing to .agent/CLAUDE.md as the authoritative reference.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The project had accumulated two parallel systems: legacy V1 workflow docs in
guide/dev/and shell scripts inscripts/, alongside the new V2 agent system in.agent/. This left the agent harness pointing to stale locations and created confusion about the authoritative source of truth. The.claude/directory was also being tracked in git, which should be local-only IDE/agent config.Approach
Two focused changes:
Stop tracking
.claude/— added to.gitignoreand removed from the git index. These are local configuration files (skills, memory, settings) that are environment-specific and shouldn't be versioned. This is a one-way door: once untracked, they stay local.Remove V1 artifacts — deleted
guide/dev/task-workflow.md,guide/dev/git-workflow.md, andscripts/branch-context.sh, all of which had direct V2 replacements already in place (adr_kit/agent/workflows/and.agent/scripts/branch_context.py). Updated the rootCLAUDE.mdsession protocol to be a thin dispatcher that points to.agent/CLAUDE.mdas the single authoritative reference, removing the duplicated quick-summary content that was drifting out of sync.No runtime code was modified — this is purely a developer tooling and documentation cleanup.
What Was Tested
make qualitypassed (ruff, mypy, black — no issues, 313 tests passing).claude/no longer appears ingit statusafter removal.agent/paths after V1 deletionRisks
Additive/removal changes only — no production code modified. The only risk is if a developer had a workflow memorized that relied on the V1 file paths; they would need to update to
.agent/CLAUDE.md. The rootCLAUDE.mdnow explicitly redirects there, mitigating this.