diff --git a/CHANGELOG.md b/CHANGELOG.md index 842960d..a4dffaf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,8 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## [Unreleased] +## [3.27.8] - 2026-02-19 + ### Added +- **New GitHub Actions workflow**: `examples/github-actions/claude-code-review.yml` β€” prompt-based code review pattern + - Uses `anthropics/claude-code-action@v1` with OAuth token support (API key as fallback) + - Triggers on PR open/sync/ready + `/claude-review` on-demand comment + - Scoped `allowed_tools`: read-only (Read, Glob, Grep + GitHub PR inspection/review tools) + - Externalized prompt via `prompt_file:` β€” iterate on criteria without touching workflow YAML +- **New prompt template**: `examples/github-actions/prompts/code-review.md` + - Anti-hallucination protocol: verify before reporting, no invented line numbers + - Structured severity tiers: πŸ”΄ MUST FIX / 🟑 SHOULD FIX / 🟒 CAN SKIP + - 4-step workflow: gather context β†’ analyze β†’ verify β†’ structured review output + - Stack-agnostic with explicit "Stack Context" customization hook + - **Resource evaluation**: SKILLMIND/Boris Cherny workflow practices (score 2/5) - LinkedIn post by @stasbel (64K followers) sharing SKILL.md file attributed to Boris Cherny (Claude Code creator) - 6 workflow orchestration practices + 6 task management items + 3 core principles @@ -31,6 +44,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ### Changed +- `examples/github-actions/README.md`: added entry for prompt-based workflow (⭐ Recommended), updated directory tree - `guide/ultimate-guide.md`: Added `tasks/lessons.md` variant to Fresh Context Pattern (Ralph Loop) section - Lightweight alternative for interactive sessions: Claude updates lessons.md with behavioral rules after each user correction - Reviewed at session start for compounding improvement effect diff --git a/README.md b/README.md index 2157d7c..c883611 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,9 @@

Stars - Last Update + Last Update Quiz - Templates + Templates Threat Database

@@ -50,7 +50,7 @@ Both guides serve different needs. Choose based on your priority. | **Security hardening** | Only threat database (18 CVEs) | Basic patterns only | | **Test understanding** | 274-question quiz | Not available | | **Methodologies** (TDD/SDD/BDD) | Full workflow guides | Not covered | -| **Copy-paste ready** templates | 116 templates | 200+ templates | +| **Copy-paste ready** templates | 161 templates | 200+ templates | ### Ecosystem Positioning @@ -136,7 +136,7 @@ graph LR root[πŸ“¦ Repository
Root] root --> guide[πŸ“– guide/
19K lines] - root --> examples[πŸ“‹ examples/
116 templates] + root --> examples[πŸ“‹ examples/
161 templates] root --> quiz[🧠 quiz/
274 questions] root --> tools[πŸ”§ tools/
utils] root --> machine[πŸ€– machine-readable/
AI index] @@ -166,7 +166,7 @@ graph LR β”‚ β”œβ”€ mcp-servers-ecosystem.md Official & community MCP servers β”‚ └─ workflows/ Step-by-step guides β”‚ -β”œβ”€ πŸ“‹ examples/ 116 Production Templates +β”œβ”€ πŸ“‹ examples/ 161 Production Templates β”‚ β”œβ”€ agents/ 6 custom AI personas β”‚ β”œβ”€ commands/ 26 slash commands β”‚ β”œβ”€ hooks/ 31 hooks (bash + PowerShell) @@ -268,7 +268,7 @@ Complete guides with rationale and examples: --- -### πŸ“š 116 Annotated Templates +### πŸ“š 161 Annotated Templates **Outcome**: Learn patterns, not just configs. @@ -657,7 +657,7 @@ Use this guide critically. Experiment. Share what works for you. | **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min |
-Examples Library (116 templates) +Examples Library (161 templates) **Agents** (6): [code-reviewer](./examples/agents/code-reviewer.md), [test-writer](./examples/agents/test-writer.md), [security-auditor](./examples/agents/security-auditor.md), [refactoring-specialist](./examples/agents/refactoring-specialist.md), [output-evaluator](./examples/agents/output-evaluator.md), [devops-sre](./examples/agents/devops-sre.md) ⭐ @@ -775,7 +775,7 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines. --- -*Version 3.27.6 | Updated daily Β· Feb 18, 2026 | Crafted with Claude* +*Version 3.27.8 | Updated daily Β· Feb 19, 2026 | Crafted with Claude* + +## Anti-Hallucination Protocol + +**MANDATORY β€” read before every action:** + +1. **Verify before reporting.** Use `Grep` or `Read` to confirm any issue exists in the actual file before mentioning it. +2. **Never invent line numbers.** Only reference lines you have read directly from the file. +3. **Never assume context.** If a file is not in the diff, do not comment on it. +4. **One claim = one verification.** Each finding must be traceable to a tool call result. + +If you cannot verify a finding β†’ do not report it. + +--- + +## Your Mission + +You are a senior engineer performing a structured code review on this pull request. + +Your goal: surface real issues, ranked by impact, with actionable fixes. Not a style lecture β€” a review that unblocks merge decisions. + +--- + +## Step 1 β€” Gather Context + +Before reviewing, run these tool calls in parallel: + +- `mcp__github__get_pull_request` β†’ PR title, description, author +- `mcp__github__get_pull_request_diff` β†’ full diff +- `mcp__github__list_pull_request_files` β†’ list of changed files + +For any file that looks non-trivial, use `Read` to see the full implementation context around the changed lines. + +--- + +## Step 2 β€” Analyze Changes + +Review each changed file through these lenses: + +### πŸ”΄ MUST FIX β€” blocks merge + +- **Security**: injection (SQL, command, XSS), unvalidated input at system boundaries, exposed secrets, insecure direct object references, missing auth checks +- **Correctness**: logic errors, off-by-one, null/undefined dereferences, incorrect assumptions about data shape +- **Data integrity**: missing transactions, partial writes, lost updates under concurrency +- **Breaking changes**: API incompatibility, removed fields, changed behavior without migration + +### 🟑 SHOULD FIX β€” fix before next release + +- **Performance**: N+1 queries, unbounded loops on large datasets, synchronous I/O in hot paths, missing indexes on queried columns +- **Error handling**: unhandled promise rejections, swallowed exceptions, missing error boundaries +- **Architecture**: business logic leaking into presentation layer, tight coupling between unrelated modules, violation of existing patterns in the codebase + +### 🟒 CAN SKIP β€” optional improvement + +- Code readability: long functions, unclear naming, missing doc comments on public APIs +- Test coverage: missing edge case tests, weak assertions +- Minor DRY violations + +--- + +## Step 3 β€” Verify Each Finding + +For every issue you plan to report: + +``` +1. Use Read or Grep to confirm the problematic code is in the diff +2. Note the exact file path and line number +3. Only then include it in the review +``` + +If verification fails β†’ discard the finding. + +--- + +## Step 4 β€” Write the Review + +### Summary Comment (post as PR comment) + +``` +## Claude Code Review + +**Verdict**: [βœ… Approve | πŸ”„ Request Changes | πŸ’¬ Comment] +**Risk**: [Low | Medium | High] + +### πŸ”΄ Must Fix ({n}) +| File | Line | Issue | Fix | +|------|------|-------|-----| +| `path/to/file.ts` | 42 | SQL query concatenates user input | Use parameterized query | + +### 🟑 Should Fix ({n}) +| File | Line | Issue | Fix | +|------|------|-------|-----| +| `path/to/file.ts` | 87 | Missing error handling on async call | Wrap in try/catch | + +### 🟒 Can Skip ({n}) +- `path/to/file.ts:12` β€” Consider extracting this into a helper for reuse + +### Strengths +- [What was done well β€” be specific] +``` + +### Inline Comments (via `add_comment_to_pending_review`) + +For πŸ”΄ and 🟑 findings, add inline comments directly on the relevant lines with: +- What is wrong and why it matters +- A concrete fix (code snippet when helpful) + +Use `create_pending_pull_request_review` first, then add comments, then `submit_pending_pull_request_review`. + +--- + +## Constraints + +- **No nitpicking** β€” if it does not affect correctness, security, or team velocity, skip it +- **No praise theater** β€” only mention strengths that are genuinely notable +- **No invented issues** β€” verify β†’ report, not report β†’ verify +- If the PR is clean: say so clearly and approve diff --git a/guide/cheatsheet.md b/guide/cheatsheet.md index 7d98121..a0001f4 100644 --- a/guide/cheatsheet.md +++ b/guide/cheatsheet.md @@ -12,7 +12,7 @@ tags: [cheatsheet, reference] **Written with**: Claude (Anthropic) -**Version**: 3.27.6 | **Last Updated**: February 2026 +**Version**: 3.27.8 | **Last Updated**: February 2026 --- @@ -545,4 +545,4 @@ where.exe claude; claude doctor; claude mcp list **Author**: Florian BRUNIAUX | [@MΓ©thode Aristote](https://methode-aristote.fr) | Written with Claude -*Last updated: February 2026 | Version 3.27.6* +*Last updated: February 2026 | Version 3.27.8* diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md index 395627d..8acdf8b 100644 --- a/guide/ultimate-guide.md +++ b/guide/ultimate-guide.md @@ -16,7 +16,7 @@ tags: [guide, reference, workflows, agents, hooks, mcp, security] **Last updated**: January 2026 -**Version**: 3.27.6 +**Version**: 3.27.8 --- @@ -4353,7 +4353,7 @@ The `.claude/` folder is your project's Claude Code directory for memory, settin | Personal preferences | `CLAUDE.md` | ❌ Gitignore | | Personal permissions | `settings.local.json` | ❌ Gitignore | -### 3.27.6 Version Control & Backup +### 3.27.8 Version Control & Backup **Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers. @@ -19678,4 +19678,4 @@ We'll evaluate and add it to this section if it meets quality criteria. **Contributions**: Issues and PRs welcome. -**Last updated**: January 2026 | **Version**: 3.27.6 +**Last updated**: January 2026 | **Version**: 3.27.8 diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml index 1f675dc..0c94ad6 100644 --- a/machine-readable/reference.yaml +++ b/machine-readable/reference.yaml @@ -3,7 +3,7 @@ # Source: guide/ultimate-guide.md # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code -version: "3.27.6" +version: "3.27.8" updated: "2026-02-17" # ════════════════════════════════════════════════════════════════ @@ -196,7 +196,7 @@ deep_dive: third_party_toad: "https://github.com/batrachianai/toad" third_party_conductor: "https://docs.conductor.build" # Configuration Management & Backup (Added 2026-02-02) - config_management_guide: "guide/ultimate-guide.md:4085" # Section 3.27.6 + config_management_guide: "guide/ultimate-guide.md:4085" # Section 3.27.8 config_hierarchy: "guide/ultimate-guide.md:4095" # Global β†’ Project β†’ Local precedence config_git_strategy_project: "guide/ultimate-guide.md:4110" # What to commit in .claude/ config_git_strategy_global: "guide/ultimate-guide.md:4133" # Version control ~/.claude/ @@ -1221,7 +1221,7 @@ ecosystem: - "Cross-links modified β†’ Update all 4 repos" history: - date: "2026-01-20" - event: "Code Landing sync v3.27.6, 66 templates, cross-links" + event: "Code Landing sync v3.27.8, 66 templates, cross-links" commit: "5b5ce62" - date: "2026-01-20" event: "Cowork Landing fix (paths, README, UI badges)" @@ -1233,7 +1233,7 @@ ecosystem: onboarding_matrix_meta: version: "2.0.0" last_updated: "2026-02-05" - aligned_with_guide: "3.27.6" + aligned_with_guide: "3.27.8" changelog: - version: "2.0.0" date: "2026-02-05" @@ -1261,7 +1261,7 @@ onboarding_matrix: core: [rules, sandbox_native_guide, commands] time_budget: "5 min" topics_max: 3 - note: "SECURITY FIRST - sandbox before commands (v3.27.6 critical fix)" + note: "SECURITY FIRST - sandbox before commands (v3.27.8 critical fix)" beginner_15min: core: [rules, sandbox_native_guide, workflow, essential_commands] @@ -1346,7 +1346,7 @@ onboarding_matrix: - default: agent_validation_checklist time_budget: "60 min" topics_max: 6 - note: "Dual-instance pattern for quality workflows (v3.27.6)" + note: "Dual-instance pattern for quality workflows (v3.27.8)" learn_security: intermediate_30min: @@ -1357,7 +1357,7 @@ onboarding_matrix: - default: permission_modes time_budget: "30 min" topics_max: 4 - note: "NEW goal (v3.27.6) - Security-focused learning path" + note: "NEW goal (v3.27.8) - Security-focused learning path" power_60min: core: [sandbox_native_guide, mcp_secrets_management, security_hardening] @@ -1382,7 +1382,7 @@ onboarding_matrix: core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode] time_budget: "60 min" topics_max: 6 - note: "Security foundation + core workflow (v3.27.6 sandbox added)" + note: "Security foundation + core workflow (v3.27.8 sandbox added)" intermediate_120min: core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]