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.

assura agent onboard . --agent codex --activate --format text
Assura agent onboardingProject      node confidence=highAgent        codex confidence=explicitPolicy       agentic-core + structure-health -> $agent-entrypoint (applied)Host         codex generated=true activated=true structurally_verified=true conflicted=falseHost status  post_activation=structurally_verified doctor=pass host_approval=unavailable follow_up=Review the generated project hooks, then trust the project and approve its hooks in Codex.Lifecycle    agent-working-loop=nudge pre-commit-warning=warn pre-push-or-ci-gate=gateVerified     structure_config=pass onboarding_packet=passReview       needs-review blocking=0 advisory=0 inactive_signals=5Deferred     project_specialization, content_modelsNext         Specialize from repository evidencePacket       .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.

Agent setup

Set up this project with Assura.

Copy one instruction to the coding agent already working in your project. It will establish the baseline, define the expected shape, and verify it.

One command assura agent onboard .
Agent goal Inspect, constrain, verify
  1. Inspect manifests, tooling, generated output, and the intentional layout.
  2. Define project-owned rules for the expected stack. Close stable scopes so unexpected paths fail; preserve legitimate paths and ask only where evidence is ambiguous.
  3. Verify with assura review and assura check --format agent.
Installation details public release
curl -fsSL https://assura.dev/install.sh | sh

The copied setup instruction includes this command.