# Loc Guard

> INTERNAL DEV WORKFLOW for WpfHexEditor — Claude self-invokes on two scopes: (1) PARITY — after editing any *.resx (base or satellite), verifies the 28-language satellite parity (missing/orphan keys, placeholder drift, untranslated). (2) SOURCE — after editing *.xaml or *.cs under App/, Editors/, Plugins/, Core/, Controls/, advisory checks for: DynamicResource on loc keys (must be StaticResource), hardcoded user-visible string literals, IdeMessageBox.Show literals, legacy MessageBox.Show usage (ADR-009), and missing LocalizedResourceDictionary wiring (ADR-005). All SOURCE findings are warn-only. Distinct from xaml-guard (which only checks Designer.cs parity for the base resx). Skip on: Themes/, ColorPicker, Designer.cs/g.cs, Tests/, Samples/, pure structural XAML edits.

- Skill: `abbaye/loc-guard` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add abbaye/loc-guard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/abbaye/loc-guard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: abbaye (https://skillmd.com/u/abbaye)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/abbaye/loc-guard

---


# loc-guard (internal)

56 base `*Resources.resx` files × up to 28 satellites. `xaml-guard` covers base↔Designer.cs; this skill covers base↔satellites (Scope 1) and source advisory (Scope 2).

## When I invoke

### Scope 1 — PARITY

| Situation | Run? |
|---|---|
| Edit a base `*Resources.resx` | yes (scan all satellites) |
| Edit a satellite `*.<lang>.resx` | yes (scan against base only) |

### Scope 2 — SOURCE (advisory)

| Situation | Run? |
|---|---|
| Edit `*.xaml` / `*.cs` under `App/`, `Editors/`, `Plugins/`, `Core/`, `Controls/` | yes |
| Edit `Themes/`, `ColorPicker/`, `*.Designer.cs`, `*.g.cs`, `Tests/`, `Samples/` | no |
| Pure structural edit (Grid.Row, Margin), comment/whitespace only | no |

## Pipeline

**Scope 1:** `scripts/loc-parity.ps1 -Files <paths>`
**Scope 2:** `scripts/loc-source-guard.ps1 -Files <paths>` (always exits 0)
Silence a line: `// loc-ignore: <reason>` (CS) or same-line XML comment (XAML). Tune: `data/allowlist.json`.

## Rules

### Scope 1 — parity (blocking)

| Rule | Severity |
|---|---|
| `satellite-missing-key` | error — key in base, absent from satellite |
| `satellite-orphan-key` | error — key in satellite, absent from base |
| `placeholder-mismatch` | error — format-arg drift (`{0}/{1}` base vs `{0}` sat) |
| `untranslated` | warn — satellite value identical to base (non-en-* only) |
| `satellite-malformed` | error — XML parse fails or root != `<root>` |

### Scope 2 — source (advisory)

| Rule | Detects |
|---|---|
| `loc-static-required` | `{DynamicResource <LocKey>}` → must be `StaticResource` |
| `loc-hardcoded-string` | literal in Text/ToolTip/Header/Content/Title (XAML) or `.Text =`/`.Title =` (CS) |
| `loc-idemessagebox-literal` | `IdeMessageBox.Show("literal", …)` — first arg must be a resource key |
| `loc-messagebox-legacy` | `MessageBox.Show(…)` → use `IdeMessageBox` (ADR-009) |
| `loc-locdict-missing` | assembly has `*Resources.resx` but no `LocalizedResourceDictionary` merge (ADR-005) |

## Output

```
Loc AppResources (28 satellites):
  fr-FR  OK     keys=680
  ja-JP  3 missing-key   APP_NewFile_Title, APP_Recent_Header, PA_FilterTitle
  ar-SA  1 placeholder-mismatch  APP_Status_Loading base="{0}/{1}" sat="{0}"
  ru-RU  124 untranslated  (warn)
```

Language matrix auto-detected per assembly by scanning sibling `<base>.<lang>(-<region>)?.resx` files.
Scope 2 exit 0 (advisory); does not translate, generate, or coordinate sub-agents (see `feedback_localization_agent_strategy`).

## Maintenance

- New language added → auto-picked up.
- Renaming a base resx → update all satellites in same commit (orphan files not detected at filesystem level).