challenge-plans

Solid

Before you execute a drafted plan/spec/design doc, run a multi-agent adversarial cross-review to surface the flaws that cause downstream rework, aggregating "evidenced, cross-family-verified" objections into a verdict. Use when the user asks to "review this plan/spec", "can this approach be executed", "poke holes / adversarial review / QA this", "harden before executing", or when an agent is about to hand a drafted decision/QA back to the user — first run this skill and present the cross-review recommendation plus surviving objections. Runs on local subscription CLIs (claude/codex), no per-token API cost. Not for "help me pick among options" — that's the weigh-options deliberation skill.

AI & Automation 4 stars 0 forks Updated 6 days ago Apache-2.0

Install

View on GitHub

Quality Score: 80/100

Stars 20%
23
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# challenge-plans Harden a plan/spec in multi-agent adversarial review before execution, to reduce rework. Slots into `writing-plans → challenge-plans → executing-plans`. ## When to use (routing signals) - Input is a **single drafted artifact** + intent "review / find flaws / can this execute / harden / QA" → **use this skill**. Pick `--type` by what the artifact *is*: - a **spec / design doc / PRD** you're about to build → `--type spec` - **any plan with steps** to execute (dev or not — a trip, a launch, a hire) → `--type plan` - a **code change** (`git diff`) → `--type diff` - a **decision already made** (an ADR / "we chose X because Y" — a tech-stack pick, a vendor, a hire) → `--type decision`. Audits the *choice itself*: skipped alternatives, weak evidence, sunk-cost reasoning, irreversibility. - An agent has finished something and is **about to ask the user to decide or QA** → run this first and present the cross-review recommendation. - Input is **≥2 options still open to choose among** → use the sibling `weigh-options` (deliberation/voting), not this. (`--type decision` is the opposite: one option *already* chosen, audited after the fact.) ## Run ```bash # Installed from PyPI (pip install challenge-plans) — the console command is available directly. # Already installed but on an old version? update: pip install -U challenge-plans (pipx: pipx upgrade; uvx: append @latest). challenge-plans doctor # c...

Details

Author
hiadrianchen
Repository
hiadrianchen/challenge-plans
Created
1 months ago
Last Updated
6 days ago
Language
Python
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

plan-review

Review .context/plans/*.md files using 3 independent subagent reviewers: Technical (feasibility, gaps, soundness), Strategic (scope, alignment, priority), and Risk (blind spots, edge cases, failure modes). The skill FIRST asks the user which models to assign to each reviewer — presenting available options based on the user's environment (OpenCode Zen, Go, Claude Code, or BYOK). Each reviewer receives the same plan with a role-specific lens and returns structured feedback. The main agent consolidates all three perspectives. Triggers: 'review this plan', 'audit plan', 'plan review', 'check my plan', 'what's wrong with this plan', 'review all plans', 'plan quality check'. Do NOT use for plans not in .context/plans/, one-off notes, or external documents.

2 Updated today
pantheon-org
AI & Automation Listed

plan-review

Triggered by /plan-review <path-to-plan> [path-to-reviews] [--auto-accept] or /init [god-mode]. Handles git init, CLAUDE.md, folder setup, and model-mode selection (/init), then reads a human plan and optional agent reviews, builds a unified issues table, runs the resolution loop, and writes the resolved draft to docs/pre-plans/. When done, tells the developer to start a new terminal session and run /plan-finalize. With --auto-accept, skips the resolution loop, accepts every recommendation, and runs the plan-finalize logic in the same session.

1 Updated 1 weeks ago
orassayag
AI & Automation Listed

codex-plan-review

Cross-provider adversarial review of a finalized plan, spec, design doc, or ADR using OpenAI Codex (GPT-5.6 Terra). AUTO-TRIGGER at plan gates — invoke this skill immediately after any of: (1) a brainstorming spec is written and user-approved, (2) a writing-plans implementation plan is finalized, (3) an ADR draft is completed, (4) an SDD plan is confirmed at its gate. Also AUTO-TRIGGER for code: after implementing a Codex-reviewed plan, run diff mode on the branch range before opening the PR — a reviewed plan is NOT a reviewed diff (proven: a branch that passed 3 plan rounds + an audit still shipped 3 real bugs that diff mode caught). Also invoke on request — "codex review this plan", "codex review this diff", "get a second opinion on this design", "terra review". Runs a bounded verdict loop (max 3 rounds + 1 audit) via the local codex CLI; each chain burns ChatGPT-subscription quota, so never re-run on the same artifact without an explicit user ask.

2 Updated today
jasonm4130