triage-coding-improvements

Stars8

Forks0

UpdatedJune 11, 2026 at 06:22

Drain the fleet:coding-improvement backlog in one human-cued batch: sweep the open tickets, cluster them by target surface, triage each with the human (accept / reject / defer / escalate a doc rule into a simplify check), apply the accepted convention changes, and bundle them into one PR per run with Closes lines — never one micro-PR per ticket. The consumption side of the channel assess-coding-improvement files into. Use when the user says "triage coding improvements", "absorb the coding-improvement backlog", "work through the coding-improvement tickets", or "address the coding improvements". Cue-only — NEVER auto-run: the tickets target gated self-config (role docs, skills, review checklists) and stay un-queued precisely so a human spends the judgment; this skill is how that judgment gets spent.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

jakildev

jakildev/IrredenEngine

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name

triage-coding-improvements

description

triage-coding-improvements (Irreden Engine)

The flow lives in docs/agents/skills/triage-coding-improvements.md. Read it first, then apply the engine deltas below. This wrapper carries deltas only — see docs/design/skill-sharing.md for why.

Deltas (Irreden Engine)

Delta key	Engine value
repo	`jakildev/IrredenEngine`
convention surfaces	same ordered list as the `assess-coding-improvement` wrapper — the two skills are the two ends of one channel
automated-check surface	the `simplify` skill + its `simplify-*` subagents in `.claude/agents/`
review checklist	the engine checklist in `.claude/skills/review-pr/SKILL.md`
commit skill	`commit-and-push`
filing norms	split-out code work is filed as a plain issue with no labels (see `docs/agents/fleet-labels-reference.md` §"Issue/PR labeling discipline"); the human adds `human:approved` and `fleet-queue-ingest` queues it
scope vocabulary	`docs/fleet:` for convention-surface batches; `fleet:` when the batch extends `simplify-*` checks or fleet scripts

Engine notes

Validating an ESCALATE into a simplify-* subagent (flow Step 4): the cited Occurrence is usually a merged PR — reconstruct the bad pattern in a scratch file under the worktree, confirm the check's grep/criteria flag it, then delete the scratch file before committing.
In a headless session, .claude/ paths are blocked for Edit/Write; use fleet-edit (see docs/agents/FLEET.md §"Editing .claude/ paths in headless mode"). Normal human-cued sessions edit directly.

More from this repository

same repository

review-pr

jakildev/IrredenEngine

Review an open GitHub PR on the Irreden Engine repo and post a structured review. Use when the user says "review PR <N>", "review #<N>", "review the last PR", "check my PR", "review any new PRs", "review the PR queue", "check for new PRs to review", "review the open PRs", or otherwise asks for a code review — and also invoke automatically from a persistent reviewer-loop session when `gh pr list` surfaces a PR that has not yet been reviewed by this fleet. Designed to be invoked by a dedicated reviewer agent (dispatched into a pool worktree) whose job is to look at another agent's work with a fresh context. Writes a structured review covering ownership, ECS invariants, allocation hot paths, naming, tests, and project-specific smells, then posts it as a PR comment.

2026-07-268

simplify

jakildev/IrredenEngine

Polish the dirty working tree before committing — catch Irreden-Engine smells that a reviewer would otherwise flag. Use whenever you're about to commit, after addressing review feedback, after amending a commit, or whenever the user says "simplify", "clean up", "polish", "self-review", or "review my changes". Also auto-invoked by commit-and-push before the commit message is drafted. The skill finds per-entity getComponent in tick functions, allocation in hot loops, ECS naming convention slips, opportunities to reuse existing helpers, dead code, debug logs left behind, tautological comments, triple-nested loops over voxel volumes, renderer leaks from creation code, CPU-side SDF grid evaluation, linear-search in save/load hot paths, and stale or drifting CLAUDE.md / role / skill docs. Dispatches a parallel reuse-detection subagent fan-out so the reuse pass runs concurrently with the main checks. Applies safe fixes inline and reports anything that needs human judgment. Saves a review-fix-rereview round-trip.

2026-07-268

commit-and-push

jakildev/IrredenEngine

Stage, commit, push a feature branch, and open a GitHub PR against master for the Irreden Engine repo. Use whenever the user says "commit", "commit my changes", "commit and push", "open a PR", "make a PR", "wrap up this chunk", or otherwise indicates the current slice of work is ready for review. The skill assumes the parallel-agent workflow where work happens on short-lived feature branches, another agent reviews the PR, and the user merges via the GitHub UI. NEVER commit directly to master.

2026-07-218

platform-catchup

jakildev/IrredenEngine

Process the backlog of `fleet:needs-<host>-smoke` PRs on the current host. Builds a representative demo cohort against current `origin/master`, runs each with `--auto-screenshot`, and on green batch-swaps `fleet:needs-<host>-smoke` → `fleet:verified-<host>` on every eligible merged PR. On red (build break), files / opens a fix PR for the offender and holds labels on PRs that touch the implicated source paths until the fix lands. On partial (per-demo runtime hang or crash but build green), sweeps the rest, then fix-forwards the offending demo this session (issue only as the documented fallback). Runs on Linux, macOS, AND native Windows (MSYS2 mingw64) — Windows is now the primary validation host. Use when the human cues "platform-catchup", "catch up smoke tests", or "catch up Windows builds". Skill is **cue-only**, never auto-run — multi-target builds and ~40-demo runs are expensive, the human chooses when to spend them.

2026-07-158

render-debug-loop

jakildev/IrredenEngine

Build, run, and visually evaluate a rendering demo in an automated loop. Captures screenshots across a demo's configured shot list (zoom, camera offset, render-mode combinations), reads each image, diagnoses rendering issues against a topic-indexed reference (trixel / SDF shapes, lighting, backend parity), applies fixes, and repeats. Use whenever iterating on render pipeline bugs, shape alignment, lighting, parity drift, or any visual regression in the engine.

2026-07-158

render-verify

jakildev/IrredenEngine

Automated pass/fail render-regression harness for Irreden Engine demos. Wraps build → run → capture → compare → report: builds a demo, runs it with `--auto-screenshot`, then compares each shot against a committed reference image using a stdlib-only Python comparator. Reports per-shot pass/fail with diff images written for mismatches. Use after any render pipeline change to catch visual regressions automatically, or as a sanity pass on `master` before cutting releases.

2026-07-158

name

triage-coding-improvements

description

triage-coding-improvements (Irreden Engine)

Deltas (Irreden Engine)

Delta key	Engine value
repo	`jakildev/IrredenEngine`
convention surfaces	same ordered list as the `assess-coding-improvement` wrapper — the two skills are the two ends of one channel
automated-check surface	the `simplify` skill + its `simplify-*` subagents in `.claude/agents/`
review checklist	the engine checklist in `.claude/skills/review-pr/SKILL.md`
commit skill	`commit-and-push`
filing norms	split-out code work is filed as a plain issue with no labels (see `docs/agents/fleet-labels-reference.md` §"Issue/PR labeling discipline"); the human adds `human:approved` and `fleet-queue-ingest` queues it
scope vocabulary	`docs/fleet:` for convention-surface batches; `fleet:` when the batch extends `simplify-*` checks or fleet scripts

Engine notes

Validating an ESCALATE into a simplify-* subagent (flow Step 4): the cited Occurrence is usually a merged PR — reconstruct the bad pattern in a scratch file under the worktree, confirm the check's grep/criteria flag it, then delete the scratch file before committing.
In a headless session, .claude/ paths are blocked for Edit/Write; use fleet-edit (see docs/agents/FLEET.md §"Editing .claude/ paths in headless mode"). Normal human-cued sessions edit directly.