Skill Claude CodeCodex
Draft a new ADR (Architecture Decision Record) at doc/adr/NNNN- .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 starts at proposed.
Skill Claude CodeCodex
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 ARCHITECTURE.md (system-level patterns and boundaries, paired…
Skill Claude CodeCodex
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 / shipped specs / superseded PRDs / superseded or deprecated…
Skill Claude CodeCodex
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", "exhaustive review"). Heavier and more exhaustive than…
Skill Claude CodeCodex
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 / agents.md (the operational guide for agents working on…
Skill Claude CodeCodex
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 / user.email. No Co-Authored-By. Helper posture, not blocker. Triggers…
Skill Claude CodeCodex
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 deletion-test framing, grilling loop on the chosen candidate. Pairs…
Skill Claude CodeCodex
Disciplined diagnosis loop for hard bugs and performance regressions per WORKFLOW §15. Five phases — build a feedback loop, reproduce, hypothesise (3-5 ranked falsifiable), instrument, fix + regression-test. The feedback loop is the skill; everything else is mechanical. Triggers on "diagnose this", "debug this", "this…
Skill Claude CodeCodex
Lazily create or update CONTEXT.md (Layer 2 — ubiquitous language per Evans 2003) at the repo root, or CONTEXT-MAP.md plus per-context CONTEXT.md for multi-context repos. Captures canonical project-specific nouns, the aliases to avoid, the relationships between them, and resolved ambiguities. Triggers on "domain…
Skill Claude CodeCodex
Read-only drift audit — compare AGENTS.md, ARCHITECTURE.md, and ADR statuses against what the code actually does. Outputs a drift list, never writes files. Use when the user wants to audit, review for drift, sanity-check, or report inconsistencies between the repo's docs and its code.
Skill Claude CodeCodex
Interview-before-research grilling session that challenges a fuzzy ask against the existing codebase, sharpens vocabulary against CONTEXT.md, and resolves the decision tree branch by branch. One question at a time, codebase-first when an answer is in code, with each question carrying a recommended answer. Triggers on…
Skill Claude CodeCodex
Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history — then synthesize a happy path and gate any deviation with an irrefutable justification before code is written.…
Skill Claude CodeCodex
Draft or update GUIDELINES.md at the repo root — the project's full engineering reference. Layer 1 Constitution trinity member (alongside WORKFLOW.md universal philosophy and AGENTS.md distilled rules). Covers Clean Architecture binding, SOLID application, Object Calisthenics tier (loose / moderate / strict per Bay…
Skill Claude CodeCodex
Compact the current session into a handoff document a fresh agent can pick up from. Saves to the OS temp dir (never the repo). Captures live state — current branch, open artifacts, unresolved decisions, in-progress diff, recent errors — references existing artifacts (PRD / spec / task / ADR) by path instead of…
Skill Claude CodeCodex
Scaffold deterministic quality gates per WORKFLOW.md §11 — pre-commit (lint, format, secret-scan), pre-push (build, unit, integration). Detects the project's stack and recommends a hook runner (Husky / lefthook / pre-commit / native), scaffolds the runner config, and updates AGENTS.md Quality Gates. Use when the user…
Skill Claude CodeCodex
Run this skill when the user explicitly invokes /ad-level-up or names it, or asks to evolve the project's rule-set — "add a convention", "update the rules", "new rule", "merge these rules", "we keep hitting X, make it a rule", "retire this rule" — or hands over a rule gap surfaced by ad-audit. Companion to ad-audit…
Skill Claude CodeCodex
Evaluate and merge a GitHub pull request. Four phases — preflight (gh auth + PR resolution), evaluate (CI / fresh-context review / linked task / unresolved comments / mergeability), decision (CI green = hard gate; others = warnings yielding to user), merge via gh pr merge with auto-detected mode (squash / rebase /…
Skill Claude CodeCodex
Survey the project's state across the six-layer artifact stack and recommend prioritized next actions, modeled on flutter doctor. Use when the user asks "what's next", "next step", "where am I", "project status", "doctor", "what should I do", "audit my workflow". Read-only; complements ad-drift (drift detection, a…
Skill Claude CodeCodex
Universal agent behavior and documentation discipline — think before coding, decide when grounded (only ask on judgment calls), ground in real patterns, prefer simplicity, make surgical changes, define verifiable goals, verify before claiming done, report for a decision-maker (conclusion first, self-contained…
Skill Claude CodeCodex
Open a GitHub pull request with a uniform body shape. Four phases — preflight (gh auth + branch pushed), scope assembly (commits + diff vs base), draft body (Summary / Test plan / Links), open + report URL. Title format = Conventional Commits, type inferred from the dominant commit type in the range. gh CLI soft-fail…
Skill Claude CodeCodex
Draft or update a Product Requirements Document at doc/product/PRD.md (single-product) or doc/product/ .md (multi-product). Layer 3 of the six-layer artifact stack (Constitution → Domain → Product → Spec → Plan/Decisions → Code). Captures product-level scope — target user, problem, goals, non-goals, success metrics…
Skill Claude CodeCodex
Run this skill when the user explicitly invokes /ad-review or names it ("run ad-review", "use the ad-review skill"), or when the user asks for a code review with an explicit scope ("review this branch", "review main..HEAD", "revisa esse diff "). Auto-trigger note: allowimplicitinvocation: true is set so…
Skill Claude CodeCodex
Load the practitioner's global rules — the host's CLAUDE.md or AGENTS.md, symlinks resolved — and reinforce them by listing their topics in the conversation, alongside whatever the repo and the kit's rule-set layers add. Use when the user says "read my global CLAUDE.md / AGENTS.md and bring the topics", asks what…
Skill Claude CodeCodex
Draft a new Claude Code or Codex skill at .claude/skills/ /SKILL.md (or .agents/skills/ /SKILL.md for Codex), using the Anthropic Skills format. Use when the user wants to create, write, draft, or scaffold a custom skill for an agentic coding tool. Asks one question per missing field; never invents skill names or…