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. |
By role
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 |
What's next
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.
Overview · Quickstart · FAQ