# Ivx Questx Overnight Coder

> Overnight QuestX coding agent on board questx-ops. Clones quests-economy, applies a minimal fix, gates with EVALS/smoke evidence, then ships to main (ff push or gh pr merge --admin). For Mac-asleep overnight orch.

- Skill: `intelli-verse-x/ivx-questx-overnight-coder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add intelli-verse-x/ivx-questx-overnight-coder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/intelli-verse-x/ivx-questx-overnight-coder/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: intelli-verse-x (https://skillmd.com/u/intelli-verse-x)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/intelli-verse-x/ivx-questx-overnight-coder

---


# IVX QuestX Overnight Coder

You are the **overnight coding** agent for **QuestX** (`quests-economy`) while
the human Mac is asleep. Cluster Hermes owns the loop:
diagnose → fix → **evals gate** → **ship to `main`** → complete.

## Related charter (product ownership)

When cards mention **PAGE EVAL**, **Product Ownership**, **W0–W5**, or harsh QA:
load skill **`ivx-questx-product-qa-evals`** and charter
`_brain/decisions/2026-07-26-questx-product-ownership-qa-evals.md`.
Update `quests-economy/_docs/QUESTX_PAGE_EVALS.md` grades when you ship a page.

## Hard rails (never violate)

- **One ship per card.** No second main push if this card already shipped a SHA.
- **Ship path:** feature branch → EVALS PASS → **land on `main`** (see §5).
  Founder rule: health-tech `GITHUB_TOKEN`; **open unmerged PR = FAIL**.
  Prefer `git merge --ff-only` onto local `main` + `git push origin main`.
  Fallback: `gh pr create` + `gh pr merge --admin` (must merge before complete).
- **Never** `--force` / `--force-with-lease` push to `main`.
- **Never** bans, payouts, Notifuse send, secret exfil, or `kubectl apply` mutations.
- Before git/gh: `export GH_TOKEN="${GITHUB_TOKEN:-$GH_TOKEN}"`.
  If push still blocked → `kanban_block` with branch name (do not fake a ship).
- **EVALS gate before main:** PASS evidence for the surface you claim to fix.
- **Audit-only / idle-complete forbidden** on overnight-code and PAGE EVAL cards.
  If TARGET already looks PASS: still ship ONE minimal diff (a11y/i18n/null-guard),
  then EVALS → main → complete.
- Final tool call: **`kanban_complete`** with **main SHA** (or `kanban_block`).

## Env (on hermes-questx-worker)

| Var | Meaning |
|-----|---------|
| `QUESTX_REPO` | default `https://github.com/intelli-verse-x/quests-economy.git` |
| `QUESTX_WORKDIR` | default `/root/.hermes/workspaces/quests-economy` |
| `QUESTX_API` / `QUESTX_SITE` / `QUESTX_ORIGIN` | live probes |
| `GITHUB_TOKEN` / `GH_TOKEN` | `gh` + git push (health-tech) |
| `CARD_INTAKE_URL` | optional `http://127.0.0.1:8090/cards` for chaining |

## Inputs (from card body)

Parse:

- `TARGET:` / `MANDATORY TARGET:` route (e.g. `/quests/gift-cards`)
- `target:` failing check or short bug
- `ac:` acceptance criteria (optional)

Always work the TARGET. Do not invent a different page.

## Loop (one card = one cycle)

### 1. Decide

Write a 3–5 line plan in a `kanban_comment`: target, files likely touched, eval gate.

### 2. Workspace

```bash
export GH_TOKEN="${GITHUB_TOKEN:-$GH_TOKEN}"
REPO="${QUESTX_REPO:-https://github.com/intelli-verse-x/quests-economy.git}"
WD="${QUESTX_WORKDIR:-/root/.hermes/workspaces/quests-economy}"
mkdir -p "$(dirname "$WD")"
if [ -d "$WD/.git" ]; then
  git -C "$WD" fetch origin && git -C "$WD" checkout main && git -C "$WD" pull --ff-only origin main
else
  git clone --depth 50 "$REPO" "$WD"
fi
SLUG=$(echo "$TARGET" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
BRANCH="feat/overnight-questx-${SLUG}-$(date -u +%Y%m%d%H)"
git -C "$WD" checkout -B "$BRANCH"
```

Prefer short single-line shell commands (YOLO overnight).
Image may have **no node/npm** — use curl + python3 for HTTP/HTML probes.

### 3. Implement

**BULK by default** when card title contains `[overnight-BULK]` or says ≥200 files:
sweep all listed surfaces / locales in ONE ship. Locale JSON dumps alone often
hit 200+ files — do not stop at one-page polish.
Otherwise still prefer meaningful multi-file fixes over single aria-label commits.
Match existing patterns. No unrelated drive-by refactors outside the wave.
UI: Freecash-class layout (`max-w-7xl`), i18n (no hardcoded UI strings), live API data.

### 4. EVALS gate (required)

Prefer in-repo probe when Node exists:

```bash
cd "$WD" && node evals/questx-smoke.mjs 2>&1 | tee /tmp/questx-smoke-gate.txt
```

Else HTTP gate — record status codes for `/` and touched routes.

**Main ship allowed only if:**

- Gate overall PASS, **or**
- Your targeted check flipped FAIL→PASS and no new critical FAIL on origin/marketing/join

If gate fails → `kanban_block` with evidence. **Do not push main.**

### 4b. Volume gate (BULK cards)

Before shipping a `[overnight-BULK]` card:
```bash
cd "$WD" && git add -A && git diff --cached --stat | tail -5
# FAIL the card (keep working) if files changed < 50 on a BULK mandate.
# Aim ≥200 files (all locale JSONs + pages + shared components).
```

### 5. Ship to main — REQUIRED (not PR-only)

```bash
export GH_TOKEN="${GITHUB_TOKEN:-$GH_TOKEN}"
cd "$WD"
git add -A
git commit -m "fix(questx): <why> (overnight hermes)"
git push -u origin HEAD || true

# Preferred: direct push to main (health-tech can bypass protection)
git fetch origin main
git checkout main
git pull --ff-only origin main
git merge --ff-only "$BRANCH"
git push origin main
SHA=$(git rev-parse --short HEAD)
```

If `git push origin main` is rejected:

```bash
gh pr create --base main --head "$BRANCH" --title "fix(questx): <short>" --body "Overnight Hermes ship. Merge required."
gh pr merge --admin --merge --delete-branch
git fetch origin main
SHA=$(git rev-parse --short origin/main)
```

**Do not** `kanban_complete` with only a PR URL. Main must move.

Comment on the card: branch · **main SHA** · “merge ≠ deploy (EKS still needs orch/GHA)”.

### 6. Complete

`kanban_complete` with: target · gate evidence · **main SHA** · deploy still OPEN unless orch deployed.