# Instar Upgrade Guide — NEXT

<!-- bump: patch -->

## What Changed

**test-as-self skill now leads with the one-button command (+ migration for
existing agents).** Track F shipped `instar test-as-self` but the skill doc still
read as the old manual runbook. The SKILL.md now leads with "The one-button path
(Part 2.1)" — the command — with the manual recipe demoted to a fallback for
fine-grained control. A `PostUpdateMigrator.migrateTestAsSelfSkill` patches
existing agents' on-disk SKILL.md (conservative: only when it lacks the Part 2.1
marker AND matches the stock fingerprint; customized skills untouched).

## What to Tell Your User

- Internal: my test-as-self skill now points me at the one-command version first
  instead of the old step-by-step recipe. No user-facing change.

## Summary of New Capabilities

| Capability | How to Use |
|-----------|-----------|
| test-as-self SKILL → one-button-first | Automatic — the skill now surfaces `instar test-as-self` as the primary path. |
| `migrateTestAsSelfSkill` | Automatic on update — patches existing agents' SKILL.md to the Part 2.1 version (conservative + idempotent). |

## Evidence

**Content + migration-parity follow-up to Track F; no behavior change.** Unit
test `tests/unit/migrate-test-as-self-skill.test.ts` (4): stock-v1 updated,
idempotent, customized-untouched, not-installed no-op. `tsc` clean. Mirrors the
proven migrateBuildSkillMethodology pattern. Side-effects review:
`upgrades/side-effects/test-as-self-skill-demote.md`. Follow-up to Track F of
`docs/specs/MULTI-MACHINE-BOOTSTRAP-ROBUSTNESS-SPEC.md`.
