harmonograf

Understand and safely change heartbeat interval, stuck threshold, and timeout constants — client cadence, server detection math, frontend signal.

Add a new AnnotationKind — proto, storage, ingress RPC, optional downstream delivery to agents, frontend authoring UI, tests.

Add a new agent Capability — proto enum, client advertisement, server ingest, frontend gating in the control UI.

Add a new ControlKind — capability advertisement, client handler, server routing, ack semantics, frontend button, and tests — all the way through.

Add a new drift kind end-to-end. Goldfive owns the detector + enum; harmonograf reflects the kind through the intervention aggregator and the UI timeline.

Script a complex multi-turn FakeLlm scenario — function calls, tool chains, drift events, side-effect hooks, partial responses — for deterministic adk test coverage.

Add a field to a proto message end-to-end — proto edit, regen, client+server converters, frontend types, tests, and sqlite migration if persisted.

Add a new reporting tool. Reporting tools moved to goldfive post-migration; harmonograf no longer owns `client/harmonograf_client/tools.py`. This skill redirects to goldfive and covers the harmonograf-side touchpoints.

Introspect harmonograf frontend state — SessionStore, TaskRegistry, uiStore, GanttRenderer subscriptions — when the UI and the server data disagree.

Diagnostic playbook when a task appears stuck. Post-overlay-era: PENDING → NOT_NEEDED at invocation end is expected.

Retained for history. Plan-state invariants moved to goldfive. This skill redirects.

Profile ADK callback overhead on the current telemetry plugin + goldfive per-LLM-call metrics.

Orient on harmonograf before making changes. Read AGENTS.md, the dev guide, design docs, and key source files in the right order.

Understand revision_index and plan lineage. Plan refine logic moved to goldfive; harmonograf only stores + renders the revisions.

Harmonograf-specific PR review checklist — cross-layer coherence, state machine safety, test coverage, UI regression screens.

Launch the full harmonograf demo stack (server + Vite frontend + adk web presentation_agent), drive a prompt, tail logs, and capture a trace.

Retained for history. `client/harmonograf_client/adk.py` is gone — the ADK adapter logic moved to goldfive. For ADK plugin work today, see the small `telemetry_plugin.py`.

Planner prompts live in goldfive. This skill redirects and describes the harmonograf-side touchpoints for planner output changes.

Pattern for writing a new end-to-end test in tests/e2e/ — real ADK + real harmonograf server, scripted FakeLlm for determinism.

Add an entirely new proto message (not just a field) end-to-end across .proto, regen, Python + TS converters, storage, server ingest, and tests.

Add a new persistence backend behind the Store ABC — subclass, factory wiring, conformance tests, cascade deletes, and benchmarking.

Add a new tab to the span inspector drawer — TabId, TABS registry, body component, uiStore deep-link, tests.

Pattern for adding a new per-agent Gantt overlay — client telemetry source → proto field → server storage → bus delta → frontend renderer layer → uiStore toggle.

Add or change a global keyboard shortcut — shortcuts.ts registry, uiStore action, HelpOverlay entry, tests.

Add a new canvas-layer overlay to the Gantt renderer — RAF draw order, layer composition, viewport transform, hit testing.

Add a new SpanKind enum value — proto, converters, renderer color, status semantics, kind_string fallback, and tests.

Stage a breaking proto change across client/server/frontend without splitting the fleet — deprecate, dual-write, migrate, remove.

Add a column or table to the sqlite store without nuking existing data — the idempotent PRAGMA + ALTER TABLE pattern used throughout sqlite.py.

Safely edit the client ring buffer and transport worker — preserve drop ordering, thread safety, and reconnect-resume semantics.

Organize iter-style meta-work across a multi-agent Claude Code team — TeamCreate, task-claim flow, coordination via SendMessage, completion reporting.

Pattern for adding a new shell component — wire into TaskRegistry or sessionsStore, place in Shell/AppBar/Drawer, add vitest, keep tsc + eslint clean.