docs: Add tier-aware diagnostics documentation
- Language-Support.md: Add Tier-Specific Diagnostics section
- User-Guide.md: Expand ckb doctor with --tier flag docs
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
aa55b32
docs: Update tier documentation for v7.2
- Add Analysis Tiers section to User Guide with tier table and control methods
- Rename Basic → Fast, Enhanced → Standard throughout Language Support
- Add tier config option documentation to Configuration
- Update tier references in Home and Quick Start
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
30ca45b
docs: Add smart indexing documentation for v7.2
- Add `ckb index` command section with smart indexing explanation
- Add supported languages table with indexer install commands
- Update `ckb status` with Index Status output examples
- Add `ckb mcp --watch` documentation for auto-reindex mode
- Update Best Practices to use `ckb index` for freshness
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
90bd165
docs: Fix Kotlin/PHP URLs and add language prerequisites
- Fixed broken Kotlin indexer URL
- Fixed PHP indexer URL
- Added prerequisite notes for new languages
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
80d0e5a
docs: Add ckb setup command documentation
Document the new multi-tool setup wizard:
- Getting Started section with quick setup guide
- Full CLI command reference with all flags
- Supported tools table (Claude Code, Cursor, Windsurf, VS Code, OpenCode, Claude Desktop)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
af8a1af
docs: Remove 'recommended' label from Claude Code
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
506e3df
docs: Add universal MCP client setup (Cursor, Windsurf, VS Code, OpenCode)
- Expand Quick Setup with sections for all major MCP clients
- Add config examples for Cursor, Windsurf, VS Code, OpenCode
- Add Windows cmd /c wrapper instructions
- Include UI navigation hints for each tool
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
e0265f1
docs: Add dedicated Telemetry page
- New Telemetry.md with complete setup guide
- Quick start, coverage levels, dead code detection
- Service mapping, troubleshooting, best practices
- Links to related reference pages
- Added to Home.md table of contents
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
e33cc70
docs: Add contract-aware CI and improve intro framing
- New intro: CKB as "single source of truth for change risk"
- New section: Contract-Aware CI (v6.3) with examples
- Safe refactor checklist generation for high-risk PRs
- Updated recommended rollout to include contracts
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
bd570ee
docs: Add Language Support page explaining SCIP tiers
- New Language-Support.md explaining Enhanced/Basic/Minimal tiers
- Documents which languages have SCIP indexers
- Feature matrix by tier
- Links added from Home, Quick-Start, and Practical-Limits
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
8a2b334
docs: Update wiki for v7.0 npm release
- Update API-Reference header to v7.0
- Add v6.5 and v7.0 to Architecture version list
- Update CI-CD-Integration with npm as recommended
- Add v7.0 Zero-Friction UX section to Home
- Update User-Guide with npm installation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
dce84e0
docs: update wiki for v7.0 with npm installation instructions
7c85bdc
docs: Add v6.5 annotation integration documentation
- MCP-Integration: Enhanced recordDecision, getDecisions, annotateModule
with parameter tables, examples, and v6.5 integration notes
- User-Guide: Added Annotations subsection, enhanced decisions and
modules annotate sections with v6.5 integration
- Prompt-Cookbook: Added two new workflows for annotation-aware
dead code detection and impact analysis
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
20a87b5
docs: Add table of contents to User Guide
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
988b561
docs: Add documentation for new CLI commands
- Federation.md: Add search-modules, search-ownership, hotspots,
search-decisions CLI commands
- User-Guide.md: Add modules, justify, callgraph, entrypoints, trace,
hotspots, diff-summary, pr-summary, jobs, concepts, recent, complexity
CLI commands
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
f5f2b09
docs: Remove v6.5 theme tagline from Home page
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
ee42b90
docs: Clarify read-only scope in Home page disclaimer
Replace terse "Non-goal" bullet with clear explanation of what CKB does and doesn't do, with librarian analogy.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
c589c6f
docs: Move non-goal disclaimer to Home page
Centralize the read-only constraint in the main landing page
rather than the MCP integration guide.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
f4c6160
docs: Remove stacked version themes from MCP Integration guide
Version history doesn't belong in an integration setup guide.
Kept only the "Non-goal" note which sets relevant expectations.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1c5016b
docs: Add v6.5 Developer Intelligence features
New MCP tools:
- explainOrigin: Why does this code exist?
- analyzeCoupling: Find co-change patterns
- exportForLLM: LLM-friendly codebase export
- auditRisk: Multi-signal risk audit
New CLI commands:
- ckb explain: Symbol origin explanation
- ckb coupling: Co-change analysis
- ckb export: LLM export
- ckb audit: Risk audit
Updates:
- Home.md: v6.5 theme and feature section
- MCP-Integration.md: Full v6.5 tool documentation
- Prompt-Cookbook.md: v6.5 recipes and workflows
- User-Guide.md: v6.5 CLI commands
Tool count: 54 → 58
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
5f8b424
docs: Add v6.2.2, v6.3, and v6.4 feature documentation
## v6.2.2 - Tree-sitter Complexity
- Added getFileComplexity MCP tool documentation
- Added /complexity API endpoint
## v6.3 - Contract-Aware Impact Analysis
- Added 6 contract MCP tools (listContracts, analyzeContractImpact, etc.)
- Added 7 contract API endpoints
- Added contract CLI commands
- Added contract analysis section to Federation.md
## v6.4 - Runtime Telemetry
- Added 3 telemetry MCP tools (getTelemetryStatus, getObservedUsage, findDeadCodeCandidates)
- Added 6 telemetry API endpoints
- Added telemetry CLI commands (ckb telemetry, ckb dead-code)
- Added full telemetry configuration section
- Added telemetry architecture diagrams
## Other Updates
- Updated tool count from 50 to 54 across all docs
- Added v6.1-v6.4 sections to Architecture.md
- Added 4 new recipe sections to Prompt-Cookbook.md
- Added 4 new workflow sequences
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
5c1ab34
Add v6.2 Federation docs, MODULES.toml format, and ADR workflow
New:
- Federation.md: Complete documentation for cross-repo queries (v6.2)
- CLI commands, HTTP API endpoints, MCP tools
- Core concepts: repo identity, index, staleness propagation
- Use cases and best practices
Updated:
- Configuration.md: Add comprehensive MODULES.toml and ADR sections
- Correct TOML syntax with [[module]] array format
- Full ADR workflow: create, query, statuses, best practices
- API-Reference.md: Add Federation endpoints (v6.2)
- MCP-Integration.md: Add 8 Federation tools, update to 38 total
- Home.md: Add Federation feature, update TOC
- User-Guide.md: Add federation CLI commands
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
9819043
Extract CI/CD Integration to dedicated wiki page
- Create CI-CD-Integration.md with GitHub Actions workflows, PR analysis,
and automated architecture refresh documentation
- Update User-Guide.md to link to new page instead of inline content
- Add CI/CD Integration link to Home.md Table of Contents
- Update User Guide description (remove CI/CD mention)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3f89d2d
Fix Configuration.md to match actual implementation
Major rewrite to accurately document config.go:
- Schema version is 5 (not 6)
- queryPolicy: backendPreferenceOrder, alwaysUse, maxInFlightPerBackend,
coalesceWindowMs, mergeMode, supplementThreshold, timeoutMs
- lspSupervisor: maxTotalProcesses, queueSizePerLanguage, maxQueueWaitMs
- modules: detection, roots, ignore
- importScan: added maxFileSizeBytes, scanTimeoutMs, skipBinary, customPatterns
- cache: queryTtlSeconds, viewTtlSeconds, negativeTtlSeconds
- privacy: mode (not redactPaths/excludePatterns)
Added new sections:
- CLI Command Flags table for search, refs, impact, arch, serve, diag
- v6.0 Configuration Roadmap noting ownership/decisions/staleness
are implemented but use hardcoded defaults
Added note at top about v6 features using defaults until
configurable settings are added.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
0c7f1ce
Add Codebase Improvement Audit recipe to Cookbook
New recipe for evidence-based cleanup planning:
- When to use (cleanup sprints, tech debt, legacy detection)
- Safe default prompt with constraints and output format
- Scoped audit prompt for faster results
- Dependency hygiene prompt (go.mod/package.json/pubspec)
- Example output with priority levels and verification steps
- Troubleshooting table
- Follow-up prompts for creating cleanup plans
Also added "Always require verification before deletes" tip
to Tips for Better Results section.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2bcc13e
Add Practical Limits page - accuracy notes and validation
New page covering:
- Best-fit tasks (where CKB excels)
- Low-impact tasks (when not to use CKB)
- Known blind spots:
- Dynamic dispatch / reflection
- Generated code
- Cross-repository references
- Conditional compilation
- Test-only code
- Stale indexes
- Macro-heavy languages
- Confidence level explanations (0.0-1.0)
- Validation checklist and prompts
- When to trust vs verify results
- Accuracy summary by feature
Linked from:
- Home.md Table of Contents
- Prompt Cookbook Reference section
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
f5e77be
Add table of contents to Prompt Cookbook
Organized TOC with anchor links:
- Getting Started (2 items)
- Core Recipes (8 items)
- Workflow Sequences (7 items)
- Reference (4 items)
Each link includes brief description so users can scan
and jump to what they need.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
945db92
Expand Prompt Cookbook with all use cases
Added missing sections:
- Bug Investigation (trace errors, find recent changes)
- Understand a File or Path (file orientation, role classification)
- Dead Code Cleanup (full section with verdict examples)
- Workflow Sequences (explicit tool chains for 7 scenarios)
Workflow sequences now include:
- New Codebase Ramp-Up
- Bug Investigation
- Before Making Changes
- Code Review
- Dead Code Sanity Check
- Understanding Module Ownership
- Recording Design Decisions
Each sequence shows both the tool chain and natural language prompt.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
9f87579
Add Prompt Cookbook - practical guide for new users
New page with real prompts organized by intent:
- Find the symbol (search, filter, follow-up)
- Trace request flow from entrypoints
- Blast radius / impact analysis
- Summarize PR diff by risk
- Onboarding to unfamiliar modules
- More recipes (ownership, hotspots, dead code, ADRs)
Each section includes:
- When to use
- Example prompts
- Expected output
- Troubleshooting table
- Follow-up prompts
Aimed at users new to coding or MCP who don't know
what questions to ask.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
270bebc
Add version numbers to MCP tools table in Home.md
Group tools by version (v5.1, v5.2, v6.0) with themed sections:
- v5.1: Core Navigation (10 tools)
- v5.2: Discovery & Flow (9 tools)
- v6.0: Architectural Memory (6 tools)
Helps users understand feature evolution and what's new.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
0f6f951