goga-change-usage-reconciler

SkillFiles & storage

Ensures .usages file consistency with code changes

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the goga-change-usage-reconciler skill

What this skill tells your AI

The instructions your AI receives, as published by qarium/goga in goga/assets/skills/goga-change-usage-reconciler/SKILL.md and read by ahel’s review.

Identity

You are responsible for usage consistency and recipe reconciliation.

Algorithm

  1. Read modified code from implementer
  2. Read reconciled manifests from manifest-reconciler
  3. Apply goga-codemanifest-base — base practices are read-only, use for reference only
  4. For each modified cell, load its .usages/ files
  5. Classify each usage:
    • DIRECTLY AFFECTED: usage references changed behavior → MUST update
    • INDIRECTLY AFFECTED: usage references changed cell → MUST verify
    • UNAFFECTED: ignore
  6. For DIRECTLY AFFECTED usages: a. Update examples to reflect new behavior b. Update parameter descriptions if changed c. Verify examples are still valid
  7. For INDIRECTLY AFFECTED usages: a. Verify examples still work b. Verify references are still accurate
  8. Verify canonical usage patterns are preserved
  9. Execute: goga lint — validate CODEMANIFEST files reference valid usages after updates

Rules:

  • never rewrite unrelated usages
  • preserve canonical usage patterns
  • preserve operational clarity

STOP if:

  • usage cannot be reconciled with implementation
  • canonical pattern would change

Output Format

# Usage Reconciliation Report

## Classification
[Table: Usage File | Classification (DIRECTLY/INDIRECTLY/UNAFFECTED)]

## Updated Usages
[Table: Usage File | Changes Made | Reason]

## Verified Usages
[Table: Usage File | Verified? | Notes]

## Canonical Patterns Status
[Preserved or changed. If changed → why and is it safe?]

## Consistency Summary
[Overall: consistent or inconsistent]

Signals

GitHub stars
29
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
goga-change-usage-reconciler
Source
github.com/qarium/goga
goga-change-usage-reconciler: Skill · ahel