aiwfx-record-gap

Records defects as aiwf gap entities with reproduced claims and independent review.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwfx-record-gap-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwfx-record-gap
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded-rituals/plugins/aiwf-extensions/skills/aiwfx-record-gap
Command: npx skills add https://github.com/23min/aiwf --skill aiwfx-record-gap-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a defect surfaces mid-task, it is easy to lose it or file a vague, unverifiable note. This Skill turns a discovered defect into a properly structured aiwf gap entity whose claim is reproduced, reviewed by a fresh-context reviewer, and committed through the aiwf CLI. ## Core Features & Use Cases - Gap triage: Decides whether a finding is actually a gap by consulting .claude/templates/gap.md, and routes misfiled items (e.g., decisions) to the right record type. - Reproduced claims: Drafts each gap body from the template and re-runs the failing command so the What's missing section contains verifiable evidence, not assertions. - Independent batch review: Dispatches a fresh-context reviewer over the uncommitted drafts to re-run reproductions and flag misfiled or unverifiable claims before filing. - Use Case: During a debugging session you notice three unrelated defects. Run this ritual once over the batch: draft each gap from the template, reproduce each claim, have a reviewer verify them, then file each with aiwf add gap and mirror the G-NNNN ids back to the work in flight. ## Quick Start Ask the AI to record the defect you just found as an aiwf gap, reproducing the failure and having it reviewed before filing.

Frequently Asked Questions about aiwfx-record-gap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record a defect as an aiwf gap?

Draft the gap body from .claude/templates/gap.md, reproduce the failing command and paste the result into the What's missing section, have a fresh-context reviewer verify the drafts, then file with aiwf add gap --title and --body-file.

When should I file a gap instead of fixing the defect immediately?

File a gap when a defect surfaces while the work in hand is something else. The gap captures the reproduced claim and gets a stable G-NNNN id, so the current task can continue and the defect is triaged later.

What is the difference between a gap and a decision in aiwf?

The gap template at .claude/templates/gap.md states what earns a gap and what belongs in another record. Items the template classifies as decisions are handed off to the aiwfx-record-decision ritual instead of being filed as gaps.

Why does gap filing require an independent reviewer?

Self-review shares the context that produced the claim, so it misses the same errors. A fresh-context reviewer re-runs the reproduction and returns a record of what it observed, catching wrong claims and misfiled items before commit.

What happens if the gap templates are missing?

If .claude/templates/ is absent, the templates are not materialized and the ritual cannot draft bodies. Run aiwf update to materialize them; never reconstruct a body by copying an existing gap, which drifts from the template.

Can I set a priority when filing an aiwf gap?

Yes, aiwf add gap accepts --priority urgent, high, medium, or low for triage. Priority is triage rather than severity, so the ritual recommends leaving it unset rather than guessing.