Concept docs explain Homeboy’s mental model and vocabulary. Use these when you need to understand how commands fit together before looking up exact flags.

If you are trying to perform a task, start with Workflows. Use concepts when a workflow mentions a term such as component, runner, structured evidence, scope, or Code Factory.

Core Concepts

• Homeboy model – components, extensions, commands, evidence, runners, and operations.
• Structured evidence – human output, JSON output, persisted runs, and reviewer-safe artifacts.
• Headless agent orchestration – why Homeboy helps agents produce durable, reviewable engineering work.
• Code Factory – automated code maintenance through lint, test, audit, release, and deploy stages.

Deeper Concepts

• Scope model
• Planned change execution
• Apply and publish contract
• Composable workload evidence contract