docs: add verified critical bugs tracker (known-issues.md)

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>
This commit is contained in:
Florian BRUNIAUX 2026-01-28 17:59:16 +01:00
parent a75c66a890
commit 940caf3f1e
5 changed files with 592 additions and 0 deletions

View file

@ -22,6 +22,11 @@ deep_dive:
# Claude Code Releases
claude_code_releases: "guide/claude-code-releases.md"
claude_code_releases_yaml: "machine-readable/claude-code-releases.yaml"
# Known Issues & Critical Bugs (verified community reports)
known_issues: "guide/known-issues.md"
known_issues_github_bug: "guide/known-issues.md:16" # GitHub auto-creation bug
known_issues_token_consumption: "guide/known-issues.md:136" # Excessive token usage
known_issues_model_quality_aug2025: "guide/known-issues.md:231" # Resolved: Aug 2025 degradation
# Template Installation
install_templates_script: "scripts/install-templates.sh"
# Session management