# Goga Change Usage Reconciler

> Ensures .usages file consistency with code changes

- Skill: `qarium/goga-change-usage-reconciler` (Agent Skill)
- Install (CLI): `npx skillmds@latest add qarium/goga-change-usage-reconciler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qarium/goga-change-usage-reconciler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: qarium (https://skillmd.com/u/qarium)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qarium/goga-change-usage-reconciler

---

# goga-change-usage-reconciler

## 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

```md
# 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]
```