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).
references/diagrams/event-bus-architecture.mmd
View on GitHub---
config:
layout: elk
theme: base
---
flowchart TB
subgraph subGraph0["Agent Layer (Actors)"]
backend_agent["Backend Agent"]
frontend_agent["Frontend Agent"]
os_lab_loop["the `loop` mode of `improving-skills-in-lab`"]
memory_manager["the `memory` mode of `improving-skills-in-lab`"]
end
subgraph subGraph1["Kernel Layer (Nervous System)"]
kernel_controller["kernel.py<br>(Atomic Lock & Emit Broker)"]
event_bus[("events.jsonl<br>(Event Bus)")]
os_state[("os-state.json<br>(State Lock)")]
registry[("agents.json<br>(Registry)")]
end
subgraph subGraph2["Observability & Loops"]
os_health_check["the `health` mode"]
loop_scheduler["/loop scheduler"]
end
subgraph subGraph3["Durable Memory (Storage)"]
memory_md["MEMORY.md"]
context_memory_md["context/memory.md"]
dated_logs["context/memory/YYYY-MM-DD.md"]
end
backend_agent -- "Intent/Result" --> kernel_controller
frontend_agent -- "Intent/Result" --> kernel_controller
os_lab_loop -- "Intent/Result" --> kernel_controller
kernel_controller -- "Verifies & Appends" --> event_bus
kernel_controller -- "Validates" --> registry
memory_manager -- Reads event history --> event_bus
memory_manager -- Reads session logs --> dated_logs
memory_manager -- Promotes long-term facts --> context_memory_md
memory_manager -- Updates auto-memory index --> memory_md
loop_scheduler -. Triggers hourly/daily .-> os_health_check
os_health_check -- Scans metrics/errors --> event_bus
backend_agent -. Requests Lock .-> kernel_controller
os_lab_loop -. Requests Lock .-> kernel_controller
kernel_controller -- "Atomic mkdir" --> os_state
backend_agent:::agent
frontend_agent:::agent
os_lab_loop:::agent
memory_manager:::agent
kernel_controller:::daemon
event_bus:::bus
os_state:::bus
registry:::bus
os_health_check:::daemon
loop_scheduler:::daemon
memory_md:::storage
context_memory_md:::storage
dated_logs:::storage
classDef agent fill:#f9f0ff,stroke:#5e35b1,stroke-width:2px
classDef bus fill:#fffde7,stroke:#fbc02d,stroke-width:3px
classDef storage fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
classDef daemon fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
classDef default fill:#fafafa,stroke:#333,stroke-width:1px
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 |