Basic Project Setup

This example uses the current supported CLI surface.

Project Shape

my-rust-project/
  .assura/
    config.yml
  src/
    main.rs
  Cargo.toml
  README.md

Create a Rust project

cargo new my-rust-project
cd my-rust-project

Install Assura

curl -fsSL https://raw.githubusercontent.com/rothnic/assura/master/website/public/install.sh | sh

Initialize Assura

assura init --recipe agentic-core --recipe structure-health

Run validation
Terminal window
```
assura check
```

Add a stricter shape

Edit .assura/config.yml:

rules:
  closed-entry:
    exists: 0
  closed:
    ./*/: $closed-entry
    ./*: $closed-entry

structure:
  ./: $closed
  README.md: exists:1
  Cargo.toml: exists:1
  src/: exists:1
  ./*.lock: exists:0-1
  ./**/:
    .rs: snake_case
exclude:
  - "target/**"

The root policy mirrors the project tree. It requires the public files, allows one lockfile, closes direct root contents through a reusable rule, and checks Rust source names at every directory depth.

Check again
Terminal window
```
assura check --format text
```

CI Snippet

name: Assura
on: [push, pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: curl -fsSL https://raw.githubusercontent.com/rothnic/assura/master/website/public/install.sh | sudo env BIN_DIR=/usr/local/bin sh
      - run: assura check --format text