docs(claude): install agent skills + slim CLAUDE.md#71
Merged
Conversation
Brings the three skills used to build this project under version control in .agents/skills/, with .claude/skills/<name> symlinks for Claude Code to discover. skills-lock.json pins each skill's source + content hash so they sync deterministically. - specops — spec-driven workflow + plans protocol (replaces the manual recap of these conventions that lives in .claude/CLAUDE.md; that trimming follows in the next commit) - backend-fastify — Fastify + TS patterns, plugin order, env validation - frontend-shadcn — Vite + React 19 + shadcn/ui + Tailwind v4 + React Router v7 patterns Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
CLAUDE.md was duplicating ~70% of what the specops skill (just installed) already covers — the spec-driven philosophy and the plans-protocol ritual. With the skill present, that duplication will rot and confuse. Trims that content out and replaces it with a short "Skills available in this repo" inventory pointing at the three skills now installed. Also: - Fix stale claims: importer "not yet implemented" (it's been built and rewritten via gitsheets transact; merged); `codeforphilly-data-snapshot` (no longer the model — single repo `codeforphilly-data` with branches empty/fixture/legacy-import/published) - Add "Three repos in this project" diagram so a fresh contributor can map this repo to `codeforphilly-data` and `cfp-sandbox-cluster` - Add "Runtime data flow" callout for the push daemon + reconciler + hot-reload webhook — significant runtime architecture that wasn't surfaced anywhere a new agent would find it - Add "Working laterally on the data repo" callout reminding agents to read the data repo's own `.claude/CLAUDE.md` + the gitsheets skill it ships when reaching across - Add "Local setup" walkthrough — `.env.example`, clone data repo as sibling, where `CFP_DATA_REPO_PATH` should point - Add "CI" subsection explaining the `@cfp/shared` pre-emptive build (a gotcha that bit us before) - Document the merge convention (rebase locally + `gh pr merge --merge`, never `--rebase` or `--squash`) - Document the Co-Authored-By trailer - Rephrase "Per the user's global rules" → "Project conventions" Net: 153 lines → 102 lines, none of which duplicate any installed skill. 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.
Two-commit PR.
1.
chore: install specops + backend-fastify + frontend-shadcn skillsBrings the three skills used to build this project under version control. Pinned via
skills-lock.json.2.
docs(claude): slim CLAUDE.md, defer spec/plan workflow to specops skillCLAUDE.md was duplicating ~70% of
specops's skill body. Trims that out and replaces it with a short skills-inventory, plus fills the gaps a fresh contributor would actually trip over:codeforphilly-data/cfp-sandbox-cluster).env.example, sibling clone of data repo)@cfp/sharedpre-emptive-build gotchagh pr merge --merge, never--rebaseor--squash)Also fixes stale claims: importer "not yet implemented" (it's built + merged),
codeforphilly-data-snapshotreference (the model moved to branches oncodeforphilly-data).Net: 153 lines → 102 lines, none duplicating any installed skill.
🤖 Generated with Claude Code