# Basilisk Documentation

This directory is split by audience.

## Beginner Guides

- [CLI Beginner Guide](cli-beginner-guide.md)
- [Desktop Beginner Guide](desktop-beginner-guide.md)

These guides are written for first-time operators who want to run Basilisk safely, understand the main screens and commands, and get to a useful first result without reading the whole codebase.

## Advanced Guides

- [CLI Advanced Guide](cli-advanced-guide.md)
- [Desktop Advanced Guide](desktop-advanced-guide.md)

These guides explain campaign controls, execution modes, module trust tiers, evidence thresholds, reporting, and advanced operator workflows.

## Technical References

- [Architecture](architecture.md)
- [CLI Reference](cli-reference.md)
- [Attack Modules](attack-modules.md)
- [Evolution Engine](evolution-engine.md)
- [Eval, Probes, and Curiosity](eval-probes-curiosity.md)
- [Reporting](reporting.md)
- [API Reference](api-reference.md)

## Suggested Reading Order

If you are new to the project:

1. Read the main [README](../README.md).
2. Read either the [CLI Beginner Guide](cli-beginner-guide.md) or the [Desktop Beginner Guide](desktop-beginner-guide.md).
3. Read [Eval, Probes, and Curiosity](eval-probes-curiosity.md) when you want to understand the payload corpus and evaluation workflow.
4. Use the advanced guide for the interface you actually operate.

If you already know the product surface:

1. Read the matching advanced guide.
2. Use the technical references for implementation detail.
