quality-advisor
Quality-advisor gives live feedback while you create or review SDD documents, catching completion gaps, documentation anti-patterns, tag compliance, and naming issues before submission. It scores sections, detects common problems like missing traceability or broken links, validates cumulative tagging across layers, and returns actionable recommendations to fix issues.
Quality-advisor provides real-time quality feedback during SDD artifact authoring to catch issues before completion.
AI-generated summary based on this skill's SKILL.md
Install
vladm3105/aidoc-flow-framework/quality-advisor · repository language: Python
git clone https://github.com/vladm3105/aidoc-flow-framework
cp -r aidoc-flow-framework/platforms/claude-code-plugin/skills/quality-advisor ~/.claude/skills/quality-advisorFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does quality-advisor do for SDD document quality?
Quality-advisor gives live feedback while you create or review SDD documents, catching completion gaps, documentation anti-patterns, tag compliance, and naming issues before submission. It scores sections, detects common problems like missing traceability or broken links, validates cumulative tagging across layers, and returns actionable recommendations to fix issues.
Can quality-advisor detect anti-patterns in my documentation?
Yes. Quality-advisor detects and flags documentation anti-patterns before submission, including placeholder text, vague criteria, missing traceability, and broken links. It identifies these issues in real time as you author, so you can fix them immediately rather than waiting for formal validation.
How does quality-advisor validate SDD section requirements?
Quality-advisor validates section completion and template compliance by checking that all required sections are present and properly filled. It also verifies naming conventions for document IDs, checks document control and traceability tags, and validates cumulative tagging requirements across artifact layers.
What real-time feedback on artifact completion does quality-advisor provide?
Quality-advisor offers in-the-moment SDD feedback as you write, scoring sections and flagging gaps in completion. It identifies missing sections, incomplete fields, and compliance deviations so you can address them during authoring rather than discovering them during formal review.
Does quality-advisor check naming and traceability requirements?
Yes. Quality-advisor validates artifact naming and IDs against conventions, checks document control and traceability tags, and ensures cumulative tagging compliance. It catches naming issues and traceability gaps early, helping you meet all documentation standards before submission.
Can I use quality-advisor to review artifacts before formal validation?
Absolutely. Quality-advisor is designed for pre-submission review, catching documentation issues before formal validation processes. It provides comprehensive quality guidance during authoring and a final review pass to ensure your SDD artifact meets all requirements and standards.
SKILL.md
rendered from the published skill — quoted content, verbatim
quality-advisor
Purpose
Give proactive, in-the-moment quality guidance while an SDD artifact is being written, so issues are caught during creation instead of at post-creation validation. It scores section completion, detects documentation anti-patterns, checks cumulative tagging, and validates naming — then returns actionable recommendations.
When to Use
Use quality-advisor when:
- Authoring a new artifact and wanting live feedback.
- Reviewing an artifact before submission.
- Checking template-requirement, tag, or naming compliance for one document.
Do not use it for full bidirectional traceability or whole-project
validation (use ../doc-validator/SKILL.md), or non-SDD
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
platforms/claude-code-plugin/skills/quality-advisor/SKILL.md