# Agent Bootstrap: Procedural Companion To The Canonical /agents Page

The command path below follows `/agents`: bootstrap JSON, install, instance-repo setup, auth, and the first read-only inspection sequence.

## Summary

- System definition lives on `/agents`: Use `/agents` for system identity, primitives, invariants, evaluation logic, and authoritative resources.
- The short command path lives here: Use it when you already know what the system is and want the shortest correct sequence.
- Read-only first: Begin with inspection before mutation or deployment decisions.
- Production review remains human: Deployment and trust choices still belong to humans.

## Quickstart

Read `/agents` first for system definition and evaluation logic. Then use this shorter sequence for installation, instance-repo setup, and the first read-only inspection.

### 1. Read the public bootstrap JSON

Start from the canonical machine-readable discovery surface.

```text
$ curl -fsSL https://movebigrocks.com/.well-known/mbr-agent.json
```

### 2. Install `mbr`

Use the public install path that matches the machine.

```text
$ curl -fsSL https://movebigrocks.com/install.sh | sh
PS> Invoke-RestMethod https://movebigrocks.com/install.ps1 | Invoke-Expression
```

### 3. Create the private instance repo

Use the instance template so the agent can build the owned runtime itself.

```text
$ gh repo create acme/mbr-prod --private --template MoveBigRocks/instance-template --clone
$ cd mbr-prod
$ scripts/read-instance-config.sh mbr.instance.yaml
```

### 4. Authenticate and set context

Log in to the runtime you built and store local CLI context before deeper inspection.

```text
$ mbr auth login --url https://app.yourdomain.com
$ mbr context set --workspace ws_preview --team team_operations
```

### 5. Start with read-only checks

Inspect queues or knowledge before state-changing operations.

```text
$ mbr queues list --json
$ mbr knowledge list --search policy --json
```

## Use this sequence after the product definition is clear.

The product definition, primitives, repo model, and approval rules live on `/agents`. The commands collected here start after that and stay focused on discovery, install, instance-repo setup, auth, and read-only inspection.

- Canonical bootstrap: System definition, ontology, invariants, fit logic, and resources. /agents
- CLI tour: Concrete product tour plus the full human and agent command reference. /docs/cli
- Resources: Authority map for repos, docs, APIs, and evaluation surfaces. /resources

## Related

- Agents: /agents
- Install CLI: /install-cli
- Self-host: /self-host