richfrem/agent-plugins-skills / plugins/agent-agentic-os/.apm/skills/running-control-plane
running-control-plane
FlaggedCRITICAL INTAKE GATEWAY: use at the start of any non-trivial engineering task, feature, refactor, multi-file bugfix, work package or new idea, including requests to explore, brainstorm, build, fix or change something, before planning or code changes. Enforces read-only discovery, 1-3 structured questions with defaults, control-plane registration and the immutable four-pillar TASK_SPEC.md. Also runs the rest of the control plane: health ("run health check", "check os metrics", "system monitor", event bus, locks, memory, "is my signing identity ready" status check), transition simulation ("dry run transition", "simulate transition", "check edge X -> Y"), worktree selection, and gating on/off ("disable the control plane", "turn off the push guard", "stop gating my commits"). Not for project setup or key creation (use setting-up-agentic-os) or improving skills (use improving-skills-in-lab).
scripts/pre-commit-evolution-guard
View on GitHub#!/usr/bin/env bash
# ==============================================================================
# pre-commit-evolution-guard — Deterministic Evolution & Map Debt Gate
# ==============================================================================
# Purpose:
# Blocks commits that modify core logic (plugins/, py_services/, src/, etc.)
# unless the commit also includes a schema-valid entry in references/map-debt.md,
# an evolution log write, or a Layer 2 wiki playbook write.
# ==============================================================================
set -e
# 1. Check if staged files include core logic/source directories
STAGED_SRC=$(git diff --cached --name-only --diff-filter=ACM | grep -E '^(plugins/|src/|py_services/)' || true)
if [ -z "$STAGED_SRC" ]; then
exit 0
fi
# 2. Check for staged evolution / map-debt / wiki artifacts
STAGED_MAP_DEBT=$(git diff --cached --name-only --diff-filter=ACM | grep -E '^(references/map-debt.md|wiki/|plugins/.*/references/evolution-log.md)' || true)
if [ -z "$STAGED_MAP_DEBT" ]; then
echo ""
echo "❌ COMMIT BLOCKED: Core logic changed without Evolution & Map Debt logging!"
echo ""
echo "Staged logic files:"
echo "$STAGED_SRC" | sed 's/^/ • /'
echo ""
echo "To fix this, record the evolution / friction / fix in:"
echo " • references/map-debt.md, OR"
echo " • wiki/playbook-*.md, OR"
echo " • plugins/<plugin>/references/evolution-log.md"
echo "and stage it before committing."
echo ""
echo "Note: If this change genuinely has no map-debt, add 'Evolution-Check: none' trailer in commit message (enforced in CI)."
echo ""
exit 1
fi
# 3. Content Validation: Ensure all added map-debt.md rows match schema (8 columns / 9 pipes)
if git diff --cached --name-only --diff-filter=ACM | grep -q 'references/map-debt.md'; then
ADDED_ROWS=$(git diff --cached references/map-debt.md | grep -E '^\+[[:space:]]*\|[[:space:]]*DEBT-' || true)
if [ -n "$ADDED_ROWS" ]; then
# Check every added DEBT row individually
while IFS= read -r row; do
[ -z "$row" ] && continue
PIPE_COUNT=$(echo "$row" | tr -cd '|' | wc -c)
if [ "$PIPE_COUNT" -lt 9 ]; then
echo ""
echo "❌ COMMIT BLOCKED: Malformed row in references/map-debt.md"
echo " Row: $row"
echo " Expected 8 columns with 9 pipe delimiters: | ID | Title | Status | Severity | Repeat | First Seen | Description | Resolution Commit |"
echo ""
exit 1
fi
done <<< "$ADDED_ROWS"
fi
fi
# 4. Content Validation: Ensure staged wiki playbooks are registered in wiki/index.md
STAGED_PLAYBOOKS=$(git diff --cached --name-only --diff-filter=ACM | grep -E '^wiki/playbook-.*\.md$' || true)
if [ -n "$STAGED_PLAYBOOKS" ]; then
if ! git diff --cached --name-only --diff-filter=ACM | grep -q '^wiki/index\.md$'; then
if [ -f "wiki/index.md" ]; then
# Verify every staged playbook is referenced in existing wiki/index.md
while IFS= read -r pb_path; do
[ -z "$pb_path" ] && continue
pb_file=$(basename "$pb_path")
if ! grep -q "$pb_file" wiki/index.md; then
echo ""
echo "❌ COMMIT BLOCKED: Unindexed Layer 2 Wiki Playbook!"
echo " Playbook '$pb_file' is staged, but missing from wiki/index.md."
echo " Run: python3 $(dirname "$0")/distill_playbook.py --sync-index"
echo " and stage wiki/index.md before committing."
echo ""
exit 1
fi
done <<< "$STAGED_PLAYBOOKS"
fi
fi
fi
exit 0
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |