Florian BRUNIAUX
3a7671ac5e
docs: update $ARGUMENTS syntax for v2.1.19 breaking change + evaluation
Updated all documentation and examples to reflect Claude Code v2.1.19
breaking change: $ARGUMENTS.0 → $ARGUMENTS[0] (bracket syntax).
Changes:
- guide/ultimate-guide.md: 7 occurrences updated to bracket/shorthand syntax
- guide/cheatsheet.md: Command template updated
- Added migration note in § 6.2 Variable Interpolation
- Created migration scripts: migrate-arguments-syntax.{sh,ps1}
• Automated detection + conversion with backups
• Dry-run mode, cross-platform (macOS/Linux/Windows)
- Added formal evaluation: eval-claude-code-releases-jan2026.md
• Score: 5/5 (Critical - Integrate Immediately)
• Covers releases 2.1.0 to 2.1.19 (January 2026)
• Technical accuracy verified against GitHub CHANGELOG
Files:
- guide/ultimate-guide.md (+23 lines, 7 occurrences fixed)
- guide/cheatsheet.md (+1 line)
- examples/scripts/migrate-arguments-syntax.sh (+152 lines)
- examples/scripts/migrate-arguments-syntax.ps1 (+143 lines)
- docs/resource-evaluations/eval-claude-code-releases-jan2026.md (+273 lines)
- CHANGELOG.md (+12 lines, Unreleased section)
Total: +605 lines
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>