This project provides an AI-powered system for gathering software requirements, designed for product managers and engineers. It automates the process by analyzing code, asking targeted yes/no questions with smart defaults, and generating detailed documentation, thereby streamlining the initial stages of feature development.

How It Works

The system operates in five phases: initial setup and code analysis, high-level context discovery questions, autonomous deep code dives, expert requirements questions based on code context, and finally, the generation of comprehensive requirements documentation including file paths and implementation patterns. This approach ensures questions are informed by the actual codebase, reducing ambiguity and improving the quality of specifications.

Quick Start & Requirements

• Install: Clone the repository and copy the commands directory to ~/.claude/commands/ or a project-specific location. Create a requirements directory.
• Usage: Interact via commands like /requirements-start [description], /requirements-status, /requirements-list, and /requirements-end.
• Prerequisites: Requires a system capable of running Claude Code (not specified, but implied).

Highlighted Details

• Codebase-Aware Questions: AI analyzes code before asking questions.
• Progressive Questioning: Two phases of yes/no questions (5 high-level, 5 expert).
• Smart Defaults: Questions include intelligent defaults based on best practices and code patterns.
• Automated Documentation: Generates specs with specific file paths and patterns.

Maintenance & Community

• The project is inspired by @iannuttall's claude-sessions.
• Contribution ideas include adding requirement templates, validation commands, and multi-language support.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for commercial and closed-source use.

Limitations & Caveats

The system relies on Claude Code, and its effectiveness is dependent on the AI's code analysis capabilities. Specific hardware or environment requirements for running Claude Code are not detailed in the README.