vladm3105/aidoc-flow-framework
Overview
This skill runs a single BRD audit workflow that executes a structural validator then a semantic reviewer and emits one combined audit report optimized for an automated fixer. It provides a clear pass/fail gate and a normalized fix queue so fix automation or manual triage can proceed reliably. Use it to simplify BRD quality checks in CI or pre-PR validation.
How this skill works
The skill runs doc-brd-validator first to check schema and template compliance, then doc-brd-reviewer to score content quality and alignment. Findings from both tools are normalized, merged, and formatted into a single BRD-NN.A_audit_report_vNNN.md containing summary, score calculation, validator and reviewer findings, diagram contract results, and a fix queue. If auto-fixable items exist, it can hand off the combined report to doc-brd-fixer.
When to use it
- You want a single user-facing command to run BRD quality gates
- You need a combined report as input to doc-brd-fixer
- Running CI or manual QA before PRD generation
- Validate both structure and content together before stakeholder review
- You need standardized fix metadata for automation
Best practices
- Run against the canonical BRD path (docs/01_BRD/BRD-NN_*/...) to ensure links and sections resolve
- Use the default reviewer threshold (90) or set a project-specific threshold explicitly
- Enable diagram contract checks when diagrams are required; use strict mode only when agreed across the team
- Ensure BRD files include recommended tags (e.g., @diagram: c4-l1, dfd-l0) and intent headers for better findings
- Review the Fix Queue output fields (source, code, severity, action_hint, confidence) before auto-fixing
Example use cases
- CI pipeline step that gates PRs containing BRD changes and blocks merges on FAIL
- Pre-release QA to produce a combined audit report for engineers and product owners
- Automated fix cycle: run audit, then hand report to doc-brd-fixer to apply auto_fixable fixes
- Manual triage: generate a single report for reviewers to assign follow-up work
- Project onboarding: validate a legacy BRD and generate a prioritized fix queue
FAQ
PASS requires validator PASS, reviewer score >= threshold (default 90), and no blocking issues. Any validator fail, reviewer score below threshold, or blocking/manual-required issue yields FAIL.
What format does doc-brd-fixer expect?
doc-brd-fixer accepts the combined BRD-NN.A_audit_report_vNNN.md (and legacy BRD-NN.R_review_report_vNNN.md). If both exist, the fixer should prefer the newest timestamp.
27 skills
This skill runs BRD validator and reviewer, then compiles a single audit report optimized for doc-brd-fixer integration.
This skill runs validator and reviewer then merges results into a single audit report for fixer-ready output.
This skill runs validator and reviewer in a single BDD audit, producing a unified report for fixer consumption and streamlined QA.
This skill performs AI-powered PR reviews with inline comments, acceptance criteria verification, and optional fix-and-verify loops to streamline governance.
This skill automates EARS generation from PRD documents, validates readiness, categorizes requirements, and ensures BDD-ready coverage for downstream artifacts.
This skill automatically applies fixes to PRD documents based on latest review reports, improving structure, links, IDs, and content iteratively.
This skill performs comprehensive content review and quality assurance for EARS documents, evaluating syntax, PRD alignment, testability, and actionable issues.
This skill generates AI-structured TASKS from SPEC and TSPEC documents, producing CODE-Ready tasks with traceability and quality feedback.
This skill analyzes review reports and automatically fixes REQ documents, ensuring structure, links, IDs, and content improve iteratively.
This skill generates implementation-ready YAML SPECs from REQ/CTR inputs and provides TASKS-Ready scoring for rapid SPEC validation.
This skill automatically reads the latest review report and applies fixes to CTR documents, aligning structure, links, IDs, and content.
This skill performs in-depth TSPEC content review, verifying test coverage, SPEC alignment, and identifies issues requiring manual follow-up.
This skill automates CTR generation from REQ specifications, producing dual-file markdown and yaml contracts with ready-to-use validation and traceability.
This skill performs comprehensive SYS content review to verify ADR alignment, quality attribute coverage, and interface completeness for reliable REQ
This skill automatically generates and validates TSPEC from SPEC documents for UTEST, ITEST, STEST, and FTEST with TASKS-Ready scoring.
This skill performs comprehensive ADR content review, validating decision completeness, BRD alignment, and consequence coverage to ensure high-quality
This skill performs comprehensive SPEC content review, validating REQ coverage, interface completeness, and drift detection to ensure readiness for TASKS and
This skill automates BRD generation from reference docs or prompts, validates readiness, and manages indexing and parallel execution for streamlined planning.
This skill automates fixing SPEC documents by reading review reports and applying structured corrections across structure, links, IDs, and content.
This skill generates ADR-ready BDD scenarios from EARS requirements, validates readiness scores, and categorizes outcomes to accelerate documentation.
This skill validates TSPEC documents against Layer 10 standards, ensuring structure, tagging, naming, and traceability meet compliance.
This skill automates atomic REQ generation from SYS requirements, decomposing into multiple REQ files with SPEC-Ready and IMPL-Ready scoring.
This skill automatically applies fixes to TASKS documents from review reports, ensuring structure, links, and IDs are corrected for iterative quality
This skill helps you create Layer 10 TSPEC documents by integrating upstream artifacts, templates, and traceability for robust unit, integration, smoke, and
This skill fixes SYS documents by applying review reports to correct structure, links, IDs, and content through automated iterative improvements.
This skill automatically fixes TSPEC docs by applying review insights to structure, links, element IDs, and content in iterative cycles.
This skill reviews CTR documents for cross-file consistency, OpenAPI compliance, and upstream alignment, delivering a final QA score and actionable issue list.
