# Crucis Documentation

An autonomy scaffold for code-generating agents. Crucis provides structured automated feedback — tests, adversarial review, constraints, holdout verification — so agents can iterate longer without human intervention.

## Get started

- **[Start Here](start-here.md)** — prerequisites, installation, and orientation
- **[New Project Quickstart](quickstart-new-project.md)** — build a verified function from scratch
- **[Existing Codebase Quickstart](quickstart-existing-codebase.md)** — add verification to your current project
- **[Why Crucis](why-crucis.md)** — understand the autonomy scaffold approach

## Learn more

- **[How It Works](workflow.md)** — fit/evaluate loop, adversarial hardening, checkpoints
- **[Use Cases](use-cases.md)** — common scenarios and entry points
- **[Architecture](architecture.md)** — system design and module roles
- **[Background Optimizer](optimizer.md)** — (experimental) automatic prompt improvement across runs

## Reference

- **[CLI Commands](cli-reference.md)** — all commands and options
- **[MCP Server](mcp-server.md)** — use Crucis from Claude Code, OpenCode, or Codex via MCP
- **[Objective Format](objective-reference.md)** — YAML schema for objectives
- **[Constraints](constraints-reference.md)** — 34 AST-based code quality checks
- **[Configuration](configuration.md)** — environment variables and workspace settings

## Help

- **[Troubleshooting](troubleshooting.md)** — common errors and fixes
- **[FAQ](faq.md)** — frequently asked questions
- **[Glossary](glossary.md)** — term definitions
