guide/diagrams/: new directory with 40 interactive Mermaid diagrams
- 10 thematic files: foundations, context/sessions, configuration,
architecture, MCP ecosystem, dev workflows, multi-agent patterns,
security/production, cost/optimization, adoption/learning
- Each diagram: Mermaid (GitHub-native) + ASCII fallback + source link
- Bold Guy palette (6-color system) consistent across all diagrams
- README with index, visual palette legend, navigation by use case
Also includes (backlog from v3.28.0→v3.28.1):
- guide/ultimate-guide.md: Managing Large MCP Server Sets, AI Code
Disclosure Policy, claude-mem Gemini alternative, observability
- guide/workflows/plan-driven.md: Boris Tane custom markdown plans (+172L)
- guide/security-hardening.md: Part 4 PR security review workflow
- examples/agents/security-patcher.md: new security agent
- examples/hooks/bash/security-gate.sh: PreToolUse security hook
- guide/observability.md: activity monitoring, external tools, proxying
- docs/resource-evaluations/: 4 new evaluations (Boris Cherny, Moigneu,
Boris Tane, Aristote AI instructions)
- README.md: Visual Diagrams section in "What Makes This Guide Unique"
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- architecture.md: fix Asana attribution (not Atlassian), Daniela Amodei
title (President not CEO), update model refs (3.5→4+), update footer
- cheatsheet.md: update date to Feb 2026, TodoWrite→Tasks API in decision tree
- methodologies.md: update date to Feb 2026
- sync-version.sh: escape dots in sed patterns to prevent URL corruption
Findings from 3-agent parallel code review (Agent Teams experiment).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Added comprehensive documentation for resource evaluation methodology:
- Appendix C in ultimate-guide.md (line 15034)
* 5-point scoring system with decision criteria
* 14 documented assessments by category
* Transparency on integration decisions
* Links to full methodology
- Fixed methodologies.md GSD evaluation link
* Corrected path: claudedocs → docs (public)
- Updated reference.yaml with resource evaluations metadata
* Directory, count (14), methodology references
* Appendix and README section line numbers
All resource-evaluations now properly documented and discoverable.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Add affaan-m/everything-claude-code to ecosystem (16k+ stars)
- Note: author hackathon win was for Zenith project, not this repo
- Caveat: Node.js hooks not officially recommended by Anthropic
- Document "Verification Loops" pattern in methodologies.md
- Official Anthropic guidance: iterate until tests pass
- Document "Eval Harness" concept with source link
- Reference: anthropic.com/engineering/demystifying-evals-for-ai-agents
- Add deep_dive index entries for quick lookup
Co-Authored-By: Claude <noreply@anthropic.com>
- Update CLAUDE.md with current values
- Update README.md badges and line counts
- Add Fresh Context Pattern reference in methodologies.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add CITATION.cff for academic citations and GitHub citation button
- Add "For AI Assistants" section in README with llms.txt reference
- Update machine-readable/llms.txt stats (4700+ → 9600+ lines)
- Bump version display to 3.8.0 in README footer
Improves discoverability in GitHub search, Google Scholar, and AI assistants
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add new section based on Addy Osmani's analysis of 2,500+ agent configs:
- Six essential components for specs (commands, testing, structure, style, git, boundaries)
- Permission tiers system (Always/Ask/Never)
- Curse of Instructions warning (more rules = worse adherence)
- Monolithic vs Modular decision table
Source: https://addyosmani.com/blog/good-spec/
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add guide/methodologies.md: index of 15 methodologies with decision tree
- Add guide/workflows/: 4 practical workflow guides
- tdd-with-claude.md: TDD with Claude-specific patterns
- spec-first.md: SDD adapted for CLAUDE.md
- plan-driven.md: effective /plan mode usage
- iterative-refinement.md: prompt→feedback→reprompt loops
- Add Section 9.14 in ultimate-guide.md linking to workflows
- Update guide/README.md with new documentation
- Bump version 3.4.0 → 3.5.0 across all files
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
