00cff7a5f8
- current-state.md -> v:1 schema (repairs Pi's destructive edit, restores decisions log) - recover Pi's workflow-consolidation design from session log into a durable doc - add drift-to-skill governance table - demote CLAUDE.md embedded state block to a pointer (stops harness re-injecting stale state) - new shared state-sync skill lives at ~/.claude/skills/state-sync (separate path) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
25 lines
2.2 KiB
Markdown
25 lines
2.2 KiB
Markdown
# 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.
|