claude-task-master icon indicating copy to clipboard operation
claude-task-master copied to clipboard

Implement PRD Generator: AI-assisted Product Requirements Document creation workflow

Open Zyra-V21 opened this issue 9 months ago • 14 comments

PR Title

"Implement PRD Generator: AI-assisted Product Requirements Document creation workflow"

PR Notes

🚀 Overview

This PR introduces a complete PRD (Product Requirements Document) generation workflow powered by AI models like Claude and Perplexity. The system transforms basic product ideas into comprehensive, professional requirement documents through a guided, multi-stage process that simulates expert input and discussion.

🧩 Key Components

New Core Services

  • Ideation Service: Generates structured product concepts from simple ideas
  • Discussion Service: Simulates round-table discussions between expert roles
  • PRD Service: Creates final PRD documents with customizable formatting

New Data Models

  • Idea: Represents initial product concepts with metadata
  • Discussion: Captures expert discussions and key insights
  • PRD: Structures the final document with proper versioning

Workflow Integration

  • All commands can be chained for a seamless document creation process
  • Interactive user prompts guide users through each step
  • Consistent file management in the prd/ directory

🔄 PRD Generation Workflow

The complete workflow consists of four main commands:

  1. Ideation

    node scripts/dev.js ideate --idea="Product idea description" [--research]
    

    Transforms an initial idea into a structured concept document.

  2. Round Table

    node scripts/dev.js round-table --concept-file=prd/concept.txt [--participants="..."]
    

    Simulates a discussion between expert roles about the concept.

  3. Concept Refinement

    node scripts/dev.js refine-concept --concept-file=prd/concept.txt [--discussion-file=prd/discussion.txt]
    

    Improves the concept using insights from the expert discussion.

  4. PRD Generation

    node scripts/dev.js generate-prd --concept-file=prd/concept_refined.txt [--template=...] [--format=...]
    

    Creates the final PRD document based on the refined concept.

💡 UI Improvements

  • Added ora for loading indicators during AI operations
  • Enhanced user feedback with color-coded status messages
  • Interactive prompts at each step to guide workflow
  • Clear next-step suggestions after each command

🧪 Testing Status

  • 257 total tests (increase from ~126 original tests)
  • 204 tests passing
  • 49 tests skipped (primarily AI-dependent tests)
  • 4 tests failing in commands.test.js (CONFIG.projectVersion issues)

📋 Cursor Rules Updates

Updated .cursor/rules/ files with documentation about:

  • New architecture components
  • PRD generation workflow
  • New feature integration
  • External dependency justification

🔍 Implementation Notes

This feature creates a bridge between initial product ideation and structured task generation, allowing teams to:

  1. Start with just a basic product idea
  2. Generate professional PRD documentation
  3. Parse the PRD into executable tasks
  4. Track implementation progress

This completes the full circle of the Task Master CLI, from idea to implementation tracking.

Zyra-V21 avatar Apr 03 '25 20:04 Zyra-V21

⚠️ No Changeset found

Latest commit: 64cf5d8761318c9a4b982098c3f62f53246f0b52

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

changeset-bot[bot] avatar Apr 03 '25 20:04 changeset-bot[bot]

@eyaltoledano this is the good one, rest you can delete, forget the .txt an .cursor etc, was late and didnt payed so much attention sorry sir

Zyra-V21 avatar Apr 05 '25 07:04 Zyra-V21

LMK if you need help with the merge conflicts. We dont want to overwrite the new work that was done.

eyaltoledano avatar Apr 09 '25 04:04 eyaltoledano

LMK if you need help with the merge conflicts. We dont want to overwrite the new work that was done.

AS LONG AS I REMEMBER, there were not merge conflicts, corefunctionality has been uploaded isolated, so it was 100% working when I did PR'd (Well, didnt check for user bugs etc...).

The difference between this 92 issue and last one was just regarding the isolation of the functionalities.

Zyra-V21 avatar Apr 09 '25 04:04 Zyra-V21

That's nearly impossible, as my update touched like 250 files which is p much the whole project lol

i.e. scripts/modules/commands.s and dev.js and the rules

eyaltoledano avatar Apr 09 '25 04:04 eyaltoledano

Ok yes, @eyaltoledano now I get what you mean. I was about to go sleep, if it's not done when I'm back, I'll give an eye :)

Zyra-V21 avatar Apr 09 '25 04:04 Zyra-V21

I think you were talking about if I was having problem during my merge tests (i did a commit bout that and mocked one test lmao)

Zyra-V21 avatar Apr 09 '25 04:04 Zyra-V21

@Zyra-V23 please resolve conflicts, will be reviewing asap

Crunchyman-ralph avatar Apr 12 '25 10:04 Crunchyman-ralph

@Crunchyman-ralph I've reviewed the PRD generation services and addressed your feedback by removing the error-handler.js and prd.txt files. The ServiceInterface is a simple base class for the new services rather than an MCP implementation. One important integration point remains: the services (Ideation, Discussion, PRD) are fully implemented with complete functionality but aren't yet connected to the command-line interface in commands.js.

For the services to be accessible via task-master ideate or similar commands, we need to:

Register the commands in commands.js Connect them to the service implementations Add appropriate help text and parameter definitions

Would you like me to add the command registration to commands.js in a follow-up PR, or would you prefer to integrate them differently into the MCP architecture? I was told to just do the logic and leave the mcp connection part to you guys @eyaltoledano , let me know :)

Zyra-V21 avatar Apr 14 '25 20:04 Zyra-V21

Seems like it is failing the format-check and test. Please fix those failing unit tests

Crunchyman-ralph avatar Apr 15 '25 16:04 Crunchyman-ralph

It's failing because error-handler was removed, I will upload it soon and make sure it's clear defined its for handling errors related to prd service

Enviado desde Proton Mail para Android

-------- Mensaje original -------- El 15/4/25 18:09, Ralph Khreish ha escrito:

Seems like it is failing the format-check and test. Please fix those failing unit tests

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.Message ID: @.***>

Crunchyman-ralph left a comment (eyaltoledano/claude-task-master#92)

Seems like it is failing the format-check and test. Please fix those failing unit tests

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.Message ID: @.***>

Zyra-V21 avatar Apr 15 '25 16:04 Zyra-V21

please rebase and solve any merge conflicts with next

eyaltoledano avatar May 01 '25 02:05 eyaltoledano

Hi Eyal!

Im so sorry I couldn't still find time for this. Im currently fighting for the future of my career and running many projects at once so I'm OUT of time. BUT ASAP I will have an eye of this, is just about the error-handler back and connect the scripts to the main dev.js logic.

Sorry again for the delay, hope I find you well!

Thanks, Zyra

Enviado con el correo electrónico seguro de Proton Mail.

El jueves, 1 de mayo de 2025 a las 04:22, Eyal Toledano @.***> escribió:

eyaltoledano left a comment (eyaltoledano/claude-task-master#92)

please rebase and solve any merge conflicts with next

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.Message ID: @.***>

Zyra-V21 avatar May 01 '25 14:05 Zyra-V21

Hello guys.

First of all thanks all of you for putting your work into Task Master :)

As this PR adding a crucial element which i am enthusiastically awaiting, i would like to share with you my recent finding in AI PRD generation scene:

CreateMVP

This repo contains interesting approach to PRD generation. Could you imagine some Task-Master <> CreateMVP integration or at least inspiration for future development of your PRD generation workflow?

elvenking avatar May 20 '25 13:05 elvenking

Hi! Any updates on this PR?

mreduar avatar Jul 08 '25 13:07 mreduar

@mreduar this PR was a long time ago, I think we would want to re-do this with our new findings and approach

Crunchyman-ralph avatar Jul 08 '25 13:07 Crunchyman-ralph

Won't be doing a PRD generator in the end, transitioning task-master direction into a task-orchestrator rather than a PRD generator. Had to make a choice, thanks @Zyra-V23 for your efforts, you won't be forgotten!

Crunchyman-ralph avatar Jul 16 '25 16:07 Crunchyman-ralph

@Crunchyman-ralph do you have some recommended approach or set of tools for PRD generation then ? I believe it is still relevant to task-master to at least guide users in some proven direction :)

elvenking avatar Jul 17 '25 07:07 elvenking

Thanks sir! Yup it's been a lot of months and my career has exploded 😞 feel free to take whatever you need from the code ! Hope the best for you guys! 🙏

Won't be doing a PRD generator in the end, transitioning task-master direction into a task-orchestrator rather than a PRD generator. Had to make a choice, thanks @Zyra-V23 for your efforts, you won't be forgotten!

Zyra-V21 avatar Aug 17 '25 05:08 Zyra-V21