Skip to main content

​
Automated Specification Generation

​
Overview

Transform your enhanced brief into a complete technical specification in under 90 seconds. The system analyzes your brief and generates structured requirements, user stories, and acceptance criteria - everything your expert needs to build your feature right the first time. Lock in your requirements before development starts, so you can ship faster with fewer surprises.

​
Step-by-Step Guide

  1. Confirm your enhanced brief - After reviewing your enhanced brief on the Brief Review page (/briefreview), click “Confirm Brief” to trigger automatic specification generation.
  2. Wait for generation - The system generates your specification in under 90 seconds. You’ll see a progress indicator while the platform extracts functional requirements, creates user stories, and defines success criteria from your brief.
  3. Review the specification - Once complete, navigate to the Spec Review page (/specreview) to see your full specification. Review each section: Feature Title, User Stories with priorities (P1, P2, P3), Functional Requirements (FR-001, FR-002, etc.), Success Criteria, Key Entities, Assumptions, and Dependencies.
  4. Flag sections for clarification - If you find ambiguous requirements or missing details, click on specific sections to flag them. Add comments explaining what needs clarification.
  5. Request regeneration - Submit your clarification feedback. The system regenerates the specification incorporating your input, typically within 90 seconds.
  6. Confirm the specification - When satisfied with all sections, click “Confirm Specification”. This locks the spec, updates your job status to “awaiting_allocation”, and moves your project forward to expert matching.
  7. Track version history - Access PRD Version History (/prdversionhistory) to see all specification versions, compare changes between versions, and verify which version is active.

​
Common Questions

How complete does my brief need to be before generating a specification?
Your enhanced brief should contain clear goals and basic feature descriptions. If the system detects insufficient detail, it generates a partial specification with placeholders and flags missing sections for you to fill in before confirmation. Can I modify the specification after my expert is allocated?
Yes, but any changes require re-confirmation from your allocated expert. If changes are significant, your expert can decline and trigger a re-matching process. All modifications create new versions with full change tracking. What happens if the specification contains contradictory requirements?
The system flags contradictions explicitly in the generated spec and requests your resolution before allowing confirmation. Review flagged sections and clarify which requirement takes priority. How do I know my specification meets quality standards?
Every generated spec undergoes automatic quality validation checking for: all mandatory sections present, testable requirements, measurable success criteria, and acceptance scenarios for each user story. Specs passing all checks display a “Quality Verified” badge. What if specification generation fails?
The system automatically retries up to 3 times. If all attempts fail, you receive a notification and the platform creates a support ticket. Your job remains in the current state until the issue resolves.

​
Troubleshooting

Generation takes longer than 90 seconds
Complex briefs with multiple features may take slightly longer. If generation exceeds 3 minutes, refresh the page and check your job status. Contact support if the status shows “generation_failed”. Specification sections appear empty or malformed
Quality validation should reject incomplete specs automatically and trigger regeneration. If you see empty sections in a confirmed spec, use the “Flag for Clarification” option to request a fix, or contact support for immediate assistance. Unable to confirm specification after multiple regenerations
Review the quality validation warnings displayed with your spec. Address each flagged issue before attempting confirmation. If warnings persist after addressing feedback, the brief may need more detail before generating a viable spec. Changes needed after expert allocation
Navigate to Spec Review (/specreview), make your edits, and submit for re-confirmation. Your expert receives a notification and must approve changes. Track approval status in the Planning Review (/planningreview) dashboard. Enhanced Brief Review - Before specification generation, complete your enhanced brief review to ensure the system has sufficient detail to generate quality requirements. Better brief input produces better specifications. PRD Dashboard - After specification confirmation, access the PRD Dashboard (/prddashboard) to track how your requirements decompose into implementation tasks and maintain traceability throughout development. Planning Review - Once your expert is allocated, use Planning Review (/planningreview) to collaborate on specification refinements and approve planning artifacts before development begins.