adr
25Skill Claude CodeCodex
Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse. Written under docs/adr/.
Skill Claude CodeCodex
Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse. Written under docs/adr/.
Skill Claude CodeCodex
API contract design: resource naming, error model, versioning, pagination, backward compatibility, OpenAPI. A predictable interface that evolves without breaking consumers.
Skill Claude CodeCodex
Auto-mode classifier config: inspect what the classifier that now answers permission prompts is configured with, and catch the silent case where a custom autoMode block drops the built-in block rules.
Skill Claude CodeCodex
Divergent discovery BEFORE planning: turn a fuzzy ask into 2–4 scoped options + named unknowns, pick a direction, hand to spec-planning. Bounded; converges to explicit choices, never guesses.
Skill Claude CodeCodex
CI pipeline discipline: lint→build→test→quality→security, fail-fast, deterministic build, secret handling, PR gates.
Skill Claude CodeCodex
Code review discipline: severity-ranked, reasoned feedback on whether a change improves the system's overall code health. review-agent-csk applies it. Use when reviewing a change set, and when acting on a review someone else wrote.
Skill Claude CodeCodex
Conventional Commits: reads the staged diff and proposes type(scope): summary, with body/footer when needed. One logical change = one commit. commit-agent-csk applies it.
Skill Claude CodeCodex
Readiness gate BEFORE writing implementation code: does this already exist, does it fit the project's architecture, is the API claim actually checked, is there a working reference, is the root cause known.
Skill Claude CodeCodex
Apply schema migrations safely: detect the tool, classify the change by risk, gate destructive ones behind approval, back up in prod, preview-apply-verify, roll back on failure. Use when a schema change is about to be applied to any environment.
Skill Claude CodeCodex
Dependency risk assessment, read-only: known CVEs, deprecated packages, licence compliance, maintenance status, lockfile integrity, and a justification for every new dependency. Acting on it is dependency-upgrade.
Skill Claude CodeCodex
Bring dependencies current without breaking the build: find what is vulnerable, deprecated or behind, classify each target version by risk, apply what is safe, verify, and roll back what is not.
Skill Claude CodeCodex
Ship a build reversibly — to a host you manage or a platform that manages it. Pick the topology first, keep the previous version reachable, gate on health, roll back without rebuilding. Use when shipping anywhere users can reach.
Skill Claude CodeCodex
DevArchitecture backend pattern: MediatR CQRS handler/command/query, IResult/IDataResult, Autofac AOP chain, FluentValidation, i18n. backend-expert-csk applies it.
Skill Claude CodeCodex
Keeps documentation in sync with the code: README, usage and related docs when a public API or behavior changes. Leaves no dead or misleading docs behind.
Skill Claude CodeCodex
Measure output quality, don't vibe it: score a generative task with a two-layer grader — deterministic code metrics + per-dimension LLM-as-judge — over a fixed task set, as signed deltas vs a pinned baseline. Grades cost alongside correctness (pass-slow).
Skill Claude CodeCodex
Visual and UX design quality for interfaces: hierarchy, spacing rhythm, typographic scale, a restrained color system, layout composition, and polished states. The taste layer above frontend architecture and a11y.
Skill Claude CodeCodex
OPTIONAL, stack-specific: React Native + Expo (prebuild). Mobile RN projects only; the generic principles live in the frontend skill.
Skill Claude CodeCodex
Stack-agnostic frontend discipline (web · mobile · desktop): component structure, state, data fetching, loading/empty/error states, i18n, accessibility, performance. frontend-expert-csk applies it on every stack.
Skill Claude CodeCodex
Session handover: when context fills, a phase closes, or the topic changes, write an action-oriented handover to docs/SESSIONSTATE.md, then recommend /clear.
Skill Claude CodeCodex
Translation integrity: every key present in every language, no hardcoded strings, consistent placeholders and plurals. Runs when user-facing text changes.
Skill Claude CodeCodex
Production incident response: diagnose → mitigate → resolve, then a blameless postmortem and a repeatable runbook. Stop the impact first, root cause second. Use when production is degraded or broken, and again for the postmortem afterwards.
Skill Claude CodeCodex
Refine-to-Done loop: repeat until tests green + review clean + nothing deferred; bounded. Not the harness /loop.
Skill Claude CodeCodex
Build a Model Context Protocol (MCP) server so an AI client can call your tools/resources: design tool schemas, pick a transport, handle errors, and test it. For exposing an API, database, or service to Claude and other clients.
Skill Claude CodeCodex
Stack-agnostic observability: structured logs, correlation ids, metrics and traces; no PII or secrets in logs. Makes a production issue traceable to why it happened. Use when adding a log line, an error path, a metric, or when an incident could not be traced.