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/test_phase_premium_counter.py
View on GitHub"""
Purpose:
Unit test verifying that premium-call budget tracking in state_engine is
scoped per-phase, so a later phase's premium tasks aren't blocked by an
earlier phase's counter.
Key Input Dependencies:
- state_engine.py module (init_db, create_session, add_task, lease_task,
record_premium_call)
- pytest tmp_path fixture
"""
import pytest
from pathlib import Path
import sys
sys.path.insert(0, str(Path(__file__).parent))
from state_engine import init_db, create_session, add_task, lease_task, record_premium_call
def test_premium_calls_are_tracked_per_phase(tmp_path):
"""Phase 2 premium tasks must not be blocked by phase 1's counter."""
db = tmp_path / "test.sqlite"
conn = init_db(str(db))
sid = "session-1"
create_session(conn, sid, "test")
# Phase 1: add a premium task, lease it, record the premium call
add_task(conn, "t1", sid, 1, "phase-1", "comp-a", requires_premium=True)
assert lease_task(conn, "t1", "agent-a") is True
record_premium_call(conn, sid, phase_ordinal=1)
# Phase 2: should have a fresh budget — not blocked by phase 1
add_task(conn, "t2", sid, 2, "phase-2", "comp-b", requires_premium=True)
assert lease_task(conn, "t2", "agent-b") is True, \
"Phase 2 premium task blocked by phase 1 counter — per-phase tracking broken"
def test_non_premium_task_not_gated(tmp_path):
"""Tasks without requires_premium=True must ignore the premium call counter."""
db = tmp_path / "test.sqlite"
conn = init_db(str(db))
sid = "session-2"
create_session(conn, sid, "test")
# Saturate phase 1 premium counter
add_task(conn, "tp1", sid, 1, "phase-1", "premium-comp", requires_premium=True)
assert lease_task(conn, "tp1", "agent-x") is True
record_premium_call(conn, sid, phase_ordinal=1)
# A normal task in phase 1 should still lease fine
add_task(conn, "tn1", sid, 1, "phase-1", "normal-comp", requires_premium=False)
assert lease_task(conn, "tn1", "agent-y") is True
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 |