Skip to content

richfrem/agent-plugins-skills / plugins/agent-exploration-cycle/.apm/skills/running-exploration-cycle

running-exploration-cycle

Verified

Runs the business exploration cycle end to end: starts or resumes a session (intake interview, session brief), enforces the Discovery Plan HARD-GATE, routes the four phases (Discovery Plan, Visual Blueprinting, Prototype, Handoff) to the sibling skills and keeps session state. Use when the user says "let's explore this idea", "I have an idea I want to explore", "help me plan this out", "start discovery", "resume my exploration", "where did we leave off", or starts any conversation about a need, problem or idea before building. Not for hardening an existing prototype (use reengineering-vibe-code) or for engineering build work.

FileKindSize
SKILL.mdskill md4.6 KB
assets/exploration-dashboard.mdmarkdown1.8 KB
evals/evals.jsonconfig6.0 KB
references/acceptance-criteria.mdmarkdown2.2 KB
references/architecture.mdmarkdown6.3 KB
references/design-rationale.mdmarkdown6.3 KB
references/discovery-planning-agent.mdmarkdown4.7 KB
references/discovery-planning-tracks.mdmarkdown5.9 KB
references/discovery-planning.mdmarkdown2.4 KB
references/dispatch-strategies.mdmarkdown5.7 KB
references/domain-patterns-exploration-session.mdmarkdown3.3 KB
references/domain-patterns.mdmarkdown1.7 KB
references/environment-check.mdmarkdown1.7 KB
references/exploration-cycle-orchestrator-agent.mdmarkdown16.7 KB
references/exploration-optimizer.mdmarkdown8.9 KB
references/exploration-orchestrator-guide.mdmarkdown3.7 KB
references/exploration-session-brief.mdmarkdown2.1 KB
references/exploration-workflow.mdmarkdown2.4 KB
references/hard-gate-enforcement.mdmarkdown3.3 KB
references/high-level-process.mmdother885 B
references/intake-agent.mdmarkdown12.0 KB
references/orchestrator-loop.mmdother1.3 KB
references/post-run-survey.mdmarkdown1.7 KB
references/problem-framing-agent.mdmarkdown2.7 KB
references/process-definition.mdmarkdown3.7 KB
references/process-overview.mmdother3.7 KB
references/session-setup.mmdother1.3 KB
references/state-and-gates.mmdother1.0 KB
references/using-exploration-cycle.mdmarkdown2.3 KB
requirements-dev.inother69 B
requirements.inother60 B
scripts/check_gaps.pyscript2.5 KB
scripts/dispatch.pyexecutablescript23.6 KB
scripts/exploration_session.pyexecutablescript15.9 KB
scripts/sandbox_runner.pyscript8.7 KB
scripts/smoke_test.pyscript5.1 KB
scripts/state_engine.pyscript21.9 KB
scripts/test_dispatch_authorization_gate.pyscript4.0 KB
scripts/test_dispatch_security.pyscript10.0 KB
scripts/test_exploration_integration.pyscript14.7 KB
scripts/test_integration.pyscript4.4 KB
scripts/test_path_traversal.pyscript1.8 KB
scripts/test_phase_premium_counter.pyscript2.0 KB
scripts/test_sandbox_runner.pyscript5.6 KB
scripts/test_session_start_hook.pyscript2.4 KB
scripts/test_state_engine.pyscript13.5 KB
scripts/test_validate_phase_gate.pyscript12.7 KB
scripts/validate_phase_gate.pyexecutablescript8.7 KB

scripts/check_gaps.py

View on GitHub
#!/usr/bin/env python
"""
check_gaps.py
=====================================

Purpose:
    Counts [NEEDS HUMAN INPUT] markers in one or more capture files and exits non-zero if threshold exceeded.

Layer: Analysis / Verification

Usage Examples:
    pythoncheck_gaps.py --files exploration/captures/brd-draft.md --threshold 3

Supported Object Types:
    - Markdown files (.md)

CLI Arguments:
    --files: Capture files to check.
    --threshold: Max allowed gap markers (default: 3).

Input Files:
    - Target files to check for gaps.

Output:
    - Printed gap counts and status.

Key Functions:
    - count_gaps()

Script Dependencies:
    None

Consumed by:
    - Exploration cycle dispatch chain
"""

import argparse
import os
import sys

MARKER = "[NEEDS HUMAN INPUT]"


def count_gaps(filepaths: list[str]) -> tuple[int, dict[str, int]]:
    """Count MARKER occurrences per file and in total; exit 1 if any file is missing."""
    total = 0
    per_file = {}
    missing = []
    for fp in filepaths:
        if not os.path.exists(fp):
            print(f"Error: required file not found: {fp}", file=sys.stderr)
            missing.append(fp)
            continue
        text = open(fp, encoding="utf-8").read()
        count = text.count(MARKER)
        per_file[fp] = count
        total += count
    if missing:
        print(f"\nSTOP: {len(missing)} required file(s) missing — treat as unreviewed capture(s).", file=sys.stderr)
        sys.exit(1)
    return total, per_file


def main() -> None:
    """Parse CLI arguments, count gap markers across files, and exit 1 if over threshold."""
    parser = argparse.ArgumentParser(description="Gap marker checker for exploration captures")
    parser.add_argument("--files", nargs="+", required=True, help="Capture files to check")
    parser.add_argument("--threshold", type=int, default=3, help="Max allowed gap markers (default: 3)")
    args = parser.parse_args()

    total, per_file = count_gaps(args.files)

    for fp, count in per_file.items():
        print(f"  {count:>3} gap(s)  {fp}")

    print(f"\nTotal: {total} '{MARKER}' marker(s) across {len(per_file)} file(s). Threshold: {args.threshold}.")

    if total > args.threshold:
        print(
            f"\nSTOP: {total} gaps exceed threshold of {args.threshold}. "
            "Refine the session brief and re-run from the affected pass before continuing.",
            file=sys.stderr,
        )
        sys.exit(1)

    print("OK: gap count within threshold. Safe to continue.")


if __name__ == "__main__":
    main()
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 CodeCodexVerifiedInstall
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