tend: Instructions file for Codex

AGENTS.md

Mission

This repo publishes the tend skill pack: local, on-demand maintenance skills for SvelteKit + TypeScript repos. There is no build, no tests, no runtime of its own. The deliverable is the contents of skills/*. Every skill shares one shape (config → triage → scan → fix → verify, one atomic change per run, never commit) and one shared config file (.claude/tend/config.yaml, schema owned by tend-onboard). Changes should be judged by: would a stranger who installs one of these skills into their own SvelteKit repo get a correct, safe, minimal fix out of it?

Layout convention

• One directory per skill under skills/<name>/, name: in frontmatter matching the directory name exactly.
• Every skill follows the same phase structure: 0. Load config → 1. Triage (MANDATORY READ a core reference) → 2. Scan (stop at first real hit; module-gated checks load only when their module is active) → 3. Fix (one atomic, verified change) → 4. Verify & present (re-run checks, show diff, never commit) → ## NEVER (3-line **NEVER**/**Instead:**/**Why:** format). Keep new skills or edits to existing ones in this shape: it's load-bearing, not decorative; tend-onboard's config schema and every other skill's Phase 0 wording assume it.
• Structured-findings skills (tend-security, tend-refactor, tend-tests) ship scripts/validate-*.mjs + assets/*.json. Diff-is-the-finding skills (tend-perf, tend-a11y, tend-docs) don't. Don't add a validator to one of these without updating this file's reasoning for why not.
• Every skill ships evals/eval-N/{prompt,assertions}.md. See ai-forge-eval in the source repo (orakl) for the assertion format if extending.
• Every skill sets disable-model-invocation: true in frontmatter: user-invoked only (/tend-security, etc.), never auto-triggered from conversation. This is the design decision behind the whole pack (single-skill, on-demand, human-paced runs replacing an unattended CI fleet that produced an 84-PR backlog). A skill that auto-triggers reintroduces the unattended-breadth failure mode the pack exists to avoid. New skills must set this flag too; don't add trigger-phrase language to a description once this flag is set, it's dead weight since auto-matching never runs.
• skills/tend-onboard/assets/tend-sweep.yml is a copy-out template for consuming repos, installed (opt-in, cadence-adjusted) by tend-onboard's Phase 4. Never turn the template into a live workflow in this repo; the only workflow here is the Release workflow (see Releasing below).