GAAI-framework remediate-failures
Correct failures, rule violations, and acceptance criteria gaps detected during QA review. Activate when qa-review returns FAIL. Fixes without redefining scope — loops until all quality gates pass.
install
source · Clone the upstream repo
git clone https://github.com/Fr-e-d/GAAI-framework
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Fr-e-d/GAAI-framework "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.gaai/core/skills/delivery/remediate-failures" ~/.claude/skills/fr-e-d-gaai-framework-remediate-failures && rm -rf "$T"
manifest:
.gaai/core/skills/delivery/remediate-failures/SKILL.mdsource content
Remediate Failures
Purpose / When to Activate
Activate when:
- QA review returns FAIL
- Acceptance criteria are unmet
- Rules are violated
- Regressions are detected
- Implementation deviates from governed artefacts
Process
- Identify all failures precisely from the QA report
- Map each failure to: acceptance criteria / rule violated / implementation section
- Determine minimal corrective changes
- Apply fixes without expanding scope
- Re-validate against Story criteria and rules
- Prepare updated inputs for QA re-run
Loop: Detect → Correct → Re-validate → repeat until PASS.
Convergence / Escalation: If re-validation does not pass after 3 attempts, or if a fix requires changing acceptance criteria or product intent, STOP. Mark the story as
failed and escalate to Discovery with a remediation report listing: what was attempted, what failed, and why convergence was not possible.
Remediation Principles
- Fix the cause, not the symptom
- Minimal change preferred
- Never broaden scope
- Never reinterpret requirements
- Respect architecture constraints
- Preserve maintainability
Output
- Corrected implementation
- Remediation notes:
- What failed
- What was fixed
- Why it now passes
- Updated inputs for QA re-validation
Quality Checks
- All acceptance criteria satisfied
- No rule violations remain
- QA review will pass
- Scope unchanged
- Code remains clean
Non-Goals
This skill must NOT:
- Add new features
- Reinterpret product intent
- Weaken rules
- Bypass quality gates
- Silently ignore failures
If a fix requires changing product intent or scope: STOP. Escalate back to Discovery. Remediation is correction — not redesign.