Hybrid Enhancement for FSD/TSD Generation
Overview
Every solution design your project generates now passes through automated validation and refinement before you see it. The system checks five quality dimensions, fixes gaps automatically, and delivers a certificate showing exactly how implementation-ready your design is. You ship faster because the platform catches issues before human review - no more back-and-forth on missing requirements or vague specifications.Step-by-Step Guide
- Generate your solution design - Complete your BRS/FRS/TRS documents and trigger FSD or TSD generation through the pipeline dashboard. The system starts validation automatically.
- Review your quality certificate - Within 90 seconds, you receive a grade (A-F) with scores across architecture, traceability, feasibility, completeness, and clarity. The certificate appears alongside your FSD or TSD document.
- Check the audit trail - If the system ran multiple refinement passes, the certificate shows what it found and fixed in each iteration. You see exactly what changed and why.
- Verify requirement links - Every design element traces back to its source requirement. Click through the traceability view to confirm nothing’s missing and nothing’s unbacked.
- Flag issues for review - If the certificate shows concerns the system couldn’t resolve (feasibility risks, conflicting requirements), those appear as flagged items ready for your Sherpa or expert input.
Common Questions
What happens if my source requirements have quality issues?The system proceeds with generation but warns you in the certificate. Your FSD/TSD will document that the source quality limited what the validation could achieve. Fix the source specs and regenerate for better results. Can the system fix everything automatically?
It runs up to three refinement passes. If it can’t hit 80% quality after three tries, it saves the best version and flags remaining issues for human review. You still get a working design - just with documented limitations. How do I know if my design is implementation-ready?
Check the overall grade. A or B means proceed with confidence. C means review flagged concerns with your team. D or F means significant gaps remain - address those before expert matching. What if validation times out during refinement?
The system saves the best version it achieved and generates a partial certificate noting the timeout. You can review what’s there and decide whether to regenerate or proceed with manual fixes. Does this replace Sherpa review?
No. This catches structural and completeness issues automatically. Your Sherpa still reviews for business logic, strategic fit, and context the AI can’t assess. You get both - faster automation plus expert judgment.
Troubleshooting
Certificate shows “conflicting requirements” flagOpen the traceability view to see which requirements conflict. The system attempted resolution but couldn’t decide between competing needs. Update your FRS/TRS to clarify priorities, then regenerate. Quality score stuck below 80% after three passes
Check the audit trail for recurring issues. If the system keeps flagging the same problems, your source specifications likely need strengthening. Add detail to BRS/FRS/TRS and trigger a fresh generation cycle. Missing traceability links in my TSD
The TSD should map every technical component back to an FSD element. If links are missing, the FSD may lack detail. Enhance your FSD first, confirm it, then regenerate the TSD with stronger source material. Feasibility risk score seems wrong
The system flags complexity and technology mismatches based on your project scope. Review the specific concerns listed. If you disagree, document your reasoning and proceed - the flag ensures you’ve considered the risk.