richfrem/agent-plugins-skills / plugins/agent-exploration-cycle/.apm/skills/running-exploration-cycle
running-exploration-cycle
VerifiedRuns 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.
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()
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 | Verified | 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 |