Files
calctext/_bmad/bmb/skills/bmad-workflow-builder/assets/quality-report-template.md
2026-03-16 19:54:53 -04:00

6.9 KiB

Quality Report: {skill-name}

Scanned: {timestamp} Skill Path: {skill-path} Report: {report-file-path} Performed By QualityReportBot-9001 and {user_name}

Executive Summary

  • Total Issues: {total-issues}
  • Critical: {critical} | High: {high} | Medium: {medium} | Low: {low}
  • Overall Quality: {Excellent|Good|Fair|Poor}
  • Overall Cohesion: {cohesion-score}
  • Craft Assessment: {craft-assessment}

{executive-narrative}

Issues by Category

Category Critical High Medium Low
Structural {n} {n} {n} {n}
Prompt Craft {n} {n} {n} {n}
Cohesion {n} {n} {n} {n}
Efficiency {n} {n} {n} {n}
Quality {n} {n} {n} {n}
Scripts {n} {n} {n} {n}
Creative {n} {n}

Strengths

What this skill does well — preserve these during optimization:

{strengths-list}


{if-truly-broken}

Truly Broken or Missing

Issues that prevent the workflow/skill from working correctly:

{truly-broken-findings}


{/if-truly-broken}

Detailed Findings by Category

1. Structural

{if-stage-summary} Stage Summary: {total-stages} stages | Missing: {missing-stages} | Orphaned: {orphaned-stages} {/if-stage-summary}

{structural-findings}

2. Prompt Craft

Skill Assessment:

  • Overview quality: {overview-quality}
  • Progressive disclosure: {progressive-disclosure}
  • {skillmd-assessment-notes}

{if-prompt-health} Prompt Health: {prompts-with-config-header}/{total-prompts} with config header | {prompts-with-progression}/{total-prompts} with progression conditions | {prompts-self-contained}/{total-prompts} self-contained {/if-prompt-health}

{prompt-craft-findings}

3. Cohesion

{if-cohesion-analysis} Cohesion Analysis:

Dimension Score Notes
Stage Flow Coherence {score} {notes}
Purpose Alignment {score} {notes}
Complexity Appropriateness {score} {notes}
Stage Completeness {score} {notes}
Redundancy Level {score} {notes}
Dependency Graph {score} {notes}
Output Location Alignment {score} {notes}
User Journey {score} {notes}
{/if-cohesion-analysis}

{cohesion-findings}

{if-creative-suggestions} Creative Suggestions:

{creative-suggestions} {/if-creative-suggestions}

4. Efficiency

{efficiency-issue-findings}

{if-efficiency-opportunities} Optimization Opportunities:

{efficiency-opportunities} {/if-efficiency-opportunities}

5. Quality

{quality-findings}

6. Scripts

{if-script-inventory} Script Inventory: {total-scripts} scripts ({by-type-breakdown}) | Missing tests: {missing-tests-list} {/if-script-inventory}

{script-issue-findings}

{if-script-opportunities} Script Opportunity Findings:

{script-opportunities}

Token Savings: {total-estimated-token-savings} | Highest value: {highest-value-opportunity} | Prepass opportunities: {prepass-count} {/if-script-opportunities}

7. Creative (Edge-Case & Experience Innovation)

Skill Understanding:

  • Purpose: {skill-purpose}
  • Primary User: {primary-user}
  • Key Assumptions: {key-assumptions-list}

Enhancement Findings:

{enhancement-findings}

{if-top-insights} Top Insights:

{top-insights} {/if-top-insights}


{if-user-journeys}

User Journeys

How different user archetypes experience this skill:

{archetype-name}

{journey-summary}

Friction Points: {friction-points-list}

Bright Spots: {bright-spots-list}


{/if-user-journeys}

{if-autonomous-assessment}

Autonomous Readiness

  • Overall Potential: {overall-potential}
  • HITL Interaction Points: {hitl-count}
  • Auto-Resolvable: {auto-resolvable-count}
  • Needs Input: {needs-input-count}
  • Suggested Output Contract: {output-contract}
  • Required Inputs: {required-inputs-list}
  • Notes: {assessment-notes}

{/if-autonomous-assessment}

Quick Wins (High Impact, Low Effort)

Issue File Effort Impact
{quick-wins-rows}

Optimization Opportunities

Prompt Craft: {prompt-optimization-narrative}

Performance: {performance-optimization-narrative}

Maintainability: {maintainability-optimization-narrative}


Recommendations

  1. {recommendation-1}
  2. {recommendation-2}
  3. {recommendation-3}
  4. {recommendation-4}
  5. {recommendation-5}