kami-change-control

Routes repository changes to the correct procedure, sign-off authority, and enforcement gate.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/Raynos/kami-kakushi --skill kami-change-control-raynos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kami-change-control
Source: https://github.com/Raynos/kami-kakushi/tree/main/.claude/skills/kami-change-control
Command: npx skills add https://github.com/Raynos/kami-kakushi --skill kami-change-control-raynos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a shared-tree repository where multiple AI agents and a human collaborate, it is easy to make changes without knowing who must approve them or which gate enforces the rule. This Skill answers the question "I am about to change X — what procedure applies, who signs off, and where does the record go?" before any change is made. ## Core Features & Use Cases - Change-class routing table: Maps 13 change classes (design intent, UI surfaces, fiction text, balance numbers, maps, PRD edits, save schemas, commits, pushes, releases, deferred work, milestone claims, human TODO lists) to their sign-off authority, enforcement gate, and record location. - Standing approvals vs always-human calls: Distinguishes actions agents may perform autonomously (checkpoint pushes, schema bumps with migrations) from human-only decisions (releases via /ship, taste picks, force-pushes, save wipes). - ADR authoring mechanics: Covers reserving ADR numbers via tree-claim, writing entries in the live band, superseding old decisions without deleting history, and the precedence rules between living docs and ADRs. - Use Case: Before editing a balance slider export, an agent consults this Skill, learns that feel numbers are human-only via the cockpit slider, and instead transcribes the human's exported diff while running pnpm run verify:balance. ## Quick Start Ask the agent to load the kami-change-control skill and tell you what procedure and sign-off apply before committing your planned change to the shared tree.

Frequently Asked Questions about kami-change-control

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I know if a change needs human approval or is agent-safe?

Consult the change-class routing table: design intent, releases, taste picks, force-pushes, and save wipes are always human calls, while checkpoint pushes, pathspec commits, and save-schema bumps with migrations are standing-approved for agents.

How do I write and reserve an ADR in a shared repository?

Reserve the number first with pnpm exec tsx src/scripts/tree-claim.ts adr, then write the entry in the live band file using the template from the decisions index. Never delete superseded entries; mark them reversed and add a forward pointer.

Can an agent commit and push directly to main in a shared git tree?

Commits must use file-level pathspecs (git commit -m "..." -- path/a) and never bare commits or git add on tracked files. Pushes to main go through pnpm run push as part of a checkpoint, with the pre-push hook refusing a red verify suite.

When should I not use a change-control routing skill?

Do not use it to execute the procedures it routes to — use the owning skill directly (diverge, narrative-diverge, map-sheets, ship, and similar). It also does not cover per-gate failure diagnosis, flag catalogs, or debugging broken behavior.

What happens if a balance or UI change ships without following the routing table?

The table exists because of documented incidents: diverge-LITE UI shipped under an imaginary deadline (ADR-075), and a content rewrite silently deleted a game mechanic while every gate stayed green (ADR-190). Gates and HR-items exist to catch these classes.