Files
claude-howto/openspec/changes/add-cli-lesson/tasks.md
T
Luong NGUYEN ee0f4bd5d9 docs: Update slash commands documentation with official features
- Add comprehensive built-in commands reference (40+ commands)
- Document argument handling ($ARGUMENTS, $1, $2, etc.)
- Add bash execution syntax (! prefix) and file references (@ prefix)
- Update frontmatter to official fields (allowed-tools, argument-hint, model, etc.)
- Add Plugin Commands and MCP Slash Commands sections
- Add SlashCommand Tool documentation for programmatic invocation
- Add Skills vs Slash Commands comparison table
- Create commit.md example with bash execution and context
- Update existing examples to use official frontmatter format
- Add OpenSpec proposal for change tracking
2025-12-24 15:30:47 +01:00

1.8 KiB

Tasks: Add CLI Reference Lesson

1. Create CLI Lesson Content

  • 1.1 Create 10-cli/ directory
  • 1.2 Create 10-cli/README.md with:
    • Overview section with architecture diagram
    • CLI commands table (claude, claude "query", claude -p, etc.)
    • Core flags section with examples
    • Model & configuration flags
    • System prompt customization section
    • Tool & permission management section
    • Output & format options
    • Workspace & directory flags
    • MCP configuration options
    • Session management commands
    • Advanced features (chrome, ide, debug)
    • Agents flag format with JSON examples
    • High-value use cases section with practical examples
    • Installation/usage quick reference
    • Troubleshooting section
    • Related concepts links

2. Add Use Case Examples

  • 2.1 CI/CD integration example (GitHub Actions, Jenkins)
  • 2.2 Script piping example (log analysis, code processing)
  • 2.3 Multi-session workflow example
  • 2.4 Custom agent configuration example
  • 2.5 Batch processing example
  • 2.6 Security-conscious development example
  • 2.7 JSON API integration example

3. Update Root Documentation

  • 3.1 Add CLI to Quick Navigation table in README.md
  • 3.2 Add CLI to Learning Path table in README.md
  • 3.3 Add CLI section (section 10) in README.md
  • 3.4 Add CLI to Feature Comparison table
  • 3.5 Add CLI to Use Case Matrix
  • 3.6 Add CLI to Directory Structure tree
  • 3.7 Add CLI to Installation Quick Reference
  • 3.8 Update LEARNING-ROADMAP.md with CLI lesson

4. Quality Assurance

  • 4.1 Verify all code examples are valid and tested
  • 4.2 Ensure consistent style with other lessons (mermaid diagrams, tables)
  • 4.3 Check all internal links work correctly
  • 4.4 Review against official documentation for accuracy