Internals
Internals
Internals docs are for people maintaining Homeboy itself: architecture, implementation contracts, developer guidance, and docs-maintenance rules. Developer Guide Architecture overview...
Test Tiers
The commands in this section are the local edit-loop tiers. CI does not run any of them: the CI gate...
Extension API v1
The Extension API is the transport-neutral contract through which Homeboy describes installed extensions and negotiates compatibility. Its serialized v1 types...
Resource Topology v1
homeboy-resource-topology-contract defines one read-only snapshot schema: homeboy/resource-topology-snapshot/v1. The snapshot contains only stable kind and id resource references, declared directed edges,...
PathRoots injection contract
homeboy_core::paths::PathRoots names one Homeboy home: a config root, a data root, and an artifact root resolved together. Its own doc...
Command argument provenance contract
CLI compilation produces a typed command together with a source map for every resolved Clap argument. The public Rust surface...
Verification phase contract
Homeboy's verification surface is deliberately split into isolated primitive commands that can be composed by higher-level workflows. Primitive phases The...
Compiler Warning Extension Contract Gap
Issue #2242 asks Homeboy core to move compiler-warning collection and compiler-warning fix generation behind extension-owned contracts. Validation and formatting already...
Architecture Overview
Homeboy is headless automation for agentic software engineering workflows. It is built in Rust with a config-driven, extension-oriented architecture that...
Architecture Cleanup Map
This map tracks lower-risk source-boundary cleanup. It is intentionally scoped to developer guidance and ratchets; command implementation refactors should happen...
Error Handling Patterns
Homeboy uses a centralized error system for consistent error reporting across all commands. Error Categories Errors are categorized by type...
Config Directory Structure
Important: Portable component configuration can live in a repo-level homeboy.json. Reusable machine-local configuration, state, installed extensions, projects, servers, fleets, rigs,...
Documentation Structure
Standard patterns for organizing documentation files and directories. These rules describe Homeboy's own docs/ tree; downstream projects managed by Homeboy...
Documentation Generation
Instructions for creating comprehensive user-facing documentation from scratch by analyzing the codebase. Purpose Generate structured documentation in the /docs directory...
Documentation Management
Homeboy provides AI agents with consistent instructions for documentation generation and maintenance. These docs serve as the single source of...
Documentation Alignment
Instructions for keeping existing .md documentation synchronized with current codebase implementation. Scope Alignment covers documentation that describes current implementation only....