Add comprehensive issue analysis and 2025 roadmap documentation

Adds strategic planning documents to guide technical debt reduction and
issue management for the bash-it project.

**New Documentation** (`docs/plans/`):

1. **Quick Reference** - TL;DR summary with:
   - 5 quick win bugs ready to fix
   - 6 strategic decisions needed
   - 18 stale issues to close
   - Actionable next steps

2. **Comprehensive Issue Analysis** - Detailed breakdown:
   - Categorizes all 32 open issues
   - Identifies fixable bugs vs. decisions needed
   - Recommends closure strategy for stale issues
   - Provides effort estimates and recommendations

3. **2025 Roadmap** - 6-month technical debt reduction plan:
   - Phase 1: Quick wins (5 bugs, 1 week)
   - Phase 2: Issue gardening (close stale, 1 week)
   - Phase 3: Strategic decisions (1 month)
   - Phase 4-7: Pre-commit expansion, docs, testing, packaging
   - Success metrics and KPIs
   - Risk management and resource requirements

**Key Findings**:
- 78% of issues are stale (>2 years old)
- 5 bugs can be fixed in ~4 hours
- Closing stale issues would reduce count from 32 → ~10
- Pre-commit cleanup can reach 80% coverage in 3 months

**CLAUDE.md Updates**:
- Added "Project Planning & Roadmaps" section
- Links to all three planning documents
- Makes strategic direction visible to AI assistants

These documents provide clear direction for maintainers and contributors
on priorities, technical debt, and project health improvements.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: seefood

CLAUDE.md

@@ -146,3 +146,13 @@ bash-it search docker
   - Examples: `${BASH_VERSION-}`, `${HOME-}`, `${PATH-}`
   - Critical for variables checked in conditionals: `if [ -n "${BASH_VERSION-}" ]`
   - This defensive practice ensures scripts work regardless of user's shell options
+
+## Project Planning & Roadmaps
+
+Strategic planning documents are maintained in `docs/plans/`:
+
+- **[Quick Reference](docs/plans/bash-it-quick-reference.md)** - TL;DR summary of current issues and action items
+- **[Comprehensive Issue Analysis](docs/plans/bash-it-issues-comprehensive-analysis.md)** - Detailed breakdown of all open issues with categorization and recommendations
+- **[2025 Roadmap](docs/plans/bash-it-roadmap-2025.md)** - 6-month technical debt reduction plan with phases and success metrics
+
+These documents guide ongoing maintenance, issue triage, and code quality improvements.