Commit graph

11 commits

Author SHA1 Message Date
Florian BRUNIAUX
a55ff38143 feat(quiz): add complete audit system for 256 questions
Implements automated pipeline for quiz question quality control:

**Phase 1: Context Extraction**
- Script: extract-audit-context.py
- Resolves doc_reference anchors to guide sections (97.3% success)
- Multi-file support (ultimate-guide.md, learning-with-ai.md, etc.)
- Fuzzy matching + substring fallback
- Output: audit-context.json (256 questions + context)

**Phase 2: Batch Generation**
- Script: generate-audit-batches.py
- 16 prioritized review batches by category
- Advanced Patterns split into 2 batches (29 questions)
- Embedded review instructions in each batch
- Output: audit-batches/*.md (16,559 lines)

**Phase 3: Report Compilation**
- Script: generate-audit-report.py
- Parses agent review outputs (PASS/ISSUE format)
- Aggregates by severity (critical/warning/info)
- Output: audit-report.md

**Validation:**
- Q01-001 error found immediately (curl vs npm contradiction)
- System working as designed 

**Documentation:**
- AUDIT-WORKFLOW.md (complete 5-phase guide)
- AUDIT-SYSTEM-SUMMARY.md (architecture + metrics)
- IMPLEMENTATION-COMPLETE.md (status + validation)
- DEMO-REVIEW-OUTPUT.txt (example review)

**Next Steps:** Manual agent reviews (16 batches, ~2-3 hours)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 16:45:47 +01:00
Florian BRUNIAUX
23e0ac476d docs: add /release command docs + visual-reference to guide index
- CLAUDE.md: document /release slash command with examples
- guide/README.md: add visual-reference.md to contents table
- scripts/compile-questions.sh: quiz compilation utility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 23:20:01 +01:00
Florian BRUNIAUX
bd193cf73a feat: add GitHub stars verification to sync script
Added automatic verification of GitHub stars count:
- Fetches actual count from GitHub API
- Compares with landing index.html badge
- Tolerance: ±10% or ±10 stars (whichever is larger)
- Prevents future mismatches like 1.2k vs 60

Verification output example:
  Actual (GitHub API): 60
  Landing (index.html): 60
  ✓ OK (within tolerance: ±10)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-27 12:45:18 +01:00
Florian BRUNIAUX
3968c13aa2 docs: sync README badges + fix template count methodology
- Update Lines badge: 10,900+ → 11,100+ (Trust Calibration section added)
- Update Templates badge: 65 → 61 (exclude README/index files)
- Update Commands: 15 → 18 (add /learn:teach, /learn:quiz, /learn:alternatives)
- Fix check-landing-sync.sh: exclude README.md and index.md from template count
- Restructure README: move Privacy/Community to bottom, remove newsletter callout

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 17:41:56 +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
d3f3db0d14 fix(sync): distinguish guide version from Claude Code version in check
The previous regex matched any 'vX.Y.Z' pattern, capturing 'Claude Code v2.1.12'
instead of the guide version. Now specifically looks for 'Version X.Y.Z' pattern.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 18:10:24 +01:00
Florian BRUNIAUX
0348f08288 feat: add Claude Code releases tracking
Add condensed release history for Claude Code product (v2.0.24 → v2.1.12)

New files:
- machine-readable/claude-code-releases.yaml: Source of truth (YAML)
- guide/claude-code-releases.md: Human-readable changelog
- scripts/update-cc-releases.sh: Check for new releases from GitHub

Modified:
- reference.yaml: Add deep_dive entries for releases
- check-landing-sync.sh: Add CC version check (#5)
- README.md, guide/README.md: Add navigation links
- CLAUDE.md: Document update workflow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 11:33:21 +01:00
Florian BRUNIAUX
b814c568d1 fix: correct template count to 53 (validated by sync script)
- Update sync script to include .json files in count
- Fix README.md and CLAUDE.md with accurate count

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:56:24 +01:00
Florian BRUNIAUX
6f968dbfc5 fix(sync): update landing sync script for new directory structure
- Change examples.html → examples/index.html
- Change quiz.html → quiz/index.html
- Add fresh-context-loop.sh script

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:42:03 +01:00
Florian BRUNIAUX
15475197ab feat(sync): add landing site synchronization system
- Add scripts/check-landing-sync.sh verifying 4 metrics:
  - Version (VERSION vs landing index.html)
  - Templates count (find examples/ vs landing badges)
  - Quiz questions (questions.json vs index.html + quiz.html)
  - Guide lines (with ±500 tolerance)
- Update CLAUDE.md with sync documentation and expected output
- Fix templates count: 87 → 49 in README.md badges and text

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 12:21:09 +01:00
Florian BRUNIAUX
5575ae69a8 feat: add VERSION file as single source of truth + sync script
- Create VERSION file (3.6.0) as the canonical version source
- Add scripts/sync-version.sh for automated version synchronization
- Fix version inconsistencies in cheatsheet.md and ultimate-guide.md
- Script supports --check mode for CI validation

Usage: ./scripts/sync-version.sh [--check]

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:18:32 +01:00