tst-claude-code-samples/.claude/commands/planning/1-mrd/3-generate-mrd-document.md

allowed-tools, description

allowed-tools	description
Read Write Glob	Generates the final MRD document by consolidating all research and analysis from a session.

Generate MRD Document

Context

• User Request: $ARGUMENTS
• Session Name/Index: Passed via --name argument.
• All Session Files: All 0*_*.md (user research) and _summary_*.md (AI analysis) files within the target session directory.

Goal

To synthesize all research findings and AI-generated analyses from a completed MRD session into a single, coherent, and well-structured Market Requirements Document (MRD).

Process

1. Identify Target Session:

   • Use the --name argument to locate the correct session directory.

2. Aggregate All Session Data:

   • Read the content of all user research files (0*_*.md) within the directory.
   • Read the content of all AI-generated summary files (_summary_*.md).

3. Synthesize and Structure Content:

   • Comprehensively analyze the aggregated information.
   • Logically map the findings to the standard sections of an MRD template (e.g., Market Problem, Target Audience, Competitive Landscape, Requirements).
   • Rewrite and rephrase the content to ensure a consistent tone and narrative flow throughout the document.

4. Generate Final MRD File:

   • Create the final document named mrd_[session_name].md.
   • Populate it with the structured, synthesized content.

5. Finalize Session State:

   • Update the _session-state.json file by setting the status to finalized. This marks the session as complete.

6. Notify User and Suggest Next Step:

   • Inform the user that the MRD document has been successfully generated and provide the file path.
   • Proactively suggest the next logical step in the SDLC, which is to define a product roadmap.
   • Example: "Your MRD is complete. Would you like to proceed with defining the product roadmap using /planning/roadmap/1-define-roadmap?"

Example Usage

• Generate MRD for a session: /planning/mrd/3-generate-mrd-document --name="mvp-launch"
• Generate by index: /planning/mrd/3-generate-mrd-document --name="1"