Apocrathia

Invoke homelab kagent agents through the LiteLLM A2A broker (list agents, send messages, stream, poll tasks). Use when delegating to git-agent, homelab-agent, hermes-agent, or other registered A2A peers — not via MCP.

Reconcile AGENTS.md and .agents/context/ against the repo: fix broken links, catalog drift, and routing mismatches. Use when asked to sync, reconcile, or update the agent context.

Close the docs/backlog side of a lap: fix behavior docs the change made wrong; delete satisfied issues/plans; fix backlinks. Use after implement, before draft-commit — not for AGENTS/.agents context drift.

Well-lit path from blank start to merged contribution: discover ranked work, execute one launch brief from find-work, reconcile docs and context, ship, cleanup. Use when the operator says self-improve, /self-improve, run the work graph or work loop, go…

Interview the operator until shared understanding. Gated branches one at a time; independent discrete choices may share one structured-question turn. Use when stress-testing an idea, design, or requirement; resolving open questions before acting; or when the…

Idle-only tier-8 research lap: run bounded, metric-driven experiments from an operator-approved contract; ship writeups under docs/research/ only. Experimental code does not enter GitOps. Use when the operator says autoresearch, or find-work surfaces a tier-8…

Inventory and remove unused git worktrees and local branches that are fully merged (or content-equivalent) on main. Required before creating a new worktree (see worktrees.md). Also use when the user asks to clean up worktrees, prune merged branches, remove…

Tear down the agent worktree and stop after a merged MR. Use when the user says clock out, /clock-out, clean up your workspace, or sends the post-merge dismissal.

Mine Home Assistant history for automation trigger candidates from a narrative or structured event brief. Use when finding a reliable trigger, correlating a morning/evening sequence, ranking sensor signals for a new automation, or running the pattern-analyst…

Interview the operator about a topic until shared understanding, walking each branch of the decision tree one at a time. Use when stress-testing an idea, design, or requirement; resolving open questions before acting; or when the user says alignment,…

Explore packages/, layout, and .agents/ for architectural friction (coupling, shallow packages, missing boundaries) and file or recommend agent issues under docs/issues/. Use when improving config shape, before large refactors, or when find-work should…

Create or update an agent-reported issue under docs/issues/. Use when an agent finds a bug, feature gap, or spec-level ask that is out of scope for the current lap, or when asked to file an issue. Does not create GitHub issues. Never writes Local Todo ICS or…

Orient on Home Assistant Homelab, scout read-only work sources (docs/issues + docs/plans, local_todo Issues/Tasks/Ideas ICS, shopping list, docs, TODO markers), rank a backlog with evidence, and emit launch briefs. Use when the user says find work,…

One change lap for Home Assistant Homelab: scope, edit, validate, hand off with a suggested Conventional Commit. Use when implementing a config fix, package change, plan checkbox, or agent-context update.

Fix drift in Home Assistant Homelab agent context (AGENTS.md, CLAUDE.md, .agents/context/, rules, skills, agents) against the repo. Run check_links and check_discovery. Use when asked to sync, reconcile, or update agent context.

Sync docs/ with Home Assistant packages and project reality, and delete satisfied docs/issues and docs/plans in the shipping change. Use after package/layout changes or when asked to update docs.