# No Mistakes

> Validate committed feature-branch changes through the no-mistakes pipeline: intent, rebase, review, test, docs, lint, push, PR, and CI. Use when the user asks to run no-mistakes, ship safely, validate before pushing, or gate a change before it reaches upstream.

- Skill: `stevesolun/no-mistakes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add stevesolun/no-mistakes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stevesolun/no-mistakes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: stevesolun (https://skillmd.com/u/stevesolun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/stevesolun/no-mistakes

---


# no-mistakes

`no-mistakes` is a local git gate. It validates committed branch changes before
they reach upstream and reports decision points in machine-readable TOON.

## Preconditions

- Work is committed.
- Current branch is a feature branch, not the default branch.
- The repository has been initialized with `no-mistakes init`.
- The intent is explicit: what the user wanted to accomplish, not only a diff
  summary.

## Run

```sh
no-mistakes axi run --intent "<what the user set out to accomplish>"
```

Use the user's exact objective as the intent, enriched with material decisions
and constraints learned during the work.

## Decision Loop

If output contains a `gate:` object, inspect each finding:

- `auto-fix`: make the mechanical fix, then respond with `fix`.
- `no-op`: approve or continue when nothing needs changing.
- `ask-user`: stop and relay the finding to the user before responding.

Useful commands:

```sh
no-mistakes axi respond --action approve
no-mistakes axi respond --action fix --findings <id1,id2> --instructions "<guidance>"
no-mistakes axi respond --action skip
no-mistakes axi status
no-mistakes axi logs --step <name> --full
no-mistakes axi abort
```

## Output Contract

- `checks-passed`: CI is green and the PR is ready for human review/merge.
- `passed`: the gate completed.
- `failed` or `cancelled`: inspect output and fix the reported issue.

Do not silently approve `ask-user` findings unless the user explicitly gave
standing consent such as `--yes`.