skills-integrity: vault-path reference doctrine lands in its owner (F28 vault half)

[aarontrowbridge]

What

The vault half of F28: the vault-path reference doctrine now lives in its owner — one section in amico-vault's mount rules (the vault constitution), not scattered as convention.

Landed section — packages/extension/skills/amico-vault/SKILL.md, new ### Vault-path references (role, not name) under Mounts & resolution:

1. Personal mount by ROLE — "the personal vault", resolved from the mount stack — never by its directory or marker name.
2. Team mount by KIND — "the team mount"; armonissima may appear in an example, labeled as an instance, never as the identifier.
3. Ops tree only as $AMICO_OPS/….
4. Never a raw home path embedding a vault or repo name in prose or examples — proof case cited: the 2026-08-21 personal-vault rename (vault-aaron → armonia-aaron-trowbridge), whose aftermath (clients silently riding the rename redirect) is exactly the silent rot the rule prevents.

Plus a closing note that the skills lint's [vpath] rule (#1100, in flight — the lint half of F28) enforces the known-rotted shapes mechanically.

Why this shape

• The doctrine text was drafted in armonissima PR build(deps-dev): bump the dev-dependencies group across 1 directory with 5 updates #98 (Cast O) and held without a home — that PR itself concluded the product amico-vault card is the owner, vault-side PRs cannot carry it.
• Shipped product content (surface: public): the section reads as product documentation — no session IDs, no finding numbers in the card body. The rename's directory names appear only as the historical evidence of the proof case (the same carve-out PR build(deps-dev): bump the dev-dependencies group across 1 directory with 5 updates #98 made for the fleet postmortem); no live path in the card embeds a vault or repo name.
• Deviation from the PR build(deps-dev): bump the dev-dependencies group across 1 directory with 5 updates #98 draft: the "documented in the fleet card" pointer was dropped — that card is vault-side (armonissima/skills/fleet) and would dangle in this repo's shipped skill bundle.

Verification

• pnpm --filter amicode test: 3468 passed / 10 failed / 48 skipped — the failure set is the known environmental set, identical on pristine origin/main (verified by stash-and-rerun): amicode_service_runner ×1, chat_bridge ×2, skill_drift_lint ×2 (fleet-package regressions), cli_gate ×1, main_source_resolver ×2, rebuild_coordinator ×2. Zero new failures from this change. (One run flaked 9→10 on the same set — a 5s timeout in one environmental test.)
• node packages/extension/scripts/lint-skills.mjs: output byte-identical pre/post change (27 pre-existing companion errors on origin/main, none in amico-vault). The [vpath] rule is absent on this branch — it is skills-integrity lint: [vpath] rotted vault-path rule (F28 repo half) #1100's, noted in the card and enforced once that lands.

Draft per the walk's rules — the parent owns merge and integration.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 311b6d4b-f607-4961-a3fa-f5d33b76217a

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}