README.md

Devctl user guide

Devctl turns one checked-in devctl.yaml Manifest into a reproducible Go Project. This guide is organized around work you need to complete rather than the internal packages that implement it.

Start here

1. Build an HTTP API with PostgreSQL.
2. Learn the core concepts and ownership rules.
3. Use the Project workflow when changing a Manifest.
4. Follow the Contract and generation workflow when an API or event schema changes.

Continue by task

• Work inside the generated Project
• Add databases, storage, clients, and event endpoints
• Diagnose and recover from failures

Reference

• Commands and flags
• Manifest v1
• JSONL, result shapes, errors, and exit codes

Documentation on main follows the current source tree. When using a released binary, select the matching Git tag before reading these files.