SimpleModule: Skill for Claude Code

verify-feature

Run this skill after a feature is implemented and committed locally. It is a gated pipeline — each stage must pass before the next runs. If any stage fails, stop, surface the failure, and do NOT open a PR.

Inputs to gather first

Before starting, confirm these from conversation context (do not ask the user unless missing):

• Feature description — what was implemented (used to pick the page and assertions for stage 2)
• Page route — the Inertia route (e.g. AuditLogs/Browse) or URL path to exercise
• Branch — current branch (must not be main)

If route/path is unknown, grep the diff for Inertia.Render("...") calls to infer it.

Stage 1 — Start the application

The host listens on https://localhost:5001 (see CLAUDE.md). Free the port if held, then start the app in the background.

# 1. Kill anything bound to 5001 (TCP). lsof returns nothing if the port is free.
PORT_PIDS=$(lsof -ti tcp:5001 2>/dev/null || true)
if [ -n "$PORT_PIDS" ]; then
  echo "Port 5001 occupied by PID(s): $PORT_PIDS — killing"
  kill -9 $PORT_PIDS
  sleep 1
fi

# 2. Start the host. Use Bash with run_in_background=true so the process keeps running.
dotnet run --project template/SimpleModule.Host

Run the dotnet run command via Bash with run_in_background: true. Capture the shell ID — you will need it to stop the app later.

Wait for readiness. Poll the health endpoint with curl (-k because the cert is self-signed) until it returns 200, then continue. Cap the wait at 90 seconds.

for i in $(seq 1 45); do
  if curl -sk -o /dev/null -w "%{http_code}" https://localhost:5001/ | grep -qE '^(200|302|401)$'; then
    echo "App is up"; break
  fi
  sleep 2
done

If readiness times out, read the background shell's output, surface the error, and abort the skill.

Stage 2 — Verify the feature with playwright-cli

Use the playwright-cli skill's commands directly (already documented in .claude/skills/playwright-cli/SKILL.md). The cert is self-signed; open with --ignore-https-errors via the run-code escape if needed, otherwise just navigate — playwright-cli accepts self-signed certs by default.