claude-code-ultimate-guide/guide
Florian BRUNIAUX b48d95c024 feat: add agent/skill quality audit tooling + Grenier evaluation
AUDIT TOOLING (3 templates):
- Command: /audit-agents-skills (quick project audits)
  - 16-criteria framework (Identity 3x, Prompt 2x, Validation 1x, Design 2x)
  - Weighted scoring: 32 pts (agents/skills), 20 pts (commands)
  - Production grading (A-F, 80% threshold)
  - Fix mode with actionable suggestions
- Skill: audit-agents-skills (advanced audits)
  - 3 modes: Quick (top-5), Full (all 16), Comparative (vs templates)
  - JSON + Markdown output for CI/CD
- Scoring grids: criteria.yaml (externalized for reuse)

EVALUATION:
- Grenier agent/skill quality (3/5 - Moderate Value)
  - Gap: 29.5% deploy without evaluation (LangChang 2026)
  - Integration: Created audit command + skill + criteria
  - Industry context: 18% cite agent bugs as top challenge

DOCUMENTATION:
- Guide refs: 2 strategic call-outs (after Agent/Skill validation)
- CHANGELOG: New "Added" section + evaluation details
- README: Templates 106→107, Evaluations 49→24 (count corrections)
- reference.yaml: 10 new audit entries + updated counts

SYNC:
- Landing index.html: Templates 107, Evals 24, Quiz 257
- Landing examples/index.html: Templates 107

FILES: 14 changed, 4148 insertions (+1250 lines new audit content)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-07 15:40:18 +01:00
..
images docs: update template count badge (82 → 83) 2026-01-25 13:30:40 +01:00
workflows feat: add agent/skill quality audit tooling + Grenier evaluation 2026-02-07 15:40:18 +01:00
adoption-approaches.md docs: add Context Engineering (Thoughtworks) + corporate marketplaces footnotes 2026-02-06 16:09:02 +01:00
ai-ecosystem.md feat: adaptive onboarding architecture v2.0.0 (v3.23.0) 2026-02-05 22:19:58 +01:00
ai-traceability.md docs: add AI Traceability & Attribution guide 2026-01-24 20:11:53 +01:00
architecture.md docs: add Native Sandboxing comprehensive documentation (v3.21.1) 2026-02-02 20:24:17 +01:00
cheatsheet.md docs: add comprehensive /insights documentation + eval Kajan Siva post 2026-02-06 15:21:19 +01:00
claude-code-releases.md docs: update Claude Code releases to v2.1.33 + guide v3.23.1 2026-02-06 11:07:52 +01:00
cowork.md chore: remove cowork folder after migration to dedicated repo 2026-01-20 12:16:32 +01:00
data-privacy.md docs: add Anthropic governance resources 2026-01-26 09:31:19 +01:00
devops-sre.md feat: add DevOps & SRE Guide with FIRE Framework (v3.9.9) 2026-01-20 22:09:31 +01:00
known-issues.md docs: add verified critical bugs tracker (known-issues.md) 2026-01-28 17:59:16 +01:00
learning-with-ai.md release: v3.20.1 - Vercel AGENTS.md vs Skills evaluation 2026-01-30 21:45:14 +01:00
mcp-servers-ecosystem.md docs: add Git MCP Server (Official) comprehensive documentation 2026-02-03 17:20:12 +01:00
methodologies.md docs: add Context Engineering (Thoughtworks) + corporate marketplaces footnotes 2026-02-06 16:09:02 +01:00
observability.md docs: add third-party-tools.md links to guide index and observability 2026-02-01 22:59:36 +01:00
production-safety.md docs: add Alan Tour Eiffel paradigm evaluation (5/5 CRITICAL) 2026-02-02 14:21:51 +01:00
README.md docs: add third-party-tools.md links to guide index and observability 2026-02-01 22:59:36 +01:00
sandbox-isolation.md docs: add Native Sandboxing comprehensive documentation (v3.21.1) 2026-02-02 20:24:17 +01:00
sandbox-native.md docs: add Native Sandboxing comprehensive documentation (v3.21.1) 2026-02-02 20:24:17 +01:00
search-tools-cheatsheet.md docs: add search tools guides and ast-grep patterns 2026-01-25 18:47:29 +01:00
security-hardening.md release: v3.20.6 - agentskills.io integration + 4 resource evaluations 2026-02-01 16:49:33 +01:00
third-party-tools.md docs: RTK documentation update - upstream + fork integration 2026-02-01 22:20:43 +01:00
ultimate-guide.md feat: add agent/skill quality audit tooling + Grenier evaluation 2026-02-07 15:40:18 +01:00
visual-reference.md release: v3.20.5 - 4 new ASCII diagrams (visual-reference.md) 2026-01-31 23:14:41 +01:00

Guide Documentation

Core documentation for mastering Claude Code.

Contents

File Description Time
ultimate-guide.md Complete reference covering all Claude Code features ~3 hours
mcp-servers-ecosystem.md Community MCP servers: 8 validated servers (Playwright, Semgrep, Kubernetes, etc.) with production configs 25 min
third-party-tools.md Community tools: GUIs, TUIs, config managers, token trackers, alternative UIs 15 min
claude-code-releases.md Official release history (condensed) 10 min
known-issues.md Critical bugs tracker: security issues, token consumption, verified community reports 15 min
cheatsheet.md 1-page printable quick reference 5 min
visual-reference.md Visual cheatsheet — ASCII diagrams for key concepts 5 min
architecture.md How Claude Code works internally (master loop, tools, context) 25 min
learning-with-ai.md Guide for juniors on using AI without losing skills 15 min
adoption-approaches.md Implementation strategies for teams 15 min
data-privacy.md Data retention and privacy guide 10 min
observability.md Session monitoring and cost tracking 15 min
methodologies.md 15 development methodologies reference (TDD, SDD, BDD, etc.) 20 min
security-hardening.md Security threats, MCP vetting, injection defense 25 min
ai-traceability.md AI attribution, disclosure policies, git-ai, compliance 20 min
devops-sre.md FIRE framework for infrastructure diagnosis and incident response 30 min
sandbox-isolation.md Docker Sandboxes, cloud alternatives, safe autonomy workflows 10 min
ai-ecosystem.md Complementary AI tools (Perplexity, Gemini, Kimi, NotebookLM, TTS) 30 min
cowork.md Claude Cowork: Summary (see dedicated repo for full docs) 5 min
workflows/ Practical workflow guides for Claude Code 30 min

Cowork Documentation

For knowledge workers using Claude Cowork (agentic desktop):

Resource Description
Cowork Hub Complete Cowork documentation
Getting Started Setup and first workflow
Capabilities What Cowork can/cannot do
Security Guide Safe usage practices
Prompt Library 50+ ready-to-use prompts
Cheatsheet 1-page quick reference

Workflows

Hands-on guides for effective development patterns:

File Description
workflows/tdd-with-claude.md Test-Driven Development with Claude
workflows/spec-first.md Spec-First Development (SDD)
workflows/plan-driven.md Using /plan mode effectively
workflows/iterative-refinement.md Iterative improvement loops
workflows/tts-setup.md Add text-to-speech narration to Claude Code (18 min)
workflows/task-management.md Multi-session task tracking, TodoWrite migration
  1. New users: Start with Quick Start section in ultimate-guide.md
  2. Daily reference: Print cheatsheet.md
  3. Team leads: Read adoption-approaches.md for rollout strategies

Back to main README