Agent skill

doc-stest-audit

Unified STEST audit wrapper that runs validator then reviewer and emits combined report for fixer workflows

View SKILL.md on GitHub Repository
Stars 10
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-stest-audit

Metadata

Additional technical details for this skill

tags
sdd-workflow layer-10-artifact quality-assurance stest-audit
custom fields 
{
    "layer": 10,
    "version": "1.0",
    "priority": "primary",
    "last_updated": "2026-02-27",
    "artifact_type": "STEST",
    "skill_category": "quality-assurance",
    "development_status": "active",
    "upstream_artifacts": [
        "STEST"
    ],
    "downstream_artifacts": [
        "Audit Report",
        "Fix Cycle"
    ],
    "architecture_approaches": [
        "ai-agent-based"
    ]
}
versioning policy
tracks STEST-MVP-TEMPLATE schema_version

SKILL.md

doc-stest-audit

Purpose

Run a single STEST audit workflow:

  1. doc-stest-validator
  2. doc-stest-reviewer

Then emit a combined fixer-ready report.

Output Contract

Primary output:

  • STEST-NN.A_audit_report_vNNN.md

Fixer compatibility:

  • doc-stest-fixer accepts .A_ (preferred) and .R_ (legacy-compatible).

Combined Status Rules

  • PASS: validator PASS AND reviewer score = 100 AND no blocking/manual-required issues
  • FAIL: validator FAIL OR reviewer score < 100 OR blocking/manual-required issues present

Deployment-gate policy:

  • Timeout budget violations, missing rollback procedures, missing 100%-gate markers, or non-binary pass/fail criteria are manual_required or blocked and cannot auto-pass.

Combined Report Sections

  1. Summary
  2. Score Calculation
  3. Validator Findings
  4. Reviewer Findings
  5. Coverage Findings
  6. Deployment Gate Findings
  7. Fix Queue (auto_fixable, manual_required, blocked)
  8. Recommended Next Step

Handoff Rule

If remediation needed:

  • Run doc-stest-fixer with newest report.
  • On timestamp/version tie, prefer .A_ over .R_.

Example

bash
/doc-stest-audit docs/10_TSPEC/STEST/STEST-01_scope/STEST-01_scope.md

Version History

Version Date Changes
1.0 2026-02-27 Initial STEST audit wrapper with validator->reviewer orchestration and strict 100% deployment-gate pass contract

Implementation Plan Consistency (IPLAN-004)

  • Treat plan-derived outputs as valid source mode and verify intent preservation from implementation plan scope/objectives.
  • Validate upstream autopilot precedence assumption: --iplan > --ref > --prompt.
  • Flag objective/scope conflicts between plan context and artifact output as blocking issues requiring clarification.
  • Do not introduce legacy fallback paths such as docs-v2.0/00_REF.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vladm3105/aidoc-flow-framework

doc-spec-reviewer

Comprehensive content review and quality assurance for SPEC documents - validates YAML structure, REQ coverage, interface definitions, and identifies issues requiring manual attention

10 3
Explore
vladm3105/aidoc-flow-framework

doc-prd-fixer

Automated fix skill that reads review reports and applies fixes to PRD documents - handles broken links, element IDs, missing files, and iterative improvement

10 3
Explore
vladm3105/aidoc-flow-framework

doc-procspec-autopilot

Automated PROCSPEC (Process Specification) generation from REQ - generates specifications for SOPs, runbooks, playbooks, and operational procedures

10 3
Explore
vladm3105/aidoc-flow-framework

doc-riskspec-autopilot

Automated RISKSPEC (Risk Specification) generation from REQ - generates specifications for risk matrices, impact assessments, and mitigation plans

10 3
Explore
vladm3105/aidoc-flow-framework

doc-ptest-autopilot

Automated PTEST generation and review orchestration for performance category and threshold validation

10 3
Explore
vladm3105/aidoc-flow-framework

doc-adr-autopilot

Automated ADR generation pipeline from BRD Architecture Decision Requirements - analyzes topics, generates Context-Decision-Consequences records

10 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results