sttil/Signal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Signal/docs/drift-to-skill-governance-2026-06-24.md
Kisa 00cff7a5f8 feat(workflow): build consolidation foundation from Pi's recovered design 
- 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>
2026-06-23 23:30:56 -04:00

2.2 KiB
Raw Blame History

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.