From a9cb7cdf7936e9d7bfed5dbb5b49ea0d5d8ba6e7 Mon Sep 17 00:00:00 2001 From: John Lambert Date: Fri, 21 Aug 2026 11:56:40 -0400 Subject: [PATCH] Repoint nine skill references that resolved from nowhere Nine cross-references in the Avalonia migration and WinApp skills were written relative to the skill root while the citing file lives inside references/, so they resolved to references/references/.md and pointed at nothing. Every target exists; only the paths were wrong. Seven become plain sibling names, which is what a file inside references/ needs to reach the file next to it. Two genuinely cross skill boundaries and become repo-root paths: winforms-avalonia-parity cites parity-evidence in the migration skill, and architecture-patterns cites style-system in the Avalonia UI skill. Nothing else changed. No prose, no guidance, no file moved or renamed. Verified by resolving every reference in every .claude markdown file from the directory it is written in: nine dangling before, none after. Co-Authored-By: Claude Opus 5 --- .../fieldworks-winapp/navigation/winforms-avalonia-parity.md | 2 +- .claude/skills/fieldworks-winapp/references/research.md | 2 +- .../references/architecture-patterns.md | 2 +- .../references/control-exemplar-map.md | 2 +- .../references/lessons-learned.md | 4 ++-- .../references/migration-checklist.md | 4 ++-- 6 files changed, 8 insertions(+), 8 deletions(-) diff --git a/.claude/skills/fieldworks-winapp/navigation/winforms-avalonia-parity.md b/.claude/skills/fieldworks-winapp/navigation/winforms-avalonia-parity.md index 4bcc24c8a4..90d696e715 100644 --- a/.claude/skills/fieldworks-winapp/navigation/winforms-avalonia-parity.md +++ b/.claude/skills/fieldworks-winapp/navigation/winforms-avalonia-parity.md @@ -17,7 +17,7 @@ a dialog, a browse table. The WinForms side needs the live app (this skill); the - A project with the relevant data (e.g. Words ▸ Analyses parity needs **parsed wordform analyses** — a bare project shows an empty interlinear). Restore per `project-loading.md`. - Evidence folders and parity-bundle naming: see `screenshot-evidence.md` (canonical parity - layout defined in the migration skill's `references/parity-evidence.md` §6). + layout defined in the migration skill's `.claude/skills/fieldworks-winforms-to-avalonia-migration/references/parity-evidence.md` §6). ## The two captures diff --git a/.claude/skills/fieldworks-winapp/references/research.md b/.claude/skills/fieldworks-winapp/references/research.md index 7d50737a67..03644c587e 100644 --- a/.claude/skills/fieldworks-winapp/references/research.md +++ b/.claude/skills/fieldworks-winapp/references/research.md @@ -51,7 +51,7 @@ sequence, cues, and safety notes to perform that route. - One reusable navigation destination or workflow per `navigation/*.md` file. - Shared safety and triggering rules stay in `SKILL.md`. -- Skill maintenance rules stay in `references/how-to-update.md`. +- Skill maintenance rules stay in `how-to-update.md`. - Research rationale stays in this file so future edits can revisit the design without bloating the active route instructions. diff --git a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/architecture-patterns.md b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/architecture-patterns.md index 29ba03d9d8..7d61375935 100644 --- a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/architecture-patterns.md +++ b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/architecture-patterns.md @@ -367,7 +367,7 @@ delta in the region manifest). > intentionally diverge. The visual-parity evidence type therefore checks > density/layout, not pixel-for-pixel appearance. The density tokens and > per-view border/font rules that this parity is measured against live in -> `fieldworks-avalonia-ui/references/style-system.md`, even where styling +> `.claude/skills/fieldworks-avalonia-ui/references/style-system.md`, even where styling > intentionally diverges. **Canonical code.** `Src/Common/FwAvalonia/FwAvaloniaDensity.cs`; diff --git a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/control-exemplar-map.md b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/control-exemplar-map.md index 1fa613fc38..80762f0351 100644 --- a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/control-exemplar-map.md +++ b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/control-exemplar-map.md @@ -80,7 +80,7 @@ headless tests), and then PROMOTES it: citations. 2. Add a numbered subsection to dialog-conversion.md (the §2c/§2d shape: what the legacy behavior was, the shared design, the test names). -3. Record any surprise in `references/lessons-learned.md` per its update +3. Record any surprise in `lessons-learned.md` per its update protocol. Until a gap's exemplar exists, conversions that need it stay on the Legacy diff --git a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/lessons-learned.md b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/lessons-learned.md index c7662b1bff..81b3f20fc1 100644 --- a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/lessons-learned.md +++ b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/lessons-learned.md @@ -248,8 +248,8 @@ requirements it fed are synced to `openspec/specs/lexical-edit-parity-automation `xWorksTests` (~1400 tests share the host); the restored test base holds the undoable task open (no nested `NonUndoableUnitOfWorkHelper`); `OnChangeFilter` takes an (added, removed) delta that `RecordList` composes into its `AndFilter`. -- Skill files changed: `references/architecture-patterns.md` (§13), - `references/parity-evidence.md` (§2a, §3), `references/migration-checklist.md` +- Skill files changed: `architecture-patterns.md` (§13), + `parity-evidence.md` (§2a, §3), `migration-checklist.md` (Phase 7), `SKILL.md` (quick map + workflow step 7), this ledger. ### 2026-06 — Lexical Edit (full entry view), phases 1–2 (seed entry) diff --git a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/migration-checklist.md b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/migration-checklist.md index e312758cfd..c5b5cdec1d 100644 --- a/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/migration-checklist.md +++ b/.claude/skills/fieldworks-winforms-to-avalonia-migration/references/migration-checklist.md @@ -47,7 +47,7 @@ Use this when collapsing a large multi-view derisk branch into a landable PR (se ## Phase 3 — Seams - [ ] Existing seams reused from `Src/Common/FwAvalonia/Seams/` -- [ ] Any new seam added to `references/seam-catalog.md` with purpose, +- [ ] Any new seam added to `seam-catalog.md` with purpose, rules, and pivot trigger - [ ] No region code reaches directly into PropertyTable/mediator/LCModel outside a seam @@ -125,7 +125,7 @@ Use this when collapsing a large multi-view derisk branch into a landable PR (se ## Phase 10 — Retrospective (updates this skill set) - [ ] New patterns/gotchas/pivots recorded per the protocol in - `references/lessons-learned.md` + `lessons-learned.md` - [ ] New plugins added to the canonical examples in architecture-patterns.md §5 - [ ] Stale file pointers in any fieldworks-* skill fixed