AI Plans

AI Plans brings structured documentation to AI-assisted development. As developers increasingly use AI tools like Claude, Copilot, and Cursor, we're losing valuable context about how and why our code was generated. AI Plans are version-controlled markdown files that live in your repository, capturing: ✅ Original developer requests - What you actually asked the AI 🎯 Implementation strategies - The AI's proposed approach 📋 Task breakdowns - Step-by-step execution plans 🚨 Issues & resolutions - Problems encountered and how they were solved Why it matters: - Knowledge retention: Future developers (or future you) can understand the reasoning behind AI-generated code - Debugging context: When something breaks, see exactly what the AI was trying to accomplish - Team collaboration: Share AI interaction patterns and successful prompting strategies - Audit trail: Track AI involvement in critical code decisions Key Features: 🔍 Searchable history - All plans in /plans/ directory, fully indexed by git 📁 Standard format - Consistent structure makes plans easy to read and write 🔄 IDE integration - Works with Claude Code, Cursor, and GitHub Copilot ⚡ Zero overhead - Simple markdown files, no dependencies or tools required Who's it for? - Teams using AI pair programming tools - Solo developers wanting to track their AI interactions - Organizations needing documentation for AI-assisted code - Anyone who's ever wondered "why did the AI write it this way?" Get Started: 1. Create a /plans/ directory in your repo 2. Add YYYY-MM-DD-description.md files for each AI session 3. Include: Summary, Request, Plan, TODOs, and Issues 4. Commit alongside your code changes Try it now: Visit https://ai-plans.dev for examples and documentation