# Drift-to-Skill Governance

**Date:** 2026-06-24 · **Source:** Pi workflow-consolidation design (recovered) + architect-reviewed brief.

**Principle:** Anywhere a recurring protocol relies on a human remembering, it drifts. The fix is a **skill** (for on-demand, judgment-bearing work) or a **hook** (for automatic, no-trigger work), never a standing reminder. Manual stays manual only on purpose.

## Decision table

| Manual protocol | Current behavior | Recommended automation | Type | Build by | Notes |
|---|---|---|---|---|---|
| Session-start git pulls | Manual `git pull` + read per repo | Automated read protocol | Hook | Pi / Claude | Applies to `signal` and `~/.claude/skills` (if separate repo). |
| Session wrap-up commit/push | Manual edit/commit/push (session-brain Step 5) | Automated write protocol | Hook | Pi / Claude | **Scope to `current-state.md`, not `git add .`** (safety correction to Pi's draft). |
| Git commit + push (general) | Manual `git add/commit/push` | Skill | Skill | Claude | Existing `git-push` skill for broader work. |
| Content calendar update (NocoDB) | Manual curl/GUI | Skill | Skill | Pi / Claude | "Update NocoDB content calendar". |
| KG / TriLane queries | Manual MCP / HTTP curl | Skill | Skill | Pi / Claude | "Query TriLane" over the documented HTTP API. |
| current-state.md staleness check | Manual read of `Updated:` | Automated read protocol | Hook | Pi / Claude | Part of the read protocol. |
| MCP server sync | Manual per-agent config | Automated MCP parity | Hook | Pi / Claude | Reads a shared MCP config at startup. |
| New policy / regulatory doc | Manual creation | Skill | Skill | Pi / Claude | Drafts + commits the doc. |
| Blog post creation/update | Manual | Skill pipeline | Workflow | Pi / Claude | Automated blog pipeline (see Automated Blog plan). |

## Build order (risk-ascending)

1. **Done:** v:1 state schema, `state-sync` skill, demoted CLAUDE.md state block, this governance doc.
2. **Pending Kisa review (high blast radius):** scoped commit/push Stop hook; global CLAUDE.md + Pi `AGENTS.md` startup edits; MCP parity.
3. **Later:** skills-as-git-repo, the per-protocol skills above (NocoDB, TriLane query, policy/blog), as each is needed.
