This repository provides a structured workflow for managing AI-assisted software development, targeting developers who use AI coding assistants like Cursor or Claude Code. It aims to improve the reliability and control of AI-generated code by breaking down feature development into granular, manageable tasks with built-in verification steps.

How It Works

The core idea is to guide AI development through a series of markdown files that act as structured prompts. This process begins with a Product Requirement Document (PRD) to define the feature, followed by a task generation prompt to break the PRD into actionable steps. Finally, a process prompt instructs the AI to execute these tasks sequentially, awaiting user approval for each step, thereby enabling iterative development and easier debugging.

Quick Start & Requirements

• Clone or download the markdown files (create-prd.md, generate-tasks.md, process-task-list.md) into your project.
• Reference these files within your AI coding assistant using the tool's specific syntax (e.g., @filename.md for Cursor).
• Follow the 5-step workflow outlined in the README.
• For optimal results, a capable AI model is recommended; free tiers may struggle with complex instructions.

Highlighted Details

• Enables systematic feature development from ideation to implementation.
• Facilitates step-by-step code review and approval for enhanced control.
• Breaks down complex features into smaller, manageable AI tasks.
• Offers a more reliable alternative to monolithic AI prompts for development.
• Provides clear progress tracking through completed task lists.

Maintenance & Community

Contributions are welcome via issues and pull requests. The repository is maintained by snarktank.

Licensing & Compatibility

The repository does not explicitly state a license. Compatibility is designed for AI coding assistants like Cursor and Claude Code, with specific instructions provided for each.

Limitations & Caveats

The effectiveness of this workflow is highly dependent on the capabilities of the AI model used; less capable models may struggle to follow the structured instructions. The README suggests upgrading to paid tiers of tools like Cursor for better results.