Contract: chore-rename-repo-facing-polish

1. Intent

Rename the outlier skill repo-facing-polish to colibri-repo-facing-polish in both the canon (.agents/skills/) and mirror (.claude/skills/) surfaces, unifying the skills corpus under a single colibri-* prefix family.

2. Rename plan

2.1 Directory renames (git mv — preserves history)

Source Target
.agents/skills/repo-facing-polish/ .agents/skills/colibri-repo-facing-polish/
.claude/skills/repo-facing-polish/ .claude/skills/colibri-repo-facing-polish/

2.2 Frontmatter edits (2 files, 1 line each)

File Before After
.agents/skills/colibri-repo-facing-polish/SKILL.md name: repo-facing-polish name: colibri-repo-facing-polish
.claude/skills/colibri-repo-facing-polish/SKILL.md name: repo-facing-polish name: colibri-repo-facing-polish

2.3 Internal reference update

File Change
.agents/skills/colibri-repo-facing-polish/agents/openai.yaml $repo-facing-polish$colibri-repo-facing-polish

2.4 Live README / cross-reference updates

File Change
.agents/README.md Line 20 header (21 colibri-*)(22 colibri-*); line 58 repo-facing-polishcolibri-repo-facing-polish; resolve body/table inconsistency (V2 tail)
.claude/README.md Line 55 repo-facing-polishcolibri-repo-facing-polish; update stale ams-* stub section to note stubs removed R75
.claude/skills/README.md Remove “Extra file” note; update to reflect rename as part of colibri-* family
docs/PLAN-RED.md Line 269 list entry repo-facing-polishcolibri-repo-facing-polish
docs/world-schema.md Line 251 tree entry repo-facing-polishcolibri-repo-facing-polish

2.5 Test assertion update

File Before After
src/__tests__/skill-schema.test.ts expect(corpus.length).toBe(21) expect(corpus.length).toBe(22)

3. Invariants

I-1: Total SKILL.md count unchanged

The total number of SKILL.md files in .agents/skills/ remains 22.

Verification: ls .agents/skills/ | wc -l = 22 before and after.

I-2: colibri-* prefix count goes 21 → 22

All 22 entries in .agents/skills/ now match the colibri-* prefix; zero outliers remain.

Verification: ls .agents/skills/ | grep -v ^colibri- = empty.

I-3: SKILL.md byte-identity (canon ↔ mirror)

The SKILL.md file in .agents/skills/colibri-repo-facing-polish/ and .claude/skills/colibri-repo-facing-polish/ must be byte-identical post-rename and post-frontmatter-edit.

Verification: diff .agents/skills/colibri-repo-facing-polish/SKILL.md .claude/skills/colibri-repo-facing-polish/SKILL.md = empty.

I-4: Kebab-case validation passes

colibri-repo-facing-polish matches /^[a-z][a-z0-9-]+$/. The old name also passed. No regression.

Verification: npm test schema test corpus sweep parses the renamed skill without error.

I-5: No historical record retroactively rewritten

Files in .agents/spawns/, docs/audits/p0-6-2-*, docs/packets/p0-6-2-*, docs/packets/r75-plan-red-packet.md, docs/verification/p0-6-2-* retain the old name as historical record.

I-6: Git history preserved

Directory renames are performed with git mv, not a manual delete+recreate. git log --follow will trace the rename.

I-7: Corpus test passes (22)

src/__tests__/skill-schema.test.ts assertion expect(corpus.length).toBe(22) confirms the renamed skill parses cleanly under Zod schema validation.

4. Out of scope

  • CLAUDE.md — already claims “22 canonical colibri-* skills”; becomes literally true post-merge without edits
  • Memory files under C:\Users\Kamal\.claude\projects\E--AMS\memory\ — Sigma-PM handles these post-merge
  • Obsidian vault sync — handled separately by Sigma-PM
  • The .agents/skills/colibri-repo-facing-polish/references/ and agents/ subdirectories are NOT mirrored to .claude/ (existing structural asymmetry, not new drift)

5. Rollback

If this PR needs rollback, reverse the git mv operations and revert the 2-character frontmatter + README edits. No schema or database migration required.


Back to top

Colibri — documentation-first MCP runtime. Apache 2.0 + Commons Clause.

This site uses Just the Docs, a documentation theme for Jekyll.