Criticality-Confidence System Skill
Purpose
This Skill provides comprehensive guidance on the criticality-confidence classification system used by all checker and fixer agents in the repository.
When to use this Skill:
- Implementing checker agents (categorizing findings)
- Implementing fixer agents (assessing confidence, determining priority)
- Processing audit reports
- Understanding priority execution order (P0-P4)
- Working with dual-label patterns (verification + criticality)
- Writing standardized audit reports
Core Concepts
See Core Concepts for the two orthogonal dimensions (criticality and confidence) and their four/three levels respectively.
Criticality × Confidence Priority Matrix
See Priority Matrix for the P0-P4 decision matrix and the fixer's strict execution order.
Checker Agent Responsibilities
See Checker Responsibilities for the criticality decision tree, the standardized audit report format, and the dual-label pattern (verification + criticality) used by five agents.
Fixer Agent Responsibilities
See Fixer Responsibilities for the re-validation process, confidence assessment steps, priority-based execution code patterns, and the fix report format.
False Positives and Domain-Specific Examples
See False Positives and Domain Examples for the false-positive report format and worked criticality examples across repo-governance, ayokoding-web, and documentation domains.
Common Patterns
See Common Patterns for three worked examples: checker categorizing a finding, fixer assessing confidence, and a dual-label finding.
Best Practices and Common Mistakes
See Best Practices and Common Mistakes for role-specific DO/DON'T guidance and the four most common classification mistakes.
Creating Domain-Specific Confidence Examples
Fixer agents should include domain-specific examples of HIGH/MEDIUM/FALSE_POSITIVE confidence assessments to guide re-validation decisions. See Purpose and Template, Examples by Agent Family (docs-fixer, readme-fixer, docs-tutorial-fixer), and Guidelines and Anti-Patterns for placement and quality bar.
References
Primary Conventions:
- Criticality Levels Convention - Complete criticality system
- Fixer Confidence Levels Convention - Complete confidence system
Related Conventions:
- Repository Validation Methodology - Standard validation patterns
- Maker-Checker-Fixer Pattern - Three-stage workflow
Related Skills:
repo-applying-maker-checker-fixer- Understanding three-stage workflowdocs-validating-factual-accuracy- Verification label system
Related Agents:
All checker agents and fixer agents use this system. See .claude/agents/README.md for the complete catalog.
This Skill packages the critical criticality-confidence classification system for maintaining consistent quality validation and automated fixing. For comprehensive details, consult the primary convention documents.