alexandremendoncaalvaro

Two-axis fresh-context code review (Standards against AGENTS.md and ADRs; Spec against the originating task) run on Codex as one inline pass with an audit trail, findings side by side, never an approve verdict. Use before merging a diff, branch, or PR;…

Two-axis fresh-context code review (Standards against AGENTS.md and ADRs; Spec against the originating task) run as parallel subagents, findings side by side, never an approve verdict. Use before merging a diff, branch, or PR; "review this", "review…

Two-axis fresh-context code review (Standards against AGENTS.md and ADRs; Spec against the originating task) run as parallel subagents, findings side by side, never an approve verdict. Use before merging a diff, branch, or PR; "review this", "review…

Two-axis fresh-context code review (Standards against AGENTS.md and ADRs; Spec against the originating task) run on Codex as one inline pass with an audit trail, findings side by side, never an approve verdict. Use before merging a diff, branch, or PR;…

Four-source research before non-trivial code — official docs, validated references, in-repo patterns, git history; synthesizes the happy path, persists an evidence record, gates deviations. Use before implementing, choosing a library or pattern, or on "ground…

Design, interpret, refine, and audit decision-focused evaluations. Use when asking how to evaluate a change, define measures or decision rules, test fit for purpose, interpret results, or audit evaluation claims. Routes open research, uncertain techniques,…

Four-source research before non-trivial code — official docs, validated references, in-repo patterns, git history; synthesizes the happy path, persists an evidence record, gates deviations. Use before implementing, choosing a library or pattern, or on "ground…

Design, interpret, refine, and audit decision-focused evaluations. Use when asking how to evaluate a change, define measures or decision rules, test fit for purpose, interpret results, or audit evaluation claims. Routes open research, uncertain techniques,…

Draft a new ADR (Architecture Decision Record) at doc/adr/NNNN-<short-title>.md, using Michael Nygard's Context/Decision/Consequences/Alternatives pattern. Use when the user wants to record, write, draft, propose, or document an architecture decision. Status…

Generate ARCHITECTURE.md at the repo root by scanning the code first, pre-filling layers/patterns/observability/deployment from observed signals, then asking only the genuine gaps. Use when the user wants to bootstrap, scaffold, generate, document, or audit…

Sweep completed plan files (tasks Status:done, specs Status:shipped, PRDs Status:superseded, ADRs Status:superseded or deprecated) out of the working tree and into git history via `git rm`. Use when the user wants to archive, clean, prune, or sweep done tasks…

Run this skill when the user explicitly invokes `/ad-audit` or names it ("run ad-audit", "audit against the rules"), or asks for the maximum quality gate before work reaches the team ("adversarial audit", "rules audit", "maximum gate", "verify before I post",…

Generate AGENTS.md at the repo root by scanning the codebase first, pre-filling placeholders from observed signals, and asking only the genuine gaps. Use whenever the user wants to bootstrap, scaffold, generate, create, set up, or audit AGENTS.md / CLAUDE.md…

Atomic Conventional Commits with DCO `Signed-off-by` sign-off. Four phases — scope intake, stage-split when concerns mix, draft message in Conventional Commits format, sign + write. Stage-split is interactive; identity comes from `git config user.name` /…

Surface deepening opportunities in the codebase using the Ousterhout/Feathers vocabulary from WORKFLOW §8 (Module / Interface / Depth / Seam / Adapter / Leverage / Locality). Three-phase process — explore organically, present numbered candidates with…

Generate DESIGN.md at the repo root by scanning existing design tokens (Figma export, tailwind.config, tokens.json, stylesheet) and synthesizing W3C-compatible YAML frontmatter + Markdown rationale per the Google Labs design.md spec. Use when the user wants…