Getting Started

Getting Started

What a first run should accomplish

The safe first objective is not to prove capability or to dispatch a provider. It is to create an inspectable local mission, see its packets, tasks, residuals, and next safe action, and confirm that the runtime remains in dry-run mode.

Install and inspect the runtime contract

python -m pip install collective-capability-runtime
ccr agent explain --json

Confirm that default_mode is dry_run. Read the reported non-claims and safe-next-command list before choosing a mutating or execution-capable command.

For a repository checkout:

uv sync --all-extras
uv run ccr agent explain --json

Create a local mission

Use a separate directory for runtime state:

ccr --root ccr-runtime asi quickstart --profile development --json
ccr --root ccr-runtime mission status --mission mission:quickstart --json
ccr --root ccr-runtime mission next --mission mission:quickstart --compact --json
ccr --root ccr-runtime workbench report --mission mission:quickstart --format markdown --out CCR_WORKBENCH.md

Expected properties of this workflow:

• ok=true when the local transition succeeds.
• external_execution=false and network_call_performed=false.
• settled=false while evidence, verification, or other obligations remain.
• A workbench report containing the current packets, tasks, and residuals.

asi quickstart and workbench report --out write local artifacts. mission status and mission next inspect existing state. None of these commands dispatches a provider.

Route the remaining work

ccr --root ccr-runtime residual market --mission mission:quickstart --json
ccr --root ccr-runtime task next --role verifier --json

The residual market ranks repair work; it does not erase or waive any residual. A residual is resolved only by a repair artifact and an independent verifier report whose artifact_sha256 matches that artifact.

Read the output before acting

Output	Interpret it as
accepted	Finite acceptance of evidence, not final settlement or authority.
settled	Completion of all declared gates; false is normal.
candidate_only_reasons	Reasons evidence cannot yet be promoted.
residual_ready	A structured remaining-work item suitable for preservation and repair.
safe_commands	Suggestions for an operator or agent to inspect, never commands automatically authorized for execution.

Next pages

• For the data model: Core Concepts and Status
• For local files and state changes: Missions and Local State
• For multi-agent coordination: Workcells, Tasks, and Residuals