Guides
Guides help you understand the platform and get work done with it. They teach; the Conventions recommend, and the Values and Decisions explain why. Contributors to the toolkit itself have their own rules.

Not sure where to start? The adoption advisor asks a few questions about your project and suggests packages, steps and pages, in order.
Onboarding: read in this order
| Guide | Answers |
|---|---|
| 1. How the Platform Fits Together | What are the pieces, what is mine, how does a request or a job travel through them? |
| 2a. Your First Solution | How do I start a new solution, choose a layout and get to a green pull-request gate? |
| 2b. Adopting an Existing Solution | How do I add the platform to a repository that already runs a service, in small, deployable steps? |
| 3. Bringing Your Company Stack | Where do my logging and metrics backend, auth, private feeds and deployment plug in? |
| 4. Onboarding Recipes | How do I set up the first test project, the mock server, a module, validated settings, a health check, a worker and telemetry? |
| 5. Pitfalls | Why did this break, and what do others do about it? |
Platform features
| Guide | What it covers |
|---|---|
| Layered Architecture | The layers, the toolkit’s DI modules, the layering check and the dependency map. |
| Automation Preferences | Optional root-level automation overrides, settings inventory, defaults, precedence and explicit editing commands. |
| Observability | ICoreTelemetry and AppTelemetry, standard logging and metrics, OTLP, optional Serilog, correlation IDs, Datadog and New Relic configuration, testing telemetry. |
| Database Providers | The provider-agnostic persistence layer, PostgreSQL/Oracle/MySQL specifics, adding a provider. |
| Mock Server | Standing in for HTTP upstreams: expectations, your own host, assertions and recording. |
| Building UIs | Web.Ui: Blazor startup, cookie-session login, environment catalog, downstream API clients, components. |
| Anarchy Automation Builds | The Automation.Build components, test discovery and runners, artifacts, releases and CLI tool wrappers. |
| CLI Tool | The anarchy-toolkit CLI: bootstrapping a solution and scaffolding APIs, jobs and UIs. |
The Package Catalog documents each package, including the Testing.* kits, and answers Which package do I need? for the families that are split by role (Automation*, Infrastructure.Persistence.Db.* and Testing.Db.*, Core.Telemetry and Infrastructure.Telemetry.Serilog).