Add .claude/rules snippet, global packages, and rules/skills references#7
Merged
Conversation
Snippets & config: - global-packages.md: add git-trim, npm-check-updates, json-server, http-server (flagged — python3 -m http.server covers basic serving), and mcp-remote; regroup the install block. - config/claude-code/settings.json: harden with branch-guard-aligned denies (git clean, --no-verify commits/pushes, direct push to main), ask on `gh pr create`, allow WebSearch + git pull, and a worktrees additionalDirectories placeholder. - config/claude-code/rules/: new .claude/rules/*.md drop-in set distilled and generalized from a real project — security (prompt-injection, kept verbatim), coding-standards, frontend, testing, workflow (veloce-trace specifics scrubbed) + README. - templates/docs: graft the §4 "Agent pickup notes" zone into the project-log rule and template (also fixes the "four zones / lists three" mismatch). References: - references.md: add a Bryan Finster "Agentic delivery" section (agentic-dev-team, ai-patterns) and 5 vetted rules/skills resources (anthropics/skills, awesome-claude-code, awesome-claude-md, two a11y). - mermaid.md: placeholder for Mermaid notes, seeded with the open dark/light theming problem. Maps (README.md, docs/INDEX.md, config/claude-code/README.md) updated for all of the above. markdownlint clean. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SKEr4FwR8c3qz2WRDqgLHu
Dogfood the security-settings snippet: un-ignore just .claude/settings.json (.gitignore: .claude/* + !.claude/settings.json) so a safe baseline governs any session working in this repo — mine included. settings.local.json and .claude/worktrees/ stay personal/ignored; machine-specific paths (e.g. the worktree base for additionalDirectories) belong in the local file. The committed config mirrors config/claude-code/settings.json's deny/ask baseline (secret reads, destructive shell, branch-guard denies: --no-verify and direct push-to-main), with the allow list tailored to what this repo actually uses (git, markdownlint-cli2, shellcheck) rather than the template's Next-stack allows. additionalDirectories left empty. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SKEr4FwR8c3qz2WRDqgLHu
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.
Batch of additions to the library, on the docs/tooling theme.
Snippets & config
docs/global-packages.md— addgit-trim,npm-check-updates(ncu),json-server,http-server,mcp-remote.http-serveris flagged:python3 -m http.servercovers basic static serving, so it's included only for the Node-native / CORS / SPA-proxy / HTTPS cases.config/claude-code/settings.json— hardened with branch-guard-aligned denies (git clean,--no-verifycommits/pushes, directgit push origin main),askongh pr create,allowforWebSearch+git pull, and a worktreesadditionalDirectoriesplaceholder.config/claude-code/rules/(new) — drop-in.claude/rules/*.mdset distilled and generalized from a real project:security.md(prompt-injection, kept verbatim),coding-standards.md,frontend.md,testing.md,workflow.md— all veloce-trace specifics scrubbed — plus a README. Theproject-logrule was not duplicated (it already lives generalized undertemplates/docs/claude-rules/).templates/docs— grafted the §4 "Agent pickup notes" zone into the project-log rule and template (also fixes a latent "four zones / lists three" mismatch).This repo's own config
.claude/settings.json(new, committed) — dogfood the security-settings snippet: a safe baseline now governs any session working in this repo..gitignoreadjusted to.claude/*+!.claude/settings.json, sosettings.local.jsonand.claude/worktrees/stay personal/ignored. Allow list tailored to what this repo uses (git,markdownlint-cli2,shellcheck).Docs restructure
README.mdand removeddocs/INDEX.md. The routing tables (scripts/config/templates + docs list) now live up front in the README, so the map is the first thing a reader or AI assistant sees. This also removes the old dual-maintenance (a snippet used to need both a README tree entry and an INDEX row — now it's one table row).CLAUDE.mdrepointed accordingly.References
docs/references.md— new Agentic delivery (Bryan Finster) section (agentic-dev-team,ai-patterns), plus 5 vetted rules/skills resources (anthropics/skills,awesome-claude-code,awesome-claude-md, and two accessibility-focused ones).docs/mermaid.md(new) — placeholder for Mermaid notes, seeded with the open dark/light theming problem.README.md,config/claude-code/README.md, andCLAUDE.mdupdated throughout. All internal links resolve;markdownlintclean.🤖 Generated with Claude Code