assura

Agent-ready onboarding

Give the agent a baseline without teaching it to guess.

One onboarding command creates or preserves the broad Assura baseline, installs project-local guidance, verifies the result, and leaves project-specific questions for a human decision.

Start with your agent Read the onboarding guide
assura agent onboard 
$ assura agent onboard . --agent auto --format json

project type      monorepo
config            .assura/config.yml
verified          2
inactive          2
next action       .assura/onboarding/agent-next.md

Creates

A config, presets lock, project-local skills, process guidance, examples, and an onboarding packet across 19 recorded file actions.

Preserves

Existing configuration and AGENTS.md guidance are merged or retained rather than silently replaced.

Does not guess

Language, layout, naming, hooks, content models, and domain rules remain explicit human decisions.

01

Active versus inactive

The onboarding result names verified setup separately from content models and specialization that are still inactive.

02

Harness-aware, not harness-dependent

Supported harnesses can receive integration bundles; generic environments still get AGENTS.md and manual-shell guidance.

03

A concrete handoff

The generated agent-next document tells the agent what to read, what to ask, and which broad checks are ready.

04

One lifecycle, separate pressure

Advisory working-loop feedback, pre-commit warnings, and blocking pre-push or CI policy are configured as distinct stages.

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