Learning path

Follow this order to go from zero to confident with Midcore. Each step links to the right doc.

Recommended path

Step	Page	What you learn
1	Overview	What Midcore is and how to choose your environment.
2	Quickstart	Install, init, and run your first agent task and gates.
3	How Midcore works	Agent, Plan, Debug, and Ask modes and the agent loop.
4	Gates & evidence	Deterministic gates, evidence ledger, and delivery tiers.
5	Common workflows	Explore, fix bugs, add features, refactor, run gates.
6	Best practices	Clear intent, right mode, contracts first, verify after edit.
7	Reference	CLI, gates, intent.yaml, settings, and environment variables.

If you have a specific role, you can jump in at the right entry point and follow the links that matter most.

Role	Suggested path
Developer	Overview → Quickstart → How Midcore works → Common workflows → CLI reference
DevOps / CI	Quickstart → Gates & evidence → CLI reference → CI/CD guide
Team lead	Overview → Outcome Compiler → Gates & evidence → Best practices → Administration
Full-stack / integrator	Web app & API proxies → OpenAPI → API overview → Self-hosted

After the path, use Glossary and FAQ when you need a quick answer. For problems, see Troubleshooting. If you wire the web UI to backends, read Web app & API proxies.