Homeboy | chubes.net

Code Factory

The code factory is homeboy's model for automated code maintenance: humans write features, the system maintains quality. It combines lint, test, audit, autofix, continuous release, and deployment into a self-improving...

March 9, 2026 Read More

Audit Layer Ownership Rules

Homeboy audit supports optional architecture/layer ownership rules to catch design-level drift that passes lint/static checks. Rule file locations Use one of: homeboy.json under audit_rules Example { "layer_rules": [ { "name":...

March 5, 2026 Read More

Core runner + output parse substrate

This document defines the core primitives introduced for: #460 — extension runner helper contract #464 — generic output parsing primitive Runner contract (core) src/core/extension/runner_contract.rs RunnerStepFilter { step, skip } should_run(step_name)...

March 5, 2026 Read More

`homeboy audit`

Synopsis homeboy audit <component-id|path> [options] Description Audit a component's codebase for convention drift, structural complexity, dead code, duplication, and test coverage gaps. The audit engine fingerprints source files, discovers conventions...

March 4, 2026 Read More

Config Structures

Configuration ScopedExtensionConfig version — Version constraint string (e.g., ">=2.0.0", "^1.0"). settings — Settings passed to the extension at runtime. GitDeployConfig remote branch post_pull — Commands to run after git pull...

March 1, 2026 Read More

CLI Commands

Commands homeboy — Command Arguments ApiArgs project_id — Project ID command AuditArgs component_id — Component ID or direct filesystem path to audit conventions — Only show discovered conventions (skip findings)...

March 1, 2026 Read More

`homeboy refactor`

Synopsis homeboy refactor <COMPONENT> --from <SOURCE>... [OPTIONS] homeboy refactor <COMPONENT> --all [OPTIONS] homeboy refactor <COMMAND> Description Structural refactoring tools for planning and applying code changes across a codebase. The top-level...

February 28, 2026 Read More

`homeboy extension`

Synopsis homeboy extension <COMMAND> Subcommands list homeboy extension list [-p|--project <project_id>] run homeboy extension run <extension_id> [-p|--project <project_id>] [-c|--component <component_id>] [-i|--input <key=value>]... [--stream|--no-stream] [<args...>] --project is required when the extension...

February 28, 2026 Read More

Portable Component Config (`homeboy.json`)

A homeboy.json file in a repo root defines portable component configuration that travels with the code. Clone a repo, run one command, and homeboy knows how to build, test, version,...

February 25, 2026 Read More

Cross-Compilation Guide

Homeboy can orchestrate releases for any platform, but building native binaries requires access to that platform's toolchain. What Works Anywhere Task Platform Required Version management Any Changelog operations Any Git...

February 10, 2026 Read More

Project: Homeboy