w2ur

w2ur/claude-code-setup

Instructions file

Instructions for w2ur/claude-code-setup, covering claude.md — global instructions, language, planning and execution, bug handling and sub-agents.

w2ur/claude-code-setup

Agent

Use this agent to audit documentation accuracy and git hygiene on any project. Cleans up plan files committed by mistake, verifies .gitignore coverage, checks README and CLAUDE.md accuracy against actual project state, and optionally verifies URLs match canonical domains. Examples: "Run docs-checker" — full audit "Run…

w2ur/claude-code-setup

Agent

A naive bilingual FR/EN visitor who discovers a website with zero context, writes a first-impression report, then reads the project's README to react to the gap between perception and intent. Examples: "Run dummy-visitor https://budget.example.com /Dev/my-budget-app" — full visit + informed reaction "Run dummy-visitor…

w2ur/claude-code-setup

Agent

Executes well-scoped implementation tasks with clear specifications. Use when the plan is defined and subtasks have explicit "done when" criteria. Not for architecture decisions or ambiguous tasks.

w2ur/claude-code-setup

Agent

Audits a project against the global portfolio standards (author signature, gitignore, no secrets, no dead code, test file placement). Use before releases or during compliance sweeps.

w2ur/claude-code-setup

Agent

Validates the stories collection frontmatter across the portfolio hub (/Dev/{portfolio-site}). Everything this agent used to do around .portfolio.yml manifests and portfolio-apps.json generation was retired by decision M12 — Layer 1 (build-inventory.mjs) now observes repo state and Layer 3 (editorial.ts) now owns tile…

w2ur/claude-code-setup

Agent

Diagnoses structural problems after implementation has failed twice. Evaluates root cause, recommends solutions including rearchitecture, stack changes, or rewrites. Does NOT write production code — produces a plan for the implementer.

w2ur/claude-code-setup

Command

Run docs-checker and portfolio-audit in parallel on the current project. Optionally specify a canonical URL.

w2ur/claude-code-setup

Command

What needs you today across every tracked source — a queue, not a dashboard. Names the commands that would clear the top items; runs none of them.

w2ur/claude-code-setup

Command

Sweep /.claude disk hygiene to stated retentions, clean up stale plans from repos, audit plugin health, and compact agent memory files.

w2ur/claude-code-setup

Command

Scaffold a new app in /Dev with full portfolio compliance from day one.

w2ur/claude-code-setup

Command

Execute the next unblocked task from a master plan track, then stop. Pass A or B.

w2ur/claude-code-setup

Command

Sync the claude-code-setup repo from live /.claude/ config. Copies, anonymizes and redacts private regions, cleans stale files, updates README counts, updates workflow guide, audits for leaks. Refuses to overwrite hand-edited destinations.

w2ur/claude-code-setup

Command

Run portfolio-sync — validate stories collection frontmatter and report.

w2ur/claude-code-setup

Command

Monthly technical health review in two phases. Phase 1: fast triage across ALL portfolio apps — scores each app on commit activity, portfolio prominence, time since last scan, and detected issues. Proposes a priority order. Phase 2: deep review on the apps the owner selects. Run without args for the full flow, or skip…

w2ur/claude-code-setup

Skill Claude CodeCodex

How CI gates and GitHub branch protection actually behave on this solo free-tier account — the zero-coverage hole in aggregate jobs, the 403 on private repos, and the three traps that permanently deadlock a solo merge. Load before writing or changing a CI gate, adding a pr-gate caller, or setting/checking branch…

w2ur/claude-code-setup

Skill Claude CodeCodex

How to cut a CLAUDE.md without losing a fact — the four-bucket taxonomy, the trigger-line shape that makes an extracted skill actually load, the gitignore prerequisite, and the line-coverage check that must be made to fail once. Load before editing, restructuring or pruning any CLAUDE.md, or when claude-md-weight.sh…

w2ur/claude-code-setup

Skill Claude CodeCodex

How the two memory systems on this machine resolve on disk, why per-agent stores are project-scoped and must never be consolidated upward or committed, and why claude-mem was removed. Load before creating, moving, consolidating or gitignoring any memory store, or before proposing a third place to keep session…

w2ur/claude-code-setup

Skill Claude CodeCodex

Portfolio coherence rules — preloaded into troubleshooter and portfolio-sync agents as background knowledge.

w2ur/claude-code-setup

Skill Claude CodeCodex

Why uv is the only Python manager on this machine, where the enforcement actually lives, and which plausible "fixes" are wrong. Load before writing any Python here, before touching a hook or scheduled job that runs Python, and before diagnosing a wrong-interpreter symptom.

w2ur/claude-code-setup

Skill Claude CodeCodex

Why each launchd LaunchAgent on this machine exists, scheduled at the hour it is, and which plausible "fixes" are wrong. Load before creating, editing, moving or diagnosing any scheduled job. Current state comes from jobs-inventory.sh, never from this file.

w2ur/claude-code-setup

Skill Claude CodeCodex

Test conventions across this portfolio — regression-test comment format, property-test setup for TS and Python, the financial-math arbitrary settings that were tuned by measurement, and why a failing check may be pinning a defect rather than reporting one. Load before writing tests, adding a regression test to a bug…