Demonstration codebase for building the AI Layer (CLAUDE.md hierarchy, hooks, skills, LSP, MCP, plugin) — companion repo for the 'How Claude Code works in large codebases' video.
Agent Claude Code
Read-only subsystem explorer. Use it to map an unfamiliar service or package BEFORE editing — it explores with its own context window and reports back, so the main agent edits with the full picture instead of burning its context on discovery. The article's "split exploration from editing" pattern.
Hook Claude Code
Runs when a session starts, executing session_start_context.py via uv with --directory. From coleam00/helpline.
Hook Claude Code
Runs when the agent finishes a response, executing propose_claude_md.py via uv with --directory. From coleam00/helpline.
Settings file Claude Code
Agent settings declaring 2 hook events (SessionStart, Stop) and 4 allowed tools.
Skill Claude CodeCodex
Use when adding or changing an HTTP route under services/api. Walks the exact steps so the new route follows Helpline's gateway conventions.
Skill Claude CodeCodex
Use when creating or editing code under services/billing. Enforces Helpline's money-handling rules — integer cents only, seat limits, and BillingError for every violation.
Skill Claude CodeCodex
Use after changing code, before claiming work is done — picks the correctly scoped pytest command instead of running the whole suite. Helps avoid the timeout-and-context-waste of full-suite runs on a one-service change.
MCP server Claude CodeCodexCursor +2
MCP server "codebase-search" as configured in coleam00/helpline. Runs locally from the dev Python package.
Instructions file
Claude Code instructions for coleam00/helpline, covering helpline, where things live, critical gotchas (repo-wide) and commands.
Plugin Claude Code
Plugin marketplace listing 1 plugin: helpline-ai-layer.
Plugin Claude Code
Portable Helpline AI Layer: the scoped-tests skill, the self-improving CLAUDE.md review hook, the read-only explorer subagent, and the codebase-search MCP server. Install this and any repo gets the team's baseline Claude Code setup on day one.