GuidesEnd-to-End Workflow
This guide walks you through the complete Software Factory workflow, from initial product idea to user validation and feedback integration.
The Software Factory workflow creates a continuous loop where user feedback drives product evolution:
Idea → Refinery → Foundry → Planner → Assembler → Validator → Back to Refinery
Start in Refinery - Navigate to the Refinery module
Upload Artifacts - Add design sketches, requirements docs, or audio recordings
Draft PRD - Use the AI agent to expand your ideas into a comprehensive Product Requirements Document
Create UI Mocks - Switch to UI Mocker to visualize your product with HTML prototypes
Extract Features - Generate Feature Nodes from your PRD for the next phase
Generate multiple UI variations with the UI Mocker
Gather stakeholder feedback on both PRD and UI prototypes
Refine requirements based on visual feedback
Version control your PRD as it evolves
Select Template - Choose a Blueprint template that matches your project type
Populate Sections - Use AI assistance to fill in general architecture and feature-specific sections
Link to Codebase - If your repo is indexed, pull in existing patterns and conventions
Review and Refine - Ensure all Feature Nodes have detailed implementation guidance
Verify that all requirements have corresponding technical specifications
Check that implementation plans align with your existing codebase
Ensure Feature Nodes are properly organized and prioritized
Auto-Generate - Use “Create with AI” to convert Blueprint sections into Work Orders
Manual Creation - Add any additional tasks not captured automatically
Assign Ownership - Distribute Work Orders among team members
Plan Iterations - Use the Iteration Planning Agent to organize work into sprints
Review and refine AI-generated implementation plans
Ensure Work Orders are properly linked to Blueprint sections
Set up tracking and monitoring for progress
Connect Coding Agent - Set up MCP connection with Cursor or other coding agents
Organize Workflow - Drag and drop Work Orders into your preferred sequence
Execute Tasks - Let your coding agent work through the implementation plans
Track Progress - Monitor completion status in real-time
Review AI-generated code for quality and adherence to specifications
Test implementations against requirements
Update Work Order status as tasks complete
Deploy Changes - Release your completed features to users
Collect Feedback - Use Validator’s API to capture user reports and issues
Analyze Patterns - Review feedback in the Validator Inbox
Generate New Tasks - Convert feedback into actionable Work Orders
Prioritize feedback-based improvements
Update PRDs and Blueprints based on real-world usage
Plan next iteration with validated requirements
The workflow doesn’t end with validation. Use insights from Validator to:
Update PRDs - Incorporate user feedback into product requirements
Refine Blueprints - Adjust technical specifications based on real usage
Generate New Work Orders - Create tasks for improvements and fixes
Repeat the Cycle - Continue building and validating
Keep PRDs, Blueprints, and Work Orders in sync
Update documentation as requirements evolve
Maintain clear ownership and responsibility assignments
Review AI-generated content at each phase
Test implementations thoroughly before validation
Document decisions and rationale for future reference
Use the feedback mechanisms in each module
Maintain clear communication channels
Regular sync meetings to review progress and blockers
Skipping Phases - Don’t jump from PRD directly to coding
Ignoring Feedback - Always incorporate user insights
Poor Documentation - Keep all artifacts up to date
Scope Creep - Stick to defined requirements and iterate
Clear, actionable Work Orders
Consistent progress through all phases
Positive user feedback and engagement
Reduced development time and rework
In-Product Feedback - Use the feedback button in each module
Documentation - Keep comprehensive records of decisions
Team Communication - Regular sync meetings and updates
External Tools - Integrate with your existing development tools
Ready to start your first workflow? Begin with Installation & Setup →
