claude-code-agent

Use when configuring, running, inspecting, or troubleshooting divedra auto-improve supervision. Applies to workflow run --auto-improve, nested supervisor/superviser workflows, supervision policies, stall detection, remediation budgets, workflow patch modes, targeted reruns, supervision state, nestedSuperviserDriver, and GraphQL/library parity for supervised execution.

Use when configuring, validating, emitting, serving, listing, replaying, or troubleshooting divedra external event sources. Applies to .divedra-events, events validate/emit/serve/list/replay, webhook/chat/cron bindings, event-to-workflow input mapping, supervised event execution, mock scenarios for events, and event receipt inspection.

Use when implementation work in this repository changes behavior, adds functionality, or fixes bugs and the user has not explicitly asked to avoid workflows. Routes the work through the project-local divedra workflow `.divedra/workflows/design-and-implement-review-loop`, including design/plan alignment, implementation, review, user-facing documentation refresh, commit-message generation, and built-in git commit/push steps.

Use when implementing or issuing divedra manager control-plane actions. Applies to divedra graphql, GraphQL manager mutations, sendManagerMessage, retry-step, replay-communication, optional-step execute/skip decisions, manager session auth, idempotency keys, scoped attachments, and avoiding freeform-only privileged control.

Use when using, reviewing, or implementing divedra node add-ons. Applies to workflow.nodes[].addon, built-in divedra add-ons, local scoped add-ons, third-party add-on resolvers, addon.config, addon.inputs, addon.env, node add-on validation, and add-on-backed worker nodes.

Use when diagnosing failed, paused, stalled, timed out, or surprising divedra workflow executions. Applies to session status/progress/logs/export, runtime artifacts, node execution records, workflow validation failures, backend invocation errors, timeout failures, GraphQL inspection, event receipts, and artifact/session-store path issues.

Use when explaining or operating the divedra terminal UI as an end user. Applies to launching the TUI/server UI, workflow overview/status browsing, pane navigation, selected workflow/session inspection, keyboard movement expectations, and operator workflows. Do not use for implementing TUI code changes; use tui-navigation-guardrails for code modifications.

Use when organizing, deduplicating, or refactoring divedra workflow bundles. Applies to reducing duplicate workflows, extracting reusable called workflows through cross-workflow transitions, using called-workflow composition, consolidating repeated prompts/nodes/add-ons, reviewing historical runtime artifacts, and improving workflow structure or input/output contracts from observed execution failures.

Use when helping developers integrate with divedra workflows programmatically. Applies to the divedra package API, createWorkflowExecutionClient, inspectWorkflow, executeWorkflow, resumeWorkflow, rerunWorkflow, getRuntimeSessionView, callWorkflowStep, executeGraphqlRequest, createGraphqlSchema, executeGraphqlDocument, GraphQL control-plane queries and mutations, divedra graphql, manager-session auth, and choosing between local library calls and remote GraphQL endpoint calls.

Use when modifying terminal UI pane focus, keybindings, detail viewers, or selected-row rendering. Requires reviewing the repository TUI rules and design spec before changing behavior.

Use when creating implementation plans from design documents. Provides plan structure, status tracking, and progress logging guidelines.

Use when auditing codebase for custom implementations that can be replaced with well-known libraries. Provides replacement patterns, audit checklist, and migration strategies.

Use when writing TypeScript code that interacts with dependencies, handles credentials, executes child processes, or manages configuration. Provides Shai-Hulud supply chain attack countermeasures at the code level including safe dependency usage, credential handling, subprocess hardening, and runtime integrity patterns.

Use when installing, updating, or auditing npm dependencies with Bun. Provides Shai-Hulud supply chain attack countermeasures including bunfig.toml hardening, lockfile verification, trustedDependencies management, and CI/CD pipeline security.

Use when creating, publishing, or maintaining npm packages with Bun. Provides Shai-Hulud supply chain attack countermeasures including npm token management, 2FA enforcement, provenance signing, trusted publishing via GitHub Actions, and pre-publish security checklists.

Use when writing, reviewing, or refactoring TypeScript code. Provides type safety patterns, error handling, project layout, and async programming guidelines.

Use when executing tasks from implementation plans. Provides task selection, parallel execution, progress tracking, and review cycle guidelines.

Use when creating implementation plans from design documents. Provides plan structure, status tracking, and progress logging guidelines.

Use when creating or organizing design documents. Provides directory structure, file naming, and content guidelines for design specs and references.

Use when writing, reviewing, or refactoring TypeScript code. Provides type safety patterns, error handling, project layout, and async programming guidelines.