Glossary
The words the docs and the dashboard use, each in a line or two.
Account
A GitHub user or organization with the AxonShaft app installed. It holds projects, a Claude token and default settings. See Accounts and projects.
Automation
Something Axon Shaft does on a repo by itself when something happens there, such as Code review on each pull request, or Reply on /ask. Each starts from a template.
Blocking
A finding that should stop the merge. It makes the verdict blocking and fails its checklist's check run.
Check run
A result GitHub shows in a pull request's Checks tab, such as Axon Shaft / security. Branch protection can require one. See Check runs.
Checklist
One thing a review checks, such as security or known vulnerabilities, with the files it runs on and how it checks: a script, the model, or a script and then the model. See How checklists work.
Finding
One problem a review reports, with its file and line, its severity (blocking, should fix or nit), its text and often a suggested change.
Gate
A merge gate: a requirement written in plain words that every pull request must meet, reported in the Axon Shaft / gates check. See Merge gates.
Grant
What the Axon Shaft API answers a run with: a GitHub token for that repo, the Claude token, the settings and the review's checklists and prompt. The workflow itself holds no secrets.
Nit
A small finding, such as a style point, that doesn't change the verdict. The nits setting decides whether nits go in the summary, inline, or nowhere.
OIDC token
A short-lived token GitHub gives a workflow run with id-token: write. The action signs in to the Axon Shaft API with it, and each one works once.
Project
One repo that Axon Shaft works on, with its automations, settings and, if you save one, its own Claude token.
Run
One time the action ran a review, answered /ask, or made a change for /fix or /axonshaft. Each run has a page on the dashboard for 7 days. /help and runs that end with a notice before they start get no page.
Should fix
A finding that should be fixed before merging but doesn't block. It makes the verdict needs changes, and its checklist's check run is neutral.
Skip label
A pull request label, such as skip-review, that stops reviews on pull request events. See Skipping a pull request.
Summary comment
The one comment Axon Shaft keeps on a pull request and edits on every push. See What gets posted.
Template
A ready-made automation, such as Code review or Security review, with its checklists in order. See Templates.
Verdict
A review's overall result: blocking, needs changes or looks good.
Last updated on