Holmes LabAgentic Software Engineering Architect

From installation to engineering practice

Holmes-Kit
Learn it. Apply it. Verify it.

Use Holmes Lab as a real example. Apply the workflow to your own workspace, with Claude Code CLI, Codex CLI or AGY CLI.

npm 0.40.0 · Documentation basis 2026-11-05

Release history — benefits and upgrade considerations ↗

Give Claude, Codex or AGY CLI a plain guide URL. The agent explains all three installation modes and waits for your choice.

Open the agent installation guide ↗

Basics · follow in order

Your first change,
with evidence.

Install, connect your AI tool, check activation, then carry a small change from intent through verification.

Start hereFrom installation to a verified first change 10 steps · your own workspaceInstall → Connect → Change → Verify

Advanced · choose your situation

What are you trying to solve?

Eight workflows connect the tools to engineering decisions, evidence and recovery.

01 / WORKFLOW

Adopt an existing codebase

Recover specifications from working code while separating observed behavior from intended policy.

Establish reviewable requirement, specification and code links for one module.
02 / WORKFLOW

Refine requirements without duplication

Follow intake from classification and lineage selection to success criteria and approval.

Decide with evidence whether to create a requirement or extend an existing one.
03 / WORKFLOW

Find change impact and missing files

Determine scope using graph candidates, changed files and actual tests together.

Explain which files need edits and verification, along with analysis limits.
04 / WORKFLOW

Tests, review and completion evidence

Connect failure reproduction, regression scope and actual observations instead of reporting only passed.

Produce a review package separating implemented, tested and runtime-observed behavior.
05 / WORKFLOW

Bound and revoke autonomy

Autonomous approval is off by default. A person sets scope and exit conditions only when needed.

Inspect autonomy posture and route out-of-scope actions to refusal or official review.
06 / WORKFLOW

Runs with roles and review gates

Open a run in an isolated worktree with explicit stages and review policy.

Inspect run build, stage and review state, then end it through the official stop procedure.
07 / WORKFLOW

Local semantics and quality checks

Check local model preparation, actual inference and current-code search coverage separately. Cloud is not used by default.

Explain the available semantic tier and search limitations with evidence.
08 / WORKFLOW

Upgrade, recovery and daily operations

Inspect installed version, running server, guidance and native trust separately.

Preserve configuration, verify actual reconnection and recover failures through official routes.