Skip to main content

​
SDLC Quality System - Feature Guide

​
Overview

The SDLC Quality System enforces quality gates across your venture’s entire software development lifecycle. It validates specifications, tracks implementation quality, and ensures every deliverable meets platform standards before advancing. This system protects you from shipping half-baked code and gives you confidence that what you build is production-ready.

​
Step-by-Step Guide

  1. Access Quality Dashboard - Navigate to /developerdashboard to view your current quality metrics and gate status across all active jobs.
  2. Review Quality Checks - For any job, view quality checks via the API endpoint GET /api/v1/quality-check/:id/quality-checks to see which gates are passing or failing.
  3. Generate Specifications - Use /specification/:jobId/specifications/generate to create technical specifications. The system automatically validates them against quality standards.
  4. Review AI Analysis - Check the generated spec at /specreview where the system highlights quality issues, missing requirements, or specification gaps.
  5. Address Quality Issues - Update specifications via PATCH /api/v1/specification/specifications/:specId/data to fix flagged problems.
  6. Confirm and Advance - Once quality gates pass, confirm the specification with POST /api/v1/specification/specifications/:specId/confirm to move forward.
  7. Monitor Implementation Quality - Track ongoing quality during development via /telemetrydashboard to catch issues before they become blocking problems.
  8. Request Quality Certification - Trigger certification with POST /api/v1/quality-certification/certify when implementation is complete.
  9. Review Certification Results - Check certification status at GET /api/v1/quality-certification/status/:jobId to see if your deliverable meets all quality standards.
  10. Access Quality Reports - Download detailed quality reports from /confidencereport showing comprehensive assessment results and recommendations.

​
Common Questions

Q: What happens if my specification fails quality gates?
A: The system flags specific issues preventing progression. Review the quality report, address the flagged items, and resubmit. You cannot advance to implementation until core quality gates pass. Q: Can I override a quality gate if I disagree with the assessment?
A: Yes, but only for specific gates. Use POST /api/v1/pipeline/:jobId/quality-gate/override to request an override. A sherpa or supervisor reviews your justification before approval. Q: How do I know which quality standards apply to my venture stage?
A: Quality requirements adapt to your lifecycle stage. Early-stage ventures face lighter gates focused on clarity. Later stages enforce stricter technical and security standards. Check /api/v1/lifecycle/position to see your current requirements. Q: What’s the difference between quality certification and security certification?
A: Quality certification validates code structure, testing coverage, and specification alignment. Security certification (POST /api/v1/security-certification/certify) specifically audits vulnerabilities, authentication flows, and data protection measures. Q: Can I see how my quality scores compare to other ventures?
A: Yes. Visit /developeranalytics to view peer benchmarks and see where you rank on quality metrics. This shows if you’re meeting, exceeding, or trailing platform standards.

​
Troubleshooting

Issue: Specification keeps failing validation
Check the telemetry dashboard at /telemetrydashboard for detailed error logs. Common causes include missing functional requirements, unclear acceptance criteria, or insufficient technical detail. Use GET /api/v1/telemetry/errors/recent to identify specific validation failures. Issue: Quality certification is stuck in pending status
Certification can take 24-48 hours for complex implementations. Check GET /api/v1/quality-certification/status/:jobId for progress updates. If stuck beyond 48 hours, create a support ticket at /support/tickets with your job ID. Issue: Quality gates changed mid-project
Quality requirements evolve as you advance lifecycle stages. Review GET /api/v1/lifecycle/graduation/criteria to understand new requirements before graduation. Use the pipeline dashboard at /pipelinedashboard to preview upcoming gate changes. Issue: Peer quality scores look wrong
Analytics refresh nightly. If seeing stale data, check GET /api/v1/developer-analytics/overview for last update timestamp. Contact support if data is more than 48 hours old. Specification Management - Generate, review, and iterate on technical specifications with AI assistance. Quality gates integrate directly with spec validation, so improving spec quality directly improves certification success rates. Access via /specification/:jobId/specifications. Testing & Test Plan Generation - Automated test plans derive from your specifications and feed quality metrics. Generate test plans at /api/v1/testing/test-plans/generate/:specId and execute them to improve certification scores. Data Room Quality Analysis - Store and analyze all venture documentation in your data room. The system scans documents for quality gaps and provides AI-powered recommendations. Access gap analysis at GET /api/v1/data-room/:dataRoomId/gap-analysis.