Repository navigation
fix(template): ship the AI guides AGENTS.md points to, with an opt-out - #1432
Merged
Merged
Conversation
A project created with `fsh new` / `dotnet new fsh` included AGENTS.md but not CLAUDE.md, GEMINI.md or .agents/, so the guide pointed at files that did not exist (#1428). They now ship together by default; `--agents false` (template) / `--no-agents` (CLI) leaves out all four. AGENTS.md sections that only apply to this repo (branching/CI gates, the docs-repo rule, the CLI location) are wrapped in `<!--#if (includeTools) -->` via a new Markdown conditional operation, so scaffolded projects get a guide without them. Also stop shipping superpowers/ (internal specs and audits) and a worktree-style `.git` file. Closes #1428 Co-Authored-By: Claude Opus 5.5 (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.
Closes #1428.
Problem
fsh new/dotnet new fshexcluded.agents/**,CLAUDE.mdandGEMINI.mdbut keptAGENTS.md, so every scaffolded project shipped a guide pointing at files that didn't exist (andCONTRIBUTING.mdlinked a missingCLAUDE.md). The exclusions dated from April, beforeAGENTS.mdbecame the canonical guide.Fix
agentsbool symbol (defaulttrue)..agents/**,CLAUDE.mdandGEMINI.mdleave the unconditional exclude list; an(!agents)modifier drops all four files together, like(!aspire)/(!frontend).fsh new --no-agentspasses--agents false; the summary shows an "AI guides" line.AGENTS.mdhad sections that are wrong in a user's project (branching and CI gates, the "update the fullstackhero docs repo" golden rule, thesrc/Tools/CLIrow, which is excluded). They are wrapped in<!--#if (includeTools) -->…<!--#endif -->, which are invisible HTML comments on GitHub. A newSpecialCustomOperationsentry for**/*.mdmakes the template engine process them, so scaffolded projects get a clean guide.includeToolsis the existing "FSH repo only" flag.superpowers/(internal specs, plans and audits, ~260 KB) and a worktree-style.gitfile.Verified
Installed the template into an isolated hive (
--debug:custom-hive) and scaffoldedAcme.Shopboth ways:.agents/(rules, skills, workflows),AGENTS.md,CLAUDE.md,GEMINI.mdpresent;CLAUDE.mdstill imports@AGENTS.md; names replaced (Acme.Shop.Api, …); noBranching, docs-repo rule,src/Toolsor<!--#markers left inAGENTS.md; nosuperpowers/.--agents false: none of the four.CI's scaffold jobs cover the build of both variants.
🤖 Generated with Claude Code