From 64c426a4b19e0f16307c4358b95aa90dc44c7fc4 Mon Sep 17 00:00:00 2001 From: Chris Huber Date: Thu, 7 May 2026 12:36:19 -0400 Subject: [PATCH] docs: hint --path + --extension combo for unregistered checkouts The Homeboy AGENTS.md section described --path under Git verbs but left agents to discover on their own that homeboy lint --path on an unregistered checkout also needs --extension . Without it resolution synthesizes a component id from the path and fails with extension.unsupported. Add a single trailing sentence under Quality: so future agents reach for the working invocation directly instead of bouncing off the error. Discovered while validating Automattic/studio#3377. --- data-machine-code.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-machine-code.php b/data-machine-code.php index e6a5dba..1e8b363 100644 --- a/data-machine-code.php +++ b/data-machine-code.php @@ -536,7 +536,7 @@ function datamachine_code_load_chat_tools() { `homeboy` is a Rust CLI on this host. Every verb runs the same locally as in CI. -**Quality:** `homeboy audit | lint | test | review | refactor`; use `homeboy review --changed-since --report=pr-comment` for PR-style review loops, and `--baseline` / `--ratchet` when a command supports observation baselines. +**Quality:** `homeboy audit | lint | test | review | refactor`; use `homeboy review --changed-since --report=pr-comment` for PR-style review loops, and `--baseline` / `--ratchet` when a command supports observation baselines. For unregistered checkouts pass both `--path ` and `--extension ` (e.g. `nodejs`) so resolution skips the missing-component error. **Git:** prefer `homeboy changes | status` and `homeboy git status|commit|push|pull|tag|rebase|cherry-pick|pr|issue` — structured output, component/worktree awareness, safer write verbs. Use `--path ` when operating outside a registered component or overriding component resolution. One-off reads (`git diff`, `git show`, `git blame`) stay on raw `git`.