Florian BRUNIAUX
b65630641b
refactor(guide): restructure guide/ into thematic subdirectories
...
Reorganize 22 guide files from a flat directory into 5 thematic subdirs:
- core/ (architecture, methodologies, known-issues, claude-code-releases, visual-reference)
- security/ (security-hardening, sandbox-isolation, sandbox-native, production-safety, data-privacy)
- ecosystem/ (ai-ecosystem, mcp-servers-ecosystem, third-party-tools, remarkable-ai)
- roles/ (ai-roles, adoption-approaches, learning-with-ai, agent-evaluation)
- ops/ (devops-sre, observability, ai-traceability)
All internal links updated across ~50 files (ultimate-guide.md, workflows/,
diagrams/, README.md, docs/, tools/, examples/, machine-readable/).
Also: merge search-tools-cheatsheet.md into cheatsheet.md, rewrite guide/README.md
with H2 grouped sections, update CLAUDE.md repository structure.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-10 08:35:13 +01:00
Florian BRUNIAUX
8f1dcecfa2
docs: update guide content, examples, tools, and reference files
...
- guide/ultimate-guide.md — content updates
- guide/workflows/README.md, guide/README.md — navigation improvements
- guide/diagrams/ — diagram updates (context/sessions, config, MCP ecosystem)
- guide/third-party-tools.md — additions
- examples/README.md, hooks/README.md, scripts/README.md — examples updates
- examples/skills/pr-triage/SKILL.md — expanded skill
- machine-readable/reference.yaml — reference sync
- tools/audit-prompt.md, tools/onboarding-prompt.md — tooling updates
- docs/for-cto.md, docs/for-tech-leads.md, docs/resource-evaluations/README.md — doc updates
- .gitignore — gitignore update
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-09 15:32:33 +01:00
Florian BRUNIAUX
a5f441bcea
feat: add ecosystem positioning, install script & new commands
...
Ecosystem & Positioning:
- Add README section with competitive positioning (davila7, awesome-claude-code, wesammustafa)
- Add comparison table highlighting unique features (architecture, TDD/SDD, quiz, YAML index)
- Add ecosystem section to reference.yaml
Template Installation:
- Add scripts/install-templates.sh for one-liner template installation
- Support for agents, hooks, commands, skills, memory templates
New Commands:
- catchup, explain, optimize, refactor, security, ship
New Content:
- Semantic anchors catalog and documentation
- Extended guide content (+470 lines)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 08:42:33 +01:00
Florian BRUNIAUX
77d6d8eeb6
docs: update Extended Thinking documentation (v2.0.67+ changes)
...
- Thinking mode now ON by default at max budget with Opus 4.5
- Keywords "think", "think hard", "ultrathink" are cosmetic only
- Control via Alt+T (session) or /config (permanent)
- Update Trinity pattern references
- Update quiz questions (09-001, 09-002, 04-014)
- Update cheatsheet thinking section
- Add note about cosmetic flags in modes README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 18:25:20 +01:00
Florian BRUNIAUX
46c5862c4e
fix(docs): critical factual corrections v3.6.1
...
Major audit correcting misleading documentation about Claude Code behavior:
### Fixed
- `--add-dir`: permissions (not context loading)
- `excludePatterns` → `permissions.deny` (never existed)
- `.claudeignore` removed (not an official feature)
- "selective loading" myth → lazy loading reality
- Invented CLI flags (`--think`, `--headless`, `--learn`) → prompt keywords
- `@` file reference: "loads automatically" → "reads on-demand"
### Added
- Session Search Tool (`cs`) - zero-dep bash script for finding sessions
- Security section: Known limitations of permissions.deny
15 files modified, 516 insertions, 200 deletions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:16:53 +01:00
Florian BRUNIAUX
f9044e2deb
feat(docs): add architecture deep-dive documentation v3.4.0
...
Add comprehensive technical documentation explaining Claude Code internals:
- NEW: guide/architecture.md (~800 lines) - Complete architecture deep-dive
- Master Loop (while tool_call), Tool Arsenal, Context Management
- Sub-Agent Architecture, Permission System, MCP Integration
- Edit Tool mechanics, Session persistence, Philosophy comparison
- 5 ASCII diagrams, source confidence tiers (Tier 1/2/3)
- guide/ultimate-guide.md: Add Section 2.7 "Under the Hood" summary
- guide/cheatsheet.md: Add "Under the Hood (Quick Facts)" section
- machine-readable/reference.yaml: Add architecture index + deep_dive refs
- Update all navigation links across repository
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:29:46 +01:00
Florian BRUNIAUX
19110eba22
feat(docs): add comprehensive data privacy documentation v3.2.0
...
- Create guide/data-privacy.md with retention policies (5y/30d/0)
- Add privacy notice to README.md
- Add section 2.6 "Data Flow & Privacy" to ultimate-guide.md
- Add Golden Rule #7 to cheatsheet.md (know what's sent)
- Add Phase 0.5 Privacy Awareness to onboarding-prompt.md
- Add privacy checks to audit-prompt.md
- Add PRIVACY CHECK section to audit-scan.sh (human + JSON)
- Add privacy reminder to check-claude.sh
- Create privacy-warning.sh SessionStart hook
Addresses user awareness of Anthropic data retention and opt-out options.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 20:42:19 +01:00
Florian BRUNIAUX
bc07651cdf
refactor: restructure repo into thematic directories v3.1.0
...
Major repository reorganization for improved navigation:
New directory structure:
- guide/ - Core documentation (ultimate-guide, cheatsheet, adoption)
- tools/ - Interactive utilities (audit, onboarding, mobile-access)
- machine-readable/ - LLM/AI consumption (reference.yaml, llms.txt)
- exports/ - Generated outputs (PDFs)
Changes:
- Move 10 files to thematic directories with cleaner names
- Create README.md index for each new directory
- Update 150+ internal links across all documentation
- Add "Repository Structure" section to main README
- Remove redundant npm install command from README header
- Remove unverified cost estimate from prerequisites
- Fix broken anchor link (#-quick-start-15-minutes)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 15:30:02 +01:00
