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_isolation_setup_docs.py
View on GitHub"""
tests/test_isolation_setup_docs.py
==================================
Purpose:
Failing-first acceptance tests for T8 (auth-ciba-increment-b, issue #639, spec case 12): the
isolation setup documentation `references/isolation-setup.md` exists at the path the Gate 1
remediation error names, is reachable from the os-control-signing-setup skill, states the ranked setups
and the honest residual risks (D4), and describes the strict/legacy modes and the human-side flow.
Real files only.
Key Input Dependencies:
- plugins/agent-agentic-os/skills/setting-up-agentic-os/references/isolation-setup.md
- plugins/agent-agentic-os/skills/os-control-signing-setup/ (SKILL.md, references/ symlink)
- control_plane/coordinator.py (the `setup_docs` path in the remediation error)
Key Functions (test cases):
- test_doc_exists_at_the_path_the_remediation_error_names
- test_doc_states_setups_modes_and_honest_limits
- test_doc_is_reachable_from_the_skill
"""
import re
import sys
from pathlib import Path
_scripts_dir = str(Path(__file__).resolve().parent.parent / "scripts")
if _scripts_dir not in sys.path:
sys.path.insert(0, _scripts_dir)
PLUGIN = Path(__file__).resolve().parent.parent
DOC = PLUGIN.parent / "setting-up-agentic-os" / "references" / "isolation-setup.md" # lives in the setup skill, which cites it
def test_doc_exists_at_the_path_the_remediation_error_names():
from control_plane.constants import ISOLATION_SETUP_DOC
assert Path(ISOLATION_SETUP_DOC).resolve() == DOC.resolve()
assert DOC.is_file()
def test_doc_states_setups_modes_and_honest_limits():
text = DOC.read_text().lower()
for required in (
"container", "dedicated", "agentic-os-local-agent", # the ranked setups
"same-account", "strict", # the single mode and the weakest posture
"allowed_signers", "0600", "0700", "challenge", # what is protected and how
"show-challenge", "approve-transition", "test-signing-mechanics", "setup_ciba_identity.py",
"residual", "direct", "database", # D4: a same-account DB writer is not stopped
"touch id", "certificate", # explicitly not supported
"trusted display", # FIDO caveat
"macos", "windows",
):
assert required in text, required
assert "input_unhardened" not in text and "off by default" not in text # the removed fallback is not documented as an option
def test_doc_is_reachable_from_the_skill():
workflow = PLUGIN.parent / "setting-up-agentic-os" / "references" / "modes" / "signing-setup.md"
assert "isolation-setup.md" in workflow.read_text()
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 |