bug-reproduce-test

bug-reproduce-test

Second step of the bug-fix flow. Reads the Context already in SPEC.md, builds a minimal PHP reproduction, converts it into a .phpt test under $PHP_SRC_DIR, runs it, and asserts it FAILS (TDD).

Inputs

1. SPEC.md in the task directory resolved per _shared/task-dir.md (env var → .current → cwd) with type: bug and Context phase done. Refuse otherwise.
2. $PHP_SRC_DIR with a built sapi/cli/php.

What it produces

• repro.php — minimal standalone reproduction script in the task directory, for the user's eyeballing
• $PHP_SRC_DIR/<tests-path>/ghNNNNN.phpt — the new test, following the conventions of the surrounding directory
• Updated SPEC.md: Reproduction phase populated, status → done once post-guardrail is green

Phase owned

Reproduction.

Steps this skill adds:

• repro-script — minimal repro.php reproduces the issue against $PHP_SRC_DIR/sapi/cli/php. Notes observed vs expected.
• phpt-failing — .phpt test created at the appropriate path; run-tests.php returns failure.

Workflow

1. Pre-guardrails

• SPEC.md exists and has type: bug. If type: idea, refuse with: idea SPECs don't use bug-reproduce-test.
• Context phase is done. If not, refuse with: Run /bug-context first.
• Research phase soft-check: if a Research phase exists with status todo, print one warning line and proceed:

  ⚠ Research phase still todo. Run /research first for prior-art (or mark it `skipped` in SPEC.md to silence this warning).
  

  done, skipped, or blocked → no warning. Status done → read Research findings; they may already pin a subsystem or hint at a prior test that captures the bug.
• Reproduction phase is todo or in-progress. If done, refuse with: Reproduction phase is already done. Run /bug-fix next. If blocked, refuse with: Reproduction is blocked: <reason>. Resolve before retrying.
• $PHP_SRC_DIR/sapi/cli/php exists. If missing, do not auto-build — output the build commands and stop:

  $PHP_SRC_DIR/sapi/cli/php missing. Build it first:
    cd "$PHP_SRC_DIR"
    ./buildconf
    ./configure --enable-debug
    make -j$(nproc)
  

• target_branch matches the checked-out branch. Read target_branch from SPEC.md frontmatter. If set (not null) and not equal to git -C "$PHP_SRC_DIR" rev-parse --abbrev-ref HEAD, refuse with:

  SPEC.md target_branch is <X>; $PHP_SRC_DIR is on <Y>.
  Switch with:
    git -C "$PHP_SRC_DIR" checkout <X>
    cd "$PHP_SRC_DIR" && make -j$(nproc)
  …or update target_branch in SPEC.md if the resolution was wrong.
  

  Do not auto-switch branches (CLAUDE.md: "Executing actions with care" — branch swaps trigger rebuilds the user may not want unprompted).
• If target_branch: null (resolver couldn't decide), refuse with: target_branch is null in SPEC.md. Resolve the Open Question raised by /bug-context before reproducing.