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/snapshot.py

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

Purpose:
    Content snapshot and content-bound `revision_hash` for Gate 1
    (AWAITING_APPROVAL -> APPROVED) of auth-ciba-increment-b (issue #639, task T2,
    design gap (b) of DEBT-20260918-TRANSITION-REQUEST-DESIGN-GAPS). At Gate 1 the
    reviewed artifacts are documents (the spec and implementation plan under
    `docs/plans/work-tasks/<task-id>/`); no worktree or diff exists yet. A human
    approval must therefore bind those exact files, so that changing either one
    after the request invalidates the approval. The snapshot is an ordered list of
    (label, sha256) pairs; the same list is hashed into `revision_hash`, stored on
    the `transition_request` row as JSON, and later displayed in the challenge
    (T3/T6) and compared against the live files at approval time (T4).

Key Input Dependencies:
    - Python stdlib only (hashlib, json, dataclasses, pathlib)
    - The repository root and the task id (to locate the two plan artifacts)

Key Functions:
    - gate1_artifact_paths() -- the ordered (label, path) pairs for spec and plan.
    - code_acceptance_snapshot() -- Gate 3: HEAD sha, tracked-diff hash, untracked-files hash of a git worktree.
    - build_snapshot() -- read and hash artifacts; fails closed on missing, non-regular
      or symlinked files.
    - compute_revision_hash() -- content-bound hash; with no snapshot it reproduces the
      Increment A metadata-only formula unchanged.
    - snapshot_to_json() / snapshot_from_json() -- canonical JSON round trip.
    - snapshot_matches() / diff_snapshot() -- compare a stored snapshot with live content.

Constants:
    - CHALLENGE_VERSION -- format tag stored with the request ("control-plane-challenge/1").
"""

import hashlib
import json
import os
import re
import subprocess
from dataclasses import dataclass
from pathlib import Path
from typing import Any, Dict, List, Optional, Sequence, Tuple, Union

CHALLENGE_VERSION = "control-plane-challenge/1"

# Ordered artifact labels and their file-name templates under the task's work-tasks folder.
GATE1_ARTIFACTS: Tuple[Tuple[str, str], ...] = (
    ("spec", "{task_id}-spec.md"),
    ("plan", "{task_id}-implementation-plan.md"),
)


class SnapshotError(Exception):
    """A required artifact is missing, not a regular file, or is a symlink."""


@dataclass(frozen=True)
class SnapshotEntry:
    """One bound artifact: its label and the SHA-256 of its bytes."""

    label: str
    sha256: str


def get_canonical_manifest_path(repo_root: Union[str, Path], task_id: str) -> Path:
    """Return the single canonical manifest path under docs/plans/work-tasks/<task-id>/."""
    folder = Path(repo_root) / "docs" / "plans" / "work-tasks" / task_id
    primary = folder / f"{task_id}-graph-manifest.json"
    fallback = folder / "graph-manifest.json"
    return primary if primary.is_file() else fallback


def resolve_task_strategy(
    repo_root: Union[str, Path],
    task_id: str,
    task: Optional[Dict[str, Any]] = None,
) -> str:
    """Single canonical strategy resolver per task across snapshot and coordinator.

    Evaluation order:
    1. Task-scoped strategy decision artifact:
       docs/plans/work-tasks/<task-id>/<task-id>-strategy-decision.json or select-loop-strategy-decision.json
    2. Explicit strategy from task dictionary / DB
    3. Pattern artifact existence (manifest -> graph, job -> agent-swarm, packet -> dual-loop)
    4. Default: 'direct'
    """
    folder = Path(repo_root) / "docs" / "plans" / "work-tasks" / task_id

    # 1. Task-scoped decision artifact
    for cand_name in (
        f"{task_id}-strategy-decision.json",
        "select-loop-strategy-decision.json",
        "strategy-decision.json",
    ):
        dec_file = folder / cand_name
        if dec_file.is_file():
            try:
                data = json.loads(dec_file.read_text(encoding="utf-8"))
                if isinstance(data, dict) and data.get("pattern"):
                    return str(data["pattern"]).strip().lower()
            except Exception:
                pass

    # 2. Explicit task metadata
    if task:
        strat = task.get("strategy")
        if strat and isinstance(strat, str) and strat.strip():
            return strat.strip().lower()

    # 3. Task plan header
    plan_file = folder / f"{task_id}-implementation-plan.md"
    if plan_file.is_file():
        try:
            for line in plan_file.read_text(encoding="utf-8").splitlines():
                m = re.match(r'^\s*[-*]?\s*(?:[eE]xecution\s+[sS]trategy|[sS]trategy)\s*:\s*([a-zA-Z0-9_-]+)', line)
                if m:
                    return m.group(1).lower()
        except Exception:
            pass

    # 4. Pattern artifact existence
    if get_canonical_manifest_path(repo_root, task_id).is_file():
        return "graph"
    if (folder / f"{task_id}.job.md").is_file():
        return "agent-swarm"
    if (Path(repo_root) / "handoffs" / f"task_packet_{task_id}.md").is_file():
        return "dual-loop"

    return "direct"


def gate1_artifact_paths(
    repo_root: Union[str, Path],
    task_id: str,
    strategy: Optional[str] = None,
    task: Optional[Dict[str, Any]] = None,
) -> Tuple[Tuple[str, Path], ...]:
    """Return ((label, path), ...) for the spec and plan under docs/plans/work-tasks/<task-id>/,
    plus the canonical graph-manifest.json when strategy is graph."""
    folder = Path(repo_root) / "docs" / "plans" / "work-tasks" / task_id
    paths = list((label, folder / name.format(task_id=task_id)) for label, name in GATE1_ARTIFACTS)

    if strategy is None:
        strategy = resolve_task_strategy(repo_root, task_id, task=task)

    manifest_path = get_canonical_manifest_path(repo_root, task_id)
    if strategy == "graph":
        if not manifest_path.is_file():
            raise SnapshotError(
                f"Strategy 'graph' requires canonical manifest at '{manifest_path}' before Gate 1 can be signed."
            )
        paths.append(("manifest", manifest_path))

    return tuple(paths)


def build_snapshot(paths: Sequence[Tuple[str, Union[str, Path]]]) -> Tuple[SnapshotEntry, ...]:
    """Hash each (label, path) in order. Raises SnapshotError instead of skipping a file."""
    entries: List[SnapshotEntry] = []
    for label, raw in paths:
        path = Path(raw)
        if path.is_symlink():
            raise SnapshotError(f"{label}: {path} is a symlink; refusing to bind it")
        if not path.is_file():
            raise SnapshotError(f"{label}: {path} is missing or not a regular file")
        entries.append(SnapshotEntry(label=label, sha256=hashlib.sha256(path.read_bytes()).hexdigest()))
    return tuple(entries)


def compute_revision_hash(
    task_id: str,
    from_state: str,
    to_state: str,
    occupancy_id: int,
    nonce: str,
    snapshot: Optional[Sequence[SnapshotEntry]] = None,
) -> str:
    """Return the request's revision_hash.

    Without a snapshot this is exactly the Increment A formula (transition metadata plus
    nonce), so existing callers are unaffected. With a snapshot the ordered content
    hashes are appended, binding the approval to the reviewed files."""
    material = f"{task_id}:{from_state}:{to_state}:{occupancy_id}:{nonce}"
    if snapshot:
        material += "||" + "|".join(f"{entry.label}={entry.sha256}" for entry in snapshot)
    return hashlib.sha256(material.encode("utf-8")).hexdigest()


def snapshot_to_json(snapshot: Sequence[SnapshotEntry]) -> str:
    """Canonical compact JSON (ordered list of {label, sha256})."""
    return json.dumps(
        [{"label": entry.label, "sha256": entry.sha256} for entry in snapshot], separators=(",", ":")
    )


def snapshot_from_json(text: str) -> Tuple[SnapshotEntry, ...]:
    """Inverse of snapshot_to_json(). Malformed input raises SnapshotError."""
    try:
        return tuple(SnapshotEntry(label=item["label"], sha256=item["sha256"]) for item in json.loads(text))
    except (ValueError, KeyError, TypeError) as exc:
        raise SnapshotError(f"stored content snapshot is malformed: {exc}") from exc


def snapshot_matches(stored_json: str, live: Sequence[SnapshotEntry]) -> bool:
    """True only when the live entries equal the stored ones, same order and hashes."""
    return snapshot_from_json(stored_json) == tuple(live)


def diff_snapshot(stored_json: str, live: Sequence[SnapshotEntry]) -> List[str]:
    """Labels whose hash differs, or that were added or removed, versus the stored snapshot."""
    stored = {entry.label: entry.sha256 for entry in snapshot_from_json(stored_json)}
    current = {entry.label: entry.sha256 for entry in live}
    changed = [label for label in stored if current.get(label) != stored[label]]
    changed += [label for label in current if label not in stored]
    return changed


# ---------------------------------------------------------------- code acceptance (Gate 3)
_GIT_TIMEOUT_SECONDS = 60


def _git(worktree: Path, *args: str) -> bytes:
    """Run a read-only git command in the worktree; a failure is a SnapshotError, never a partial hash."""
    try:
        done = subprocess.run(
            ["git", "-C", str(worktree), "-c", "core.quotepath=off", *args],
            capture_output=True, timeout=_GIT_TIMEOUT_SECONDS, check=False,
        )
    except (OSError, subprocess.TimeoutExpired) as exc:
        raise SnapshotError(f"git could not be run in {worktree}: {exc}") from exc
    if done.returncode != 0:
        raise SnapshotError(f"git {' '.join(args)} failed in {worktree}: {done.stderr.decode('utf-8', 'replace').strip()[:200]}")
    return done.stdout


def code_acceptance_snapshot(worktree: Union[str, Path]) -> Tuple[SnapshotEntry, ...]:
    """What a human accepts at Gate 3: the commit SHA, the SHA-256 of the tracked diff against HEAD, and the
    SHA-256 of the untracked (non-ignored) files' names and contents. A plain `git diff` omits new untracked
    files, so they are bound separately; symlinks are hashed by their target, never followed."""
    root = Path(worktree)
    if not root.is_dir():
        raise SnapshotError(f"the registered worktree {root} is not a directory")
    head = _git(root, "rev-parse", "HEAD").decode("utf-8").strip()
    diff = _git(root, "diff", "HEAD", "--binary", "--no-ext-diff", "--no-textconv")
    names = sorted(n for n in _git(root, "ls-files", "--others", "--exclude-standard", "-z").decode("utf-8", "surrogateescape").split("\0") if n)
    lines: List[str] = []
    for name in names:
        path = root / name
        if path.is_symlink():
            digest = "symlink:" + hashlib.sha256(os.readlink(path).encode("utf-8", "surrogateescape")).hexdigest()
        else:
            digest = hashlib.sha256(path.read_bytes()).hexdigest()
        lines.append(f"{name}\0{digest}")
    return (
        SnapshotEntry("head", head),
        SnapshotEntry("tracked_diff", hashlib.sha256(diff).hexdigest()),
        SnapshotEntry("untracked", hashlib.sha256("\n".join(lines).encode("utf-8", "surrogateescape")).hexdigest()),
    )
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