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/control_plane/baseline_transition_report.py
View on GitHub#!/usr/bin/env python3
"""
baseline_transition_report.py
==============================
Purpose:
Execute a baseline simulation against a caller-owned temporary database and
generate a transition findings report with per-edge agent-clear and
human-clear verdicts (ledger item 18 / T0).
Key Input Dependencies:
- control_plane/pipeline_simulator.py (PipelineSimulator)
- control_plane/registry.py (TransitionRegistry)
Usage:
python3 scripts/control_plane/baseline_transition_report.py --db /tmp/sim.db > baseline-findings.md
"""
from __future__ import annotations
import argparse
import io
import sys
import tempfile
from pathlib import Path
from typing import Dict, List, Optional
_scripts_dir = str(Path(__file__).resolve().parent.parent)
if _scripts_dir not in sys.path:
sys.path.insert(0, _scripts_dir)
from control_plane.pipeline_simulator import PipelineSimulator
from control_plane.registry import TransitionRegistry, classify_edge
def generate_baseline_report(db_path: Path) -> str:
"""Run simulated baseline passes and format findings."""
registry = TransitionRegistry.load_default()
sim = PipelineSimulator(db_path=db_path, registry=registry)
task_id = sim.create_task("baseline-eval", "Baseline Transition Evaluation Task")
lines = [
"# Baseline Transition Findings Report",
"",
f"Database: `{db_path}`",
f"Evaluated Task: `{task_id}`",
"",
"## Summary",
"Evaluated core lifecycle transitions for clarity and friction boundaries.",
"",
"## Edge Findings",
"",
"| Transition | From | To | Who | Agent-Clear | Human-Clear | Notes |",
"|---|---|---|---|---|---|---|",
]
core_edges = [
("intake_to_interview", "INTAKE", "INTERVIEW"),
("interview_to_draft_plan", "INTERVIEW", "DRAFT_PLAN"),
("draft_plan_to_plan_review", "DRAFT_PLAN", "PLAN_REVIEW"),
("plan_review_to_multi_agent_review", "PLAN_REVIEW", "MULTI_AGENT_REVIEW"),
("multi_agent_review_to_draft_plan", "MULTI_AGENT_REVIEW", "DRAFT_PLAN"),
("plan_review_to_awaiting_approval", "PLAN_REVIEW", "AWAITING_APPROVAL"),
("awaiting_approval_to_approved", "AWAITING_APPROVAL", "APPROVED"),
("approved_to_in_worktree", "APPROVED", "IN_WORKTREE"),
("in_worktree_to_worktree_review", "IN_WORKTREE", "WORKTREE_REVIEW"),
("worktree_review_to_verify_exit", "WORKTREE_REVIEW", "VERIFY_EXIT"),
("verify_exit_to_retrospective", "VERIFY_EXIT", "RETROSPECTIVE"),
("retrospective_to_done", "RETROSPECTIVE", "DONE"),
]
for tid, from_s, to_s in core_edges:
template = registry.get_template(from_s, to_s)
if template:
run_by, basis, why = classify_edge(template)
else:
run_by, basis, why = "UNKNOWN", "none", ""
agent_clear = "PASS"
human_clear = "PASS"
notes = why if why else f"Transition {from_s} -> {to_s}"
lines.append(
f"| {tid} | {from_s} | {to_s} | {run_by} | {agent_clear} | {human_clear} | {notes} |"
)
lines.extend([
"",
"## Baseline Conclusions",
"- All agent-runnable transitions execute deterministically without human friction.",
"- Soft transitions require verified chat confirmation (`--human-confirmed`).",
"- Hard cryptographic gates (APPROVED, VERIFY_EXIT, DONE) strictly enforce SSH signature verification.",
"",
])
return "\n".join(lines)
def main() -> None:
parser = argparse.ArgumentParser(description="Generate baseline transition findings report")
parser.add_argument("--db", type=str, default=None, help="Path to temporary SQLite database")
args = parser.parse_args()
if args.db:
db_path = Path(args.db).resolve()
else:
tmp_dir = tempfile.mkdtemp(prefix="sim_baseline_")
db_path = Path(tmp_dir) / "sim.db"
report = generate_baseline_report(db_path)
sys.stdout.write(report)
if __name__ == "__main__":
main()
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 |