claude-howto/openspec/changes/add-cli-lesson/tasks.md

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