Learning paths

I am evaluating agentctl

1. Read Why agentctl.
2. Review the security model and limitations.
3. Compare provider and tool capabilities.
4. Inspect the architecture diagrams.

I want to run my first workflow

1. Install from source.
2. Complete the credential-free Getting started tutorial.
3. Run the first bounded agent workflow.
4. Learn local operation.

I want to author workflows

1. Learn to author a workflow.
2. Read the YAML reference.
3. Study tools and effects and policies and approvals.
4. Start from a verified use case.

I want to operate agentctl

1. Choose a deployment model.
2. Understand durable execution.
3. Configure logs and observability.
4. Keep the troubleshooting decision path close to runbooks.

I want to integrate agentctl into CI/CD

1. Read the container contract.
2. Apply the CI/CD integration guide.
3. Review the CI quality gate example.
4. Plan protected state retention for approvals and recovery.

I want to contribute

1. Read the contributor guide.
2. Learn the Rust workspace and effect boundaries.
3. Run the testing strategy.
4. Use the focused guide for an action or tool, provider, migration, or documentation change.