recipe-fix-argparse-rejection

Installation
SKILL.md

Recipe: Fix Argparse Rejection

This is a remediation recipe for the exit_code=2 / argparse_rejection defect class: a python3 .plan/execute-script.py {notation} {subcommand} … call whose subcommand or flag reads naturally in workflow prose but does not exist in the script's argparse choices, so argparse rejects it before the script body runs. The call exits 2 silently — no script-side error, no partial work — and downstream behaviour corrupts because the intended mutation never happened.

This recipe is the remediation procedure invoked after a rejection has occurred to correct the offending call site in place. It is complementary to — and deliberately does NOT duplicate — the prevention guidance in plan-marshall:persona-plan-marshall-agent § "Never invent script subcommands", which is the avoidance rule loaded into every agent context and the canonical home of the four recurrence signatures (verb-paraphrase; top-level --plan-id/--project-dir where the flag is verb-scoped; doubled bundle-prefix; missing required --phase / --resolution-vs---status confusion). Cross-reference those signatures from there rather than restating them; this recipe walks the fix once the signature has already fired.

Foundational Practices

Skill: plan-marshall:persona-plan-marshall-agent

Enforcement

Execution mode: Walk the three steps below in order — Catch → Locate → Fix-in-place. Each step has a single explicit job; do not improvise extra discovery passes or skip the locate step in favour of guessing a replacement verb.

Installs
1
GitHub Stars
5
First Seen
Jul 11, 2026
recipe-fix-argparse-rejection — cuioss/plan-marshall