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>
60 lines
3.7 KiB
Markdown
60 lines
3.7 KiB
Markdown
# Guide Documentation
|
|
|
|
Core documentation for mastering Claude Code.
|
|
|
|
## Contents
|
|
|
|
| File | Description | Time |
|
|
|------|-------------|------|
|
|
| [ultimate-guide.md](./ultimate-guide.md) | Complete reference covering all Claude Code features | ~3 hours |
|
|
| [claude-code-releases.md](./claude-code-releases.md) | Official release history (condensed) | 10 min |
|
|
| [known-issues.md](./known-issues.md) | **Critical bugs tracker**: security issues, token consumption, verified community reports | 15 min |
|
|
| [cheatsheet.md](./cheatsheet.md) | 1-page printable quick reference | 5 min |
|
|
| [architecture.md](./architecture.md) | How Claude Code works internally (master loop, tools, context) | 25 min |
|
|
| [learning-with-ai.md](./learning-with-ai.md) | Guide for juniors on using AI without losing skills | 15 min |
|
|
| [adoption-approaches.md](./adoption-approaches.md) | Implementation strategies for teams | 15 min |
|
|
| [data-privacy.md](./data-privacy.md) | Data retention and privacy guide | 10 min |
|
|
| [observability.md](./observability.md) | Session monitoring and cost tracking | 15 min |
|
|
| [methodologies.md](./methodologies.md) | 15 development methodologies reference (TDD, SDD, BDD, etc.) | 20 min |
|
|
| [security-hardening.md](./security-hardening.md) | Security threats, MCP vetting, injection defense | 25 min |
|
|
| [ai-traceability.md](./ai-traceability.md) | AI attribution, disclosure policies, git-ai, compliance | 20 min |
|
|
| [devops-sre.md](./devops-sre.md) | FIRE framework for infrastructure diagnosis and incident response | 30 min |
|
|
| [ai-ecosystem.md](./ai-ecosystem.md) | Complementary AI tools (Perplexity, Gemini, Kimi, NotebookLM, TTS) | 30 min |
|
|
| [cowork.md](./cowork.md) | Claude Cowork: Summary (see [dedicated repo](https://github.com/FlorianBruniaux/claude-cowork-guide) for full docs) | 5 min |
|
|
| [workflows/](./workflows/) | Practical workflow guides for Claude Code | 30 min |
|
|
|
|
### Cowork Documentation
|
|
|
|
For knowledge workers using Claude Cowork (agentic desktop):
|
|
|
|
| Resource | Description |
|
|
|----------|-------------|
|
|
| **[Cowork Hub](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/README.md)** | Complete Cowork documentation |
|
|
| [Getting Started](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/01-getting-started.md) | Setup and first workflow |
|
|
| [Capabilities](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/02-capabilities.md) | What Cowork can/cannot do |
|
|
| [Security Guide](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/guide/03-security.md) | Safe usage practices |
|
|
| [Prompt Library](https://github.com/FlorianBruniaux/claude-cowork-guide/tree/main/prompts) | 50+ ready-to-use prompts |
|
|
| [Cheatsheet](https://github.com/FlorianBruniaux/claude-cowork-guide/blob/main/reference/cheatsheet.md) | 1-page quick reference |
|
|
|
|
### Workflows
|
|
|
|
Hands-on guides for effective development patterns:
|
|
|
|
| File | Description |
|
|
|------|-------------|
|
|
| [workflows/tdd-with-claude.md](./workflows/tdd-with-claude.md) | Test-Driven Development with Claude |
|
|
| [workflows/spec-first.md](./workflows/spec-first.md) | Spec-First Development (SDD) |
|
|
| [workflows/plan-driven.md](./workflows/plan-driven.md) | Using /plan mode effectively |
|
|
| [workflows/iterative-refinement.md](./workflows/iterative-refinement.md) | Iterative improvement loops |
|
|
| [workflows/tts-setup.md](./workflows/tts-setup.md) | Add text-to-speech narration to Claude Code (18 min) |
|
|
| [workflows/task-management.md](./workflows/task-management.md) | Multi-session task tracking, TodoWrite migration |
|
|
|
|
## Recommended Reading Order
|
|
|
|
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](../README.md)*
|