Merged
Conversation
Claude Code natively auto-discovers .claude/CLAUDE.md, so we drop the root-level pointer file and ship it under .claude/CLAUDE.md instead. The harness Claude template now writes a single root-level file, AGENTS.md (the cross-harness "constitution"), and keeps every other Claude-specific asset under .claude/. The .claude/CLAUDE.md content is unchanged — it still redirects readers to AGENTS.md. Migration is handled implicitly by the existing upgrade plan logic: the new bundle's destination is .claude/CLAUDE.md, so the old root CLAUDE.md becomes an orphan lock entry — auto-removed on upgrade if untouched, preserved if user-customized (the standard contract for managed files). Implementation is a single line change in templates/manifest.json plus a bundle regeneration; no application code changed. Refs: https://code.claude.com/docs/en/agent-sdk/modifying-system-prompts > Project-level: CLAUDE.md or .claude/CLAUDE.md in your working directory Closes #34 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 2, 2026
kevinkod
added a commit
that referenced
this pull request
May 2, 2026
Aligns the Specflow repo with the convention #34 / PR #35 just shipped to the Claude harness templates: the project pointer/working-contract file lives under .claude/ instead of at the project root, where Claude Code natively auto-discovers it. Pure rename — content is unchanged. Working contract directives are unaffected. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.
Summary
CLAUDE.mdat the project root and.claude/{commands,agents,skills}next to it, which left two top-level files (AGENTS.md+CLAUDE.md) where the second one is essentially a 7-line redirect..claude/CLAUDE.md, so we move the redirect under.claude/. The root keeps onlyAGENTS.md— the cross-harness "constitution" file.Migration
Handled implicitly by the existing upgrade-plan logic in
src/domain/upgrade_plan.ts:CLAUDE.mdbecomes an orphan lock entry → auto-removed if untouched, preserved if user-customized (standard managed-files contract)..claude/CLAUDE.mdis added asadd-new.Refs
Test plan
deno task test— 333 passed).specflow init --here --ai claudefrom working tree →.claude/CLAUDE.mdpresent, rootCLAUDE.mdabsent,AGENTS.mdintact, content unchanged.Closes #34
🤖 Generated with Claude Code