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).
tests/test_approver_identity_guidance.py
View on GitHub#!/usr/bin/env python
"""
test_approver_identity_guidance.py
==================================
Purpose:
Contract tests for the approver-identity rule: each pipeline has exactly one
approver; the default is the human operator's signing identity for all main
work, and only simulation work (signed off by the human) may use the agent's
test identity. The rule must reach agents through the INTERVIEW stage
contract (surfaced by transition-guidance) and as the first os-control-intake rule.
Key Input Dependencies:
plugins/agent-agentic-os/skills/running-control-plane/scripts/control_plane/transition_templates.yaml — stages.INTERVIEW.approver_identity
references/modes/intake.md (running-control-plane) — Critical Operational Rule 1
references/modes/simulator.md (running-control-plane) — simulation approver section
Layer: Development / Testing
Functions:
- test_interview_contract_declares_single_human_default_approver
- test_work_intake_confirms_approver_identity_first
- test_transition_simulator_documents_simulation_approver
- test_guidance_describes_the_two_database_split
Usage:
python -m pytest plugins/agent-agentic-os/skills/running-control-plane/tests/test_approver_identity_guidance.py
"""
from pathlib import Path
from control_plane.registry import TransitionRegistry
PLUGIN_ROOT = Path(__file__).resolve().parents[1]
def test_interview_contract_declares_single_human_default_approver():
contract = TransitionRegistry.load_default().get_stage_contract("INTERVIEW")
approver = contract["approver_identity"]
assert approver["one_approver_per_pipeline"] is True
assert approver["default"] == "human_operator"
assert "simulation" in approver["agent_simulation"].lower()
assert "test-human@local" in approver["agent_simulation"]
def test_work_intake_confirms_approver_identity_first():
text = (PLUGIN_ROOT / "references" / "modes" / "intake.md").read_text(encoding="utf-8")
heading = "## Critical Constraints" if "## Critical Constraints" in text else "## Critical Operational Rules"
rules = text.split(heading, 1)[1]
first_rule = next(line for line in rules.splitlines() if line.startswith("1. "))
assert "Approver Identity" in first_rule
assert "simulation" in first_rule.lower()
def test_transition_simulator_documents_simulation_approver():
text = (PLUGIN_ROOT / "references" / "modes" / "simulator.md").read_text(encoding="utf-8")
assert "## Approver Identity in Simulations" in text
assert "test-human@local" in text
def test_guidance_describes_the_two_database_split():
"""The rule is enforced by database (approver_policy.py): every guidance surface must say that
simulations run in the separate simulation_control_plane.db and must not point agents at the
removed in-database designation command."""
contract = TransitionRegistry.load_default().get_stage_contract("INTERVIEW")["approver_identity"]
surfaces = {
"yaml": " ".join(str(v) for v in contract.values()),
"os-control-intake": (PLUGIN_ROOT / "references" / "modes" / "intake.md").read_text(encoding="utf-8"),
"os-control-simulator": (PLUGIN_ROOT / "references" / "modes" / "simulator.md").read_text(encoding="utf-8"),
}
for name, text in surfaces.items():
assert "simulation_control_plane.db" in text, name
assert "designate-simulation" not in text, name
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: 472k | Updated | Claude CodeCodex | Verified | 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 |