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/helpers/control_plane_fixtures.py
View on GitHub"""
helpers/control_plane_fixtures.py
=================================
Provides isolated test state setup for ControlPlane test suites,
avoiding polluting production ControlPlane with test helpers.
"""
from typing import Optional
from agent_control import ControlPlane
def create_task_in_state(
control_plane: ControlPlane,
task_id: str,
target_state: str,
title: str = "Test Task",
runtime_tool: str = "claude",
spec_path: Optional[str] = None,
) -> None:
"""Helper to transition a task to target_state for testing."""
control_plane.create_task(
task_id=task_id,
title=title,
runtime_tool=runtime_tool,
spec_path=spec_path,
)
if target_state == "INTAKE":
return
# Inbound path to INTERVIEW
control_plane.transition(task_id, "INTERVIEW", "tester", "setup interview")
if target_state == "INTERVIEW":
return
# To DRAFT_PLAN
control_plane.record_plan_mode_entry(task_id, "tester")
control_plane.transition(task_id, "DRAFT_PLAN", "tester", "setup draft plan")
if target_state == "DRAFT_PLAN":
return
if target_state == "MULTI_AGENT_REVIEW":
control_plane.transition(task_id, "MULTI_AGENT_REVIEW", "tester", "setup multi agent review")
return
if target_state == "PLAN_REVIEW":
control_plane.transition(task_id, "PLAN_REVIEW", "tester", "setup plan review")
return
if target_state == "AWAITING_APPROVAL":
control_plane.record_review_skip(task_id, "multi_agent_review", "tester", "skip review")
control_plane.transition(task_id, "AWAITING_APPROVAL", "tester", "setup awaiting approval")
return
if target_state == "APPROVED":
control_plane.record_review_skip(task_id, "multi_agent_review", "tester", "skip review")
control_plane.transition(task_id, "AWAITING_APPROVAL", "tester", "setup awaiting approval")
control_plane.transition(task_id, "APPROVED", "approver", "setup approved")
return
if target_state == "IN_WORKTREE":
control_plane.record_review_skip(task_id, "multi_agent_review", "tester", "skip review")
control_plane.transition(task_id, "AWAITING_APPROVAL", "tester", "setup awaiting approval")
control_plane.transition(task_id, "APPROVED", "approver", "setup approved")
control_plane.record_human_approval(task_id, "approver")
control_plane.update_worktree(task_id, f".worktrees/{task_id}", f"feature/{task_id}", "written_in_worktree")
control_plane.transition(task_id, "IN_WORKTREE", "tester", "setup worktree")
return
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 | 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 |