bd01add3f6
1. Resource evaluation (docs/resource-evaluations/zolkos-insights-deep-dive.md):
- Score: 4/5 (High Value) - comprehensive technical architecture
- Content: 7-stage pipeline, facets classification (6 dimensions), technical specs
- Decision: Integrate architecture + facets (complementary with usage doc)
- Comparison: Zolkos (architecture interne) vs Guide (usage externe) = complet
- Why not 5/5: Missing user guidance, screenshots, prompt examples
- Updated index: 23 evaluations total
2. Architecture Overview added to guide (ultimate-guide.md L6460+):
- 7-stage pipeline: filtering, summarization, facet extraction, aggregation,
executive summary, report generation, facet caching
- Facets Classification System (6 dimensions):
* Goals (13 types): Debug, Implement, Fix Bug, Write Script, Refactor, etc.
* Friction (12): Misunderstood, wrong approach, buggy code, user rejection, etc.
* Satisfaction (6): Frustrated → Dissatisfied → Likely → Satisfied → Happy
* Outcomes (4): Not → Partially → Mostly → Fully Achieved
* Success (7): Fast search, correct edits, explanations, proactive, multi-file, etc.
* Session Types (5): Single, multi, iterative, exploration, quick question
- Performance: Caching system (facets/<session-id>.json) for incremental analysis
- Interpretation guidance: How facets help understand report recommendations
- Source attribution: Zolkos Technical Deep Dive (2026-02-04)
3. CHANGELOG [Unreleased]:
- Comprehensive /insights documentation with architecture deep dive
- Facets classification system (6 dimensions documented)
- Performance optimization explanation (caching)
- Resource evaluation: Zolkos deep dive (4/5, integrated)
Impact: Power users can now understand WHY /insights generates specific suggestions
(based on facets classification), optimize workflows for better analysis (avoid <2 msg
sessions), and interpret friction categories with context (12 types documented).
Complementarity proven: Usage documentation (existing) + Architecture (Zolkos) = complete.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| images | ||
| workflows | ||
| adoption-approaches.md | ||
| ai-ecosystem.md | ||
| ai-traceability.md | ||
| architecture.md | ||
| cheatsheet.md | ||
| claude-code-releases.md | ||
| cowork.md | ||
| data-privacy.md | ||
| devops-sre.md | ||
| known-issues.md | ||
| learning-with-ai.md | ||
| mcp-servers-ecosystem.md | ||
| methodologies.md | ||
| observability.md | ||
| production-safety.md | ||
| README.md | ||
| sandbox-isolation.md | ||
| sandbox-native.md | ||
| search-tools-cheatsheet.md | ||
| security-hardening.md | ||
| third-party-tools.md | ||
| ultimate-guide.md | ||
| visual-reference.md | ||
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 |
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