940caf3f1e
NEW: guide/known-issues.md (285 lines) - GitHub issue auto-creation bug (Issue #13797, v2.0.65+, ACTIVE) * 17+ confirmed accidental public disclosures * Security/privacy risk documented * Workarounds: explicit repo, manual approval, pre-execution verification - Excessive token consumption (Issue #16856, v2.1.1+, Jan 2026) * 20+ reports of 4x+ faster consumption * Anthropic: "Not officially confirmed as bug" (investigating) * Workarounds: /context monitoring, shorter sessions, disable auto-compact - Model quality degradation (Aug-Sep 2025, RESOLVED) * Anthropic official postmortem: 3 infrastructure bugs * Community theories (quantization) debunked FACT-CHECKED: Perplexity Pro + GitHub API direct queries - Verified: 5,702 open issues (not 4,697), 527 invalid labels - Corrected: v2.1.1 token bug (not non-existent v2.0.61) - Sources: GitHub Issues, Anthropic postmortem, The Register UPDATED: - guide/README.md: Added known-issues.md to docs table - machine-readable/reference.yaml: 4 new entries for issue tracking - CHANGELOG.md: Documented integration process NEW: docs/resource-evaluations/023-community-discussions-report-jan2026.md - Full evaluation process documented - Fact-check methodology: Perplexity + GitHub API - Score: 2/5 (Marginal - partial integration only) - Lesson: Always verify community reports with primary sources Impact: Critical security awareness for users, actionable workarounds Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
3.7 KiB
3.7 KiB
Guide Documentation
Core documentation for mastering Claude Code.
Contents
| File | Description | Time |
|---|---|---|
| ultimate-guide.md | Complete reference covering all Claude Code features | ~3 hours |
| 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 |
| 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 |
| 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 |
Recommended Reading Order
- New users: Start with Quick Start section in
ultimate-guide.md - Daily reference: Print
cheatsheet.md - Team leads: Read
adoption-approaches.mdfor rollout strategies
Back to main README