assura

Project review

See what this branch changed before review starts.

Assura Review is a compact project-health radar. It separates branch and worktree change pressure, reports configured and inactive signals, and directs the agent to Explain or the authoritative Check gate.

Start with your agent Read the project review example
assura review · branch + worktree 
$ assura review
Project status: fail
Compared with origin/main

Branch    1 file | +3/-0 lines | 1 commit
Worktree  1 modified | 1 untracked | +2/-0

Needs attention
! apps/web/src/   file naming   1 violation

Next  assura check --format agent .

Branch

undefined changed file and concrete line churn compared with the detected source branch.

Worktree

undefined modified and undefined untracked path kept separate from committed work.

Policy

undefined blocking violation and undefined inactive capabilities, without treating unchecked behavior as passing.

01

Review is the radar

Use a bounded diagnostic while work is in progress. Review summarizes project health and change context without replacing the final gate.

02

Explain one path

When a finding needs context, Explain shows the effective inherited structure policy for the path instead of repeating the entire project report.

03

Check is the gate

Before merge, Check enforces the configured blocking contract with stable exit behavior for hooks and CI.

04

Current limits stay visible

Review reports inactive capabilities, so a clean configured check is not presented as complete project coverage.

Continue

Follow the signal into the details.

Agent setup

Start with one agent instruction.

Give this prompt to the coding agent already working in your project. It installs Assura, establishes a broad baseline, verifies the setup, and leaves unresolved project decisions visible.

Recommended Agent prompt 
Install Assura in this repository and set it up for agent-ready checks.
If assura is not installed, run:
ASSURA_INSTALL=https://assura.dev/install.sh
curl -fsSL "$ASSURA_INSTALL" | sh

Then run:
assura agent onboard . --agent auto --format json
assura check --format json .

Read .assura/onboarding/agent-next.md, summarize what is active, what is inactive, and what questions need human answers before adding project-specific rules.
Manual install curl -fsSL https://assura.dev/install.sh | sh