Commit graph

9 commits

Author SHA1 Message Date
Florian BRUNIAUX
dd833bcc07 docs: reference ai-ecosystem.md everywhere + add quiz questions
- Add AI Ecosystem to README.md Core Documentation table
- Create quiz/questions/15-ai-ecosystem.yaml (10 questions)
- Update question count: 217 → 227

Topics covered: Perplexity, Gemini, Kimi, NotebookLM, v0.dev,
workflow orchestration, cost optimization

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 13:04:07 +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
741acd0fa3 feat(quiz): add 58 new questions (159→217) in 4 new categories
New categories:
- 11-learning-with-ai.yaml (15 questions): UVAL protocol, 70/30 rule, dependency patterns
- 12-architecture.yaml (12 questions): master loop, 8 tools, context budget, sub-agents
- 13-security.yaml (10 questions): MCP Rug Pull, CVEs, defense-in-depth
- 14-privacy-observability.yaml (10 questions): retention tiers, session search

Additions to existing:
- 08-mcp-servers.yaml: +3 Figma MCP questions (token efficiency, tools, setup)
- 09-advanced-patterns.yaml: +5 methodology questions (SDD, BDD, TDD)
- 01-quick-start.yaml: +3 image optimization questions

README updated: 217 questions, 56 templates, 14 categories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 22:48:57 +01:00
Florian BRUNIAUX
d7c29f49c9 docs: prioritize grepai over mgrep as recommended semantic search
- Reorder sections in ultimate-guide.md (grepai first, mgrep second)
- Update cheatsheet.md MCP table (mgrep → grepai)
- Update quiz question 08-013 to reference grepai
- Sync versions to 3.8.2

Rationale: grepai is fully open-source, runs locally (privacy-first),
and offers call graph analysis that mgrep doesn't provide.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:29:33 +01:00
Florian BRUNIAUX
174192f583 feat(seo): add CITATION.cff and improve AI discoverability
- Add CITATION.cff for academic citations and GitHub citation button
- Add "For AI Assistants" section in README with llms.txt reference
- Update machine-readable/llms.txt stats (4700+ → 9600+ lines)
- Bump version display to 3.8.0 in README footer

Improves discoverability in GitHub search, Google Scholar, and AI assistants

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:21:58 +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
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
Florian BRUNIAUX
33c37651a6 feat(quiz): add interactive CLI knowledge quiz v3.0.0
BREAKING: Major version release with new quiz feature

New Features:
- Interactive CLI quiz with 159 curated questions
- 4 user profiles: Junior, Senior, Power User, Product Manager
- 10 topic categories covering all guide sections
- Immediate feedback with explanations and doc references
- Session persistence to ~/.claude-quiz/
- Score tracking with category breakdown
- Optional dynamic question generation via claude -p
- Cross-platform support (Node.js): macOS, Linux, Windows

Quiz highlights:
- Profile-based question filtering and difficulty weighting
- Retry wrong questions only or new quiz options
- Visual progress bar and score visualization
- Direct documentation links for wrong answers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 15:49:38 +01:00
Florian BRUNIAUX
5b526f5e53 feat(audit): enhanced stack detection with integrations
- Detailed stack breakdown: runtime, framework, test, bundler, database
- Generic integration detection (25+ packages: Clerk, Stripe, OpenAI, Sentry...)
- jq fallback: grep-based JSON parsing when jq not installed
- Stack recap at top of human output + full stack object in JSON
- README prompt updated: Stack Recap first, CLAUDE.md template ~100 lines

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-12 14:52:55 +01:00