arkadian

Analyze a project repository and add it to the Arkadian documentation registry with standardized structure. Use when: user provides a path to a new project to onboard.

Analyse an Arkadian orchestrator session - read transcripts, logs, and artifacts to understand what happened and suggest improvements. Use when: user wants to debug or review a past session.

Generate validated operational SOPs for Ark ecosystem projects by testing commands before documenting them. Use when: user wants to create or audit SOPs for a project.

Remove a project from the Arkadian documentation registry and delete all associated documentation files. Use when: user wants to deregister a project.

Update project documentation based on new commits and changes in the repository. Use when: user wants to sync docs after project changes.

Self-improvement loop for arkadian. Launches arkadian -d with a GitHub issue, polls until done, evaluates per-agent criteria, reads transcripts on failure, improves prompts, deletes worktree, and relaunches. Loops until passing or max iterations.

Debug and investigate fulmine production issues. Downloads logs and SQLite datadir from remote Docker containers, and queries the Boltz PostgreSQL database remotely. Analyzes errors and queries databases for root cause analysis. Use when: (1) investigating fulmine production errors or failures, (2) checking swap/vHTLC/delegate task status in prod, (3) analyzing fulmine logs for recent issues, (4) debugging VTXO or transaction problems on mainnet, (5) inspecting Boltz swap state in PostgreSQL. Triggers on: "fulmine prod", "production logs", "prod errors", "check prod fulmine", "debug fulmine", "fulmine mainnet issue", "boltz db", "boltz prod".

CLI reference for noa and Ark Indexer REST API — tools for decoding and inspecting Bitcoin/Ark primitives. Use when working with Ark addresses, Bitcoin scripts, taproot trees, PSBTs, note closures, VTXOs, commitment txs, forfeit txs, or connector trees. Covers all noa subcommands (address, script, note, taptree, psbt) and Indexer endpoints (GetCommitmentTx, GetVtxos, GetVtxoTree, GetVtxoChain, GetVirtualTxs, etc.). Includes a step-by-step recipe for investigating any VTXO from an outpoint.

Fast iteration loop for developing arkd locally. Smart pre-flight detects running services, sets up infrastructure, manages wallet state, then iterates with build-test-fix cycles including mandatory log capture.

Simulate arkd GitHub Actions CI pipeline locally. Runs lint, vet, build, unit tests, and integration tests (MANDATORY). Optionally proto lint — matching the real CI checks that run on PRs.

Quick reference for arkd Makefile targets. Use before building, generating code, or running linters. Covers proto generation, build, sqlc, lint, and explains why make test must NEVER be used.

Fast iteration loop for developing fulmine locally. Three infrastructure modes (internal-only, real-boltz, mock-boltz), smart pre-flight checks, and a build-test-fix iteration loop with mandatory log capture.

Simulate fulmine GitHub Actions CI pipeline locally. Runs lint, vet, build, unit tests, and integration tests (MANDATORY). Optionally proto lint and DB vet — matching the real CI checks that run on PRs.

Simulate go-sdk GitHub Actions CI pipeline locally. Runs lint, vet, build, unit tests, and integration tests (MANDATORY). Optionally proto lint — matching the real CI checks that run on PRs.

Core Bitcoin/Taproot knowledge for Ark context - scripts, closures, PSBTs, Schnorr signatures

MuSig2 distributed signing protocol for Ark transaction trees - nonce generation, aggregation, partial signatures

Operational hub for Ark ecosystem tasks. Routes to ark-developer for environment/testing/debugging, or handles simple queries directly.

Batch session event handling and round participation - joining rounds, signing trees, processing events

SDK client initialization and configuration - client types, wallet types, stores, and connection setup

Off-chain payment operations with go-sdk - SendOffChain, coin selection, receivers, change handling

Settlement and exit operations - Settle, CollaborativeExit, Unroll, fee estimation

VTXO lifecycle, domain model, states, expiration, and tree construction in Ark protocol

arkd gRPC API and protobuf definitions - service endpoints, message types, streaming events

Off-chain transaction processing in arkd - Ark TX and checkpoint TX construction, submission, and finalization

Round lifecycle management in arkd - stages, events, state machine, intent registration, finalization

VTXO and connector tree construction - building batch outputs, tree structures, forfeit transactions

RESTRICTED to ark-project-manager. Generate actionable, dependency-ordered task lists organized by user story.

Comprehensive Bitcoin and Layer-2 protocol research using parallel Claude agents. Specialized for Bitcoin Core, Lightning, Ark, and L2 scaling solutions. Three modes (Quick/Standard/Deep) with timeout management and multi-source validation.

Browser automation and visual testing for web development using Playwright MCP

RESTRICTED to ark-developer. Execute the implementation plan by processing and completing all tasks.

RESTRICTED to ark-project-manager. Perform cross-artifact consistency and quality analysis.

RESTRICTED to ark-project-manager. Generate custom quality checklists for validating requirements.

RESTRICTED to ark-project-manager. Identify underspecified areas in specs and ask targeted clarification questions.

RESTRICTED to ark-project-manager. Create or update project constitution with principles and guidelines.

RESTRICTED to ark-project-manager. Execute implementation planning workflow to generate design artifacts.

RESTRICTED to ark-project-manager. Create or update feature specifications from natural language descriptions.