Skip to content

richfrem/agent-plugins-skills / plugins/agent-agentic-os/.apm/skills/running-control-plane

running-control-plane

Flagged

CRITICAL 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).

FileKindSize
SKILL.mdskill md5.4 KB
evals/evals.jsonconfig8.3 KB
references/acceptance-criteria.mdmarkdown4.0 KB
references/agentic-os-skill-map.mdmarkdown2.3 KB
references/architecture/architecture.mdmarkdown2.4 KB
references/architecture/context-folder-patterns.mdmarkdown3.3 KB
references/architecture/vision.mdmarkdown56.6 KB
references/cheap-agent-transition-simulation.mdmarkdown6.1 KB
references/control-plane-architecture.mdmarkdown9.0 KB
references/control-plane-rebuild-recovery.mdmarkdown6.2 KB
references/control-plane-simulation-protocol.mdmarkdown5.7 KB
references/diagrams/agentic-os-memory-subsystem.mmdother1.4 KB
references/diagrams/architecture-overview.mmdother3.1 KB
references/diagrams/control-plane-architecture.mermaidother6.3 KB
references/diagrams/control-plane-lifecycle-hardened-with-ciba-rar.mermaidother4.5 KB
references/diagrams/control-plane-pipeline-happy-path.mermaidother5.0 KB
references/diagrams/control-plane-pipeline.mermaidother9.3 KB
references/diagrams/event-bus-architecture.mmdother2.4 KB
references/diagrams/increment-b-human-only-transition-ssh-signing.mermaidother5.3 KB
references/edge-matrix.mdmarkdown13.3 KB
references/fallback-tree.mdmarkdown2.9 KB
references/health-detailed-reference.mdmarkdown7.1 KB
references/healthy-transcript.mdmarkdown3.8 KB
references/implementation-ledger-contract.mdmarkdown851 B
references/intake-detailed-reference.mdmarkdown3.1 KB
references/modes/health.mdmarkdown3.4 KB
references/modes/intake.mdmarkdown3.8 KB
references/modes/mode.mdmarkdown5.8 KB
references/modes/simulator.mdmarkdown6.2 KB
references/modes/worktree.mdmarkdown2.9 KB
references/multi-round-external-review-protocol.mdmarkdown2.6 KB
references/worktree-reconciliation-and-multi-worktree-practices.mdmarkdown5.8 KB
requirements-dev.inother741 B
requirements-dev.txtmarkdown603 B
requirements.inother196 B
requirements.txtmanifest202 B
scripts/agent_control.pyscript97.7 KB
scripts/audit_map_debt.pyscript6.1 KB
scripts/capability_probe.pyscript6.4 KB
scripts/check_plan_links.pyscript1.8 KB
scripts/control_plane/__init__.pyscript842 B
scripts/control_plane/adapters.pyscript144.9 KB
scripts/control_plane/approver_policy.pyscript20.0 KB
scripts/control_plane/baseline_transition_report.pyscript4.0 KB
scripts/control_plane/constants.pyscript13.5 KB
scripts/control_plane/coordinator.pyscript57.3 KB
scripts/control_plane/edge_matrix.pyscript3.1 KB
scripts/control_plane/gate1_approval.pyscript10.7 KB
scripts/control_plane/gate_evidence.pyscript9.9 KB
scripts/control_plane/identity_layout.pyscript2.9 KB
scripts/control_plane/identity_setup.pyscript11.0 KB
scripts/control_plane/implementation.pyscript3.7 KB
scripts/control_plane/implementation_loop.pyscript11.3 KB
scripts/control_plane/inspection.pyscript3.9 KB
scripts/control_plane/installation_probe.pyscript5.7 KB
scripts/control_plane/isolation_check.pyscript14.0 KB
scripts/control_plane/measurement.pyscript39.1 KB
scripts/control_plane/pipeline_simulator.pyscript30.0 KB
scripts/control_plane/policy.pyscript32.5 KB
scripts/control_plane/ports.pyscript20.3 KB
scripts/control_plane/proof_edges.pyscript4.6 KB
scripts/control_plane/proof_policy.pyscript2.2 KB
scripts/control_plane/receipt_provenance.pyscript4.7 KB
scripts/control_plane/registry.pyscript32.9 KB
scripts/control_plane/review_options.pyscript8.2 KB
scripts/control_plane/review_selection.pyscript3.2 KB
scripts/control_plane/run_transition_simulation.pyscript12.0 KB
scripts/control_plane/signing_selftest.pyscript6.8 KB
scripts/control_plane/simulation_identity.pyscript10.4 KB
scripts/control_plane/snapshot.pyscript10.8 KB
scripts/control_plane/ssh_signing.pyscript21.8 KB
scripts/control_plane/state_machine.pyscript5.8 KB
scripts/control_plane/transition_request.pyscript19.5 KB
scripts/control_plane/transition_simulation_cases.pyscript24.6 KB
scripts/control_plane/transition_templates.yamlconfig159.1 KB
scripts/control_plane/tty_signer.pyscript3.0 KB
scripts/control_plane/wrappers/__init__.pyscript24 B
scripts/control_plane/wrappers/record_interview_question.pyscript8.0 KB
scripts/control_plane/wrappers/record_retrospective.pyscript2.3 KB
scripts/control_plane/wrappers/run_exit_verification.pyscript6.4 KB
scripts/control_plane/wrappers/run_verify_exit_bundle.pyscript5.4 KB
scripts/control_plane/wrappers/write_plan_document.pyscript9.6 KB
scripts/control_plane_hooks.pyscript10.5 KB
scripts/control_plane_mode.pyscript12.0 KB
scripts/distill_playbook.pyexecutablescript9.9 KB
scripts/evolution_state.pyscript29.4 KB
scripts/export_upstream_pr.pyscript4.4 KB
scripts/interview_spec_engine.pyscript9.1 KB
scripts/kernel.pyscript14.6 KB
scripts/pre-commit-evolution-guardexecutablescript3.7 KB
scripts/pre-commit-pipeline-guardexecutablescript13.6 KB
scripts/pre-push-review-guardexecutablescript10.5 KB
scripts/record_trace.pyscript7.2 KB
scripts/smoke_test.pyexecutablescript22.6 KB
scripts/test_capability_probe.pyscript3.9 KB
scripts/test_worktree_manager.pyscript2.8 KB
scripts/verify_evolution_receipt.pyscript7.5 KB
scripts/verify_gate_evidence.pyscript1.6 KB
scripts/worktree_manager.pyscript3.0 KB
tests/conftest.pyscript7.7 KB
tests/helpers/__init__.pyscript0 B
tests/helpers/control_plane_fixtures.pyscript2.6 KB
tests/helpers/control_plane_repo.pyscript4.0 KB
tests/helpers/gate1_fixtures.pyscript5.8 KB
tests/helpers/human_signer.pyscript7.3 KB
tests/helpers/implementation_ledger.pyscript1.1 KB
tests/interview_helpers.pyscript5.2 KB
tests/test_actionable_rollback.pyscript2.2 KB
tests/test_agent_control.pyscript190.6 KB
tests/test_agent_control_gate_characterization.pyscript14.7 KB
tests/test_approve_transition.pyscript10.5 KB
tests/test_approver_identity_guidance.pyscript3.4 KB
tests/test_approver_isolation.pyscript12.3 KB
tests/test_audit_map_debt.pyscript4.7 KB
tests/test_authorized_actor_enforcement.pyscript22.9 KB
tests/test_background_document_priority.pyscript924 B
tests/test_check_plan_links.pyscript1.1 KB
tests/test_content_snapshot.pyscript11.8 KB
tests/test_control_plane_architecture_diagram_contract.pyscript9.0 KB
tests/test_control_plane_architecture_overview_contract.pyscript2.1 KB
tests/test_control_plane_critic_review.pyscript3.1 KB
tests/test_control_plane_crypto_adapter.pyscript5.0 KB
tests/test_control_plane_delegation_contract.pyscript5.7 KB
tests/test_control_plane_facade_composition.pyscript15.9 KB
tests/test_control_plane_filesystem_adapter.pyscript4.9 KB
tests/test_control_plane_hooks.pyscript7.3 KB
tests/test_control_plane_interview_guidance.pyscript3.8 KB
tests/test_control_plane_measurement_contract.pyscript28.0 KB
tests/test_control_plane_mode.pyscript7.5 KB
tests/test_control_plane_mode_guards.pyscript3.5 KB
tests/test_control_plane_model_catalog_adapter.pyscript9.2 KB
tests/test_control_plane_pipeline_diagram_contract.pyscript2.3 KB
tests/test_control_plane_pipeline_simulator.pyscript7.5 KB
tests/test_control_plane_policy.pyscript13.0 KB
tests/test_control_plane_ports.pyscript3.2 KB
tests/test_control_plane_reset_transition.pyscript13.6 KB
tests/test_control_plane_schema_rebuild_atomicity.pyscript20.0 KB
tests/test_control_plane_simulation_protocol_contract.pyscript959 B
tests/test_control_plane_sqlite_persistence_adapter.pyscript5.5 KB
tests/test_control_plane_state_machine.pyscript15.2 KB
tests/test_control_plane_trigger_enforcement.pyscript14.6 KB
tests/test_control_plane_worktree_sharing.pyscript4.5 KB
tests/test_domain_namespaces.pyscript6.7 KB
tests/test_done_closure_proof.pyscript6.9 KB
tests/test_draft_plan_interactive_outline_gap.pyscript2.2 KB
tests/test_dual_identity_onboarding.pyscript7.3 KB
tests/test_edge_matrix.pyscript3.2 KB
tests/test_ensure_schema_fastpath.pyscript4.4 KB
tests/test_evolution_guards.pyscript14.9 KB
tests/test_evolution_scripts.pyscript55.3 KB
tests/test_gate1_guidance.pyscript1.8 KB
tests/test_gate3_code_acceptance.pyscript13.5 KB
tests/test_graph_state_machine.pyscript16.0 KB
tests/test_guidance_readiness.pyscript2.2 KB
tests/test_health_check_signing_status.pyscript3.5 KB
tests/test_human_decision_trigger_enforcement.pyscript37.3 KB
tests/test_human_only_wiring.pyscript22.3 KB
tests/test_human_signer_isolation.pyscript4.0 KB
tests/test_identity_verification_readiness.pyscript5.8 KB
tests/test_implementation_ledger.pyscript3.4 KB
tests/test_implementation_loop.pyscript6.9 KB
tests/test_implementation_runtime_bridge.pyscript2.6 KB
tests/test_init_agentic_os_scaffolding.pyscript10.0 KB
tests/test_init_respects_control_plane_mode.pyscript4.3 KB
tests/test_inspect_verbs.pyscript3.6 KB
tests/test_installation_probe.pyscript3.1 KB
tests/test_intake_scenarios.pyscript7.2 KB
tests/test_interview_plan_outline.pyscript2.8 KB
tests/test_isolation_check.pyscript12.5 KB
tests/test_isolation_setup_docs.pyscript2.7 KB
tests/test_kernel_security.pyscript4.0 KB
tests/test_legacy_input_fallback.pyscript6.0 KB
tests/test_list_review_options.pyscript3.1 KB
tests/test_multi_agent_bundle_gate.pyscript5.5 KB
tests/test_one_approver_per_pipeline.pyscript15.8 KB
tests/test_os_init_dual_identity.pyscript3.9 KB
tests/test_os_init_identity_bootstrap.pyscript8.8 KB
tests/test_os_init_identity_status.pyscript3.9 KB
tests/test_os_init_single_instruction_file.pyscript7.3 KB
tests/test_p00_live_baseline.pyscript10.2 KB
tests/test_p01_intake_persistence.pyscript6.7 KB
tests/test_post_run_metrics_protocol.pyscript3.3 KB
tests/test_pre_commit_pipeline_guard.pyscript29.1 KB
tests/test_pre_push_review_guard.pyscript5.7 KB
tests/test_receipt_provenance.pyscript6.6 KB
tests/test_retrospective_pipeline.pyscript5.3 KB
tests/test_review_option_menus.pyscript6.6 KB
tests/test_review_selection.pyscript8.2 KB
tests/test_round3_fixes.pyscript8.3 KB
tests/test_rules_compliance.pyscript1.3 KB
tests/test_run_transition_simulation_formatting.pyscript1.7 KB
tests/test_run_verify_exit_bundle.pyscript10.2 KB
tests/test_setup_ciba_identity.pyscript11.2 KB
tests/test_signed_approval_human_receipt.pyscript3.9 KB
tests/test_signing_mechanics_selftest.pyscript6.9 KB
tests/test_signing_skill_selfcontained.pyscript3.4 KB
tests/test_skip_receipt_guidance.pyscript2.7 KB
tests/test_ssh_signing.pyscript23.9 KB
tests/test_strategy_artifacts.pyscript21.8 KB
tests/test_transition_answer_normalization.pyscript1.1 KB

scripts/control_plane/identity_setup.py

View on GitHub
#!/usr/bin/env python3
"""
control_plane/identity_setup.py
===============================

Purpose:
    Logic for creating and inspecting the Gate 1 signing identity (auth-ciba-increment-b, issue
    #639, tasks T11/T12/T13/T14): create the `context/identity/` layout with safe modes, enroll a
    public key into the production `allowed_signers` (namespace control-plane@agentic-os.local) and the SEPARATE
    `allowed_signers_selftest` (namespace control-plane-selftest@agentic-os.local), list enrolled keys with their
    fingerprints, check that a private key is passphrase-protected, and report a read-only status
    (also used by the init and health modes). Stdlib only; uses the real `ssh-keygen`.
    The setup CLI (scripts/setup_ciba_identity.py) is the interactive front end; nothing here
    prompts, and nothing here runs privileged commands.

Key Input Dependencies:
    - control_plane/identity_layout.py, isolation_check.py, ssh_signing.py (namespaces)
    - `ssh-keygen` on PATH (OpenSSH 8.1+)

Key Functions:
    - ensure_layout() -- create context/identity and challenges/ (0700).
    - key_fingerprint() -- SHA256 fingerprint of a public key via ssh-keygen -l.
    - key_is_passphrase_protected() -- True if the private key cannot be read without a passphrase.
    - enroll_key() -- append a key to both allowed_signers files (0600, atomic, never removes).
    - enrolled_keys() -- parse the production allowed_signers.
    - identity_status() -- read-only readiness report (isolation preflight + enrolled keys).
    - privileged_account_commands() -- the account-creation commands to PRINT for the human.
"""

import os
import shlex
import subprocess
import sys
import tempfile
from dataclasses import dataclass
from pathlib import Path
from typing import Any, Dict, List, Optional

from control_plane.identity_layout import IdentityLayout
from control_plane.isolation_check import DEFAULT_AGENT_NAME, check_isolation
from control_plane.ssh_signing import (
    LEGACY_SELFTEST_NAMESPACE, LEGACY_SIGN_NAMESPACE, SELFTEST_NAMESPACE, SIGN_NAMESPACE, probe_ssh_keygen,
)


@dataclass(frozen=True)
class EnrolledKey:
    """One line of allowed_signers."""

    principal: str
    key_type: str
    fingerprint: str
    namespaces: str


def _run(argv: List[str], data: Optional[bytes] = None) -> subprocess.CompletedProcess:
    return subprocess.run(argv, input=data, capture_output=True, timeout=20)


def ensure_layout(layout: IdentityLayout) -> None:
    """Create the identity directory and its challenge directory, both mode 0700."""
    for directory in (layout.root, layout.challenge_dir):
        directory.mkdir(parents=True, exist_ok=True)
        os.chmod(directory, 0o700)


def key_fingerprint(public_key_text: str, binary: str = "ssh-keygen") -> str:
    """SHA256:... fingerprint of an OpenSSH public key line (`<type> <base64> [comment]`)."""
    result = _run([binary, "-l", "-f", "-"], public_key_text.encode("utf-8"))
    parts = result.stdout.decode("utf-8", "replace").split()
    if result.returncode != 0 or len(parts) < 2:
        raise ValueError(f"not a valid public key: {result.stderr.decode('utf-8', 'replace').strip()}")
    return parts[1]


def key_is_passphrase_protected(private_key: Path, binary: str = "ssh-keygen") -> bool:
    """True if reading the key needs a passphrase (an empty passphrase does not work)."""
    result = _run([binary, "-y", "-P", "", "-f", str(private_key)])
    return result.returncode != 0


def _write_private_file(path: Path, text: str) -> None:
    """Atomically write `text` to `path` with mode 0600 (temp file in the same directory, then replace)."""
    fd, tmp = tempfile.mkstemp(dir=str(path.parent), prefix=".tmp-", suffix=".new")
    try:
        with os.fdopen(fd, "w", encoding="utf-8") as handle:
            handle.write(text)
        os.chmod(tmp, 0o600)
        os.replace(tmp, path)
    except BaseException:
        if os.path.exists(tmp):
            os.unlink(tmp)
        raise


def _line(principal: str, namespace: str, key_type: str, blob: str) -> str:
    return f'{principal} namespaces="{namespace}" {key_type} {blob}\n'


def enroll_key(layout: IdentityLayout, principal: str, public_key_text: str) -> bool:
    """Enroll a public key in BOTH files (production and self-test). Returns False if already enrolled.

    Existing entries are never removed; each file keeps its own single namespace."""
    fields = public_key_text.split()
    if len(fields) < 2:
        raise ValueError("public key must look like '<type> <base64> [comment]'")
    key_type, blob = fields[0], fields[1]
    ensure_layout(layout)
    changed = False
    for path, namespace in ((layout.allowed_signers, SIGN_NAMESPACE), (layout.allowed_signers_selftest, SELFTEST_NAMESPACE)):
        existing = path.read_text(encoding="utf-8") if path.exists() else ""
        new_line = _line(principal, namespace, key_type, blob)
        if any(line.split()[-2:] == [key_type, blob] for line in existing.splitlines() if line.strip()):
            os.chmod(path, 0o600)
            continue
        _write_private_file(path, existing + new_line)
        changed = True
    return changed


def migrate_namespaces(layout: IdentityLayout) -> int:
    """Rewrite legacy bare-namespace options (`control-plane`, `control-plane-selftest`) in the human-owned
    allowed_signers files to the domain-qualified namespaces. Idempotent; keeps every key and the 0600 mode;
    returns how many lines changed. Run by the human-run setup, never by the agent."""
    changed = 0
    for path, legacy, current in (
        (layout.allowed_signers, LEGACY_SIGN_NAMESPACE, SIGN_NAMESPACE),
        (layout.allowed_signers_selftest, LEGACY_SELFTEST_NAMESPACE, SELFTEST_NAMESPACE),
    ):
        if not path.exists():
            continue
        lines = path.read_text(encoding="utf-8").splitlines(keepends=True)
        old, new = f'namespaces="{legacy}"', f'namespaces="{current}"'
        rewritten = [line.replace(old, new) for line in lines]
        count = sum(1 for a, b in zip(lines, rewritten) if a != b)
        if count:
            _write_private_file(path, "".join(rewritten))
            changed += count
    return changed


def _legacy_namespace_failures(layout: IdentityLayout) -> List[str]:
    failures: List[str] = []
    for path, legacy in ((layout.allowed_signers, LEGACY_SIGN_NAMESPACE), (layout.allowed_signers_selftest, LEGACY_SELFTEST_NAMESPACE)):
        if path.exists() and f'namespaces="{legacy}"' in path.read_text(encoding="utf-8"):
            failures.append(
                f"LEGACY_NAMESPACE: {path.name} still uses the bare namespace '{legacy}'; run setup_ciba_identity.py to migrate it."
            )
    return failures


def enrolled_keys(layout: IdentityLayout, binary: str = "ssh-keygen") -> List[EnrolledKey]:
    """Parse the production allowed_signers into (principal, type, fingerprint, namespaces)."""
    if not layout.allowed_signers.exists():
        return []
    keys: List[EnrolledKey] = []
    for line in layout.allowed_signers.read_text(encoding="utf-8").splitlines():
        line = line.strip()
        if not line or line.startswith("#"):
            continue
        tokens = shlex.split(line)
        if len(tokens) < 4:
            continue
        principal, namespaces_opt, key_type, blob = tokens[0], tokens[1], tokens[-2], tokens[-1]
        namespaces = namespaces_opt.split("=", 1)[1] if namespaces_opt.startswith("namespaces=") else ""
        keys.append(EnrolledKey(principal, key_type, key_fingerprint(f"{key_type} {blob}", binary), namespaces))
    return keys


def _verification_failures(layout: IdentityLayout, keys: List[EnrolledKey], capability: Any) -> List[str]:
    """Why cryptographic verification could not work even if the files exist: no usable ssh-keygen, an
    allowed_signers with no parseable key, or keys scoped to a namespace the gates never sign under."""
    failures: List[str] = []
    if not capability.available:
        failures.append(f"SSH_KEYGEN_UNAVAILABLE: {capability.reason or 'ssh-keygen was not found'}; install OpenSSH (>= 8.1).")
    elif not capability.supports_sshsig:
        found = ".".join(str(n) for n in capability.version) if capability.version else "unknown version"
        failures.append(f"SSHSIG_UNSUPPORTED: {found} cannot verify SSHSIG signatures ({capability.reason or 'OpenSSH >= 8.1 is required'}).")
    if layout.allowed_signers.exists() and not keys and capability.available:
        failures.append(f"NO_ENROLLED_KEYS: {layout.allowed_signers.name} contains no parseable public key; a human runs setup_ciba_identity.py to enroll one.")
    for key in keys:
        if SIGN_NAMESPACE not in key.namespaces.split(","):
            failures.append(
                f"NAMESPACE_MISMATCH: {key.principal} ({key.fingerprint}) is scoped to '{key.namespaces or 'no namespace'}', "
                f"not '{SIGN_NAMESPACE}', so no gate signature can verify against it."
            )
    return failures


def identity_status(layout: IdentityLayout, *, ssh_keygen_binary: str = "ssh-keygen", **identity: Any) -> Dict[str, Any]:
    """Read-only readiness report for cryptographic verification: isolation preflight failures, enrolled keys,
    the ssh-keygen capability and whether allowed_signers can actually verify a gate signature. Never writes."""
    result = check_isolation(
        allowed_signers=layout.allowed_signers, allowed_signers_selftest=layout.allowed_signers_selftest,
        challenge_dir=layout.challenge_dir, environ={}, **identity,
    )
    capability = probe_ssh_keygen(binary=ssh_keygen_binary)
    keys = enrolled_keys(layout, binary=ssh_keygen_binary) if capability.available and layout.allowed_signers.exists() else []
    failures = (
        [f"{f.code}: {f.message}" for f in result.failures]
        + _legacy_namespace_failures(layout)
        + _verification_failures(layout, keys, capability)
    )
    return {
        "ready": result.ok and bool(keys) and not failures,
        "enrolled_keys": len(keys),
        "keys": [k.__dict__ for k in keys],
        "failures": failures,
        "layout": str(layout.root),
        "ssh_keygen": {
            "available": capability.available,
            "supports_sshsig": capability.supports_sshsig,
            "version": ".".join(str(n) for n in capability.version) if capability.version else None,
            "reason": capability.reason,
        },
    }


def privileged_account_commands(agent_name: str = DEFAULT_AGENT_NAME, platform: str = sys.platform) -> List[str]:
    """Commands the HUMAN runs (as an administrator) to create the unprivileged agent account.
    They are printed by the setup CLI and never executed by it."""
    if platform == "darwin":
        return [
            f"sudo sysadminctl -addUser {agent_name} -fullName 'Agentic OS agent' -password -",
            f"# then run the agent as that account, e.g.: sudo -u {agent_name} <agent command>",
        ]
    if platform.startswith("win"):
        return [
            f"net user {agent_name} * /add",
            f"# run the agent as that account, e.g.: runas /user:{agent_name} <agent command>",
        ]
    return [f"sudo useradd --create-home --shell /bin/bash {agent_name}", f"# run the agent with: sudo -u {agent_name} <agent command>"]
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: 471kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall