Build Stellar dApps
with AI Agents

AI orchestration + project scaffolding for Stellar. Six agents write, verify, and deploy contracts, frontends, and payment APIs — no context-switching. The CLI bootstraps the project. The Skill builds it. Use either, or both.

Use with Claude Code / OpenCode
Use standalone
Graph engine routes task to @stellar-contracts@stellar-frontend@stellar-backend — each verified against evals, max 3 retries.

Generic AI tools don't know Stellar

Copilot and ChatGPT don't know contracts must be #![no_std], or that x402 needs OZ Channels and CAIP-2 network IDs. This framework embeds that domain knowledge into 10 skills, 6 agents, and 5 eval files.

Domain Skills

10 bundled knowledge skills (soroban-sdk, Wallets Kit, x402, Groth16, SEPs, MCP, etc.) — loaded on demand, not dumped into context.

Graph Engine Orchestration

Not a chat. The kernel builds a work graph per task — which agents, in what order, sharing what state — and verifies each node before proceeding.

Eval-Driven Pipeline

Every output checked against structured pass/fail evals. Fail → retry with corrective context (max 3). Pass → hand off to next node. No blind trust.

CLI Bootstraps, Skill Builds

The CLI scaffolds a production-ready monorepo (contracts + frontend + backend + CI/CD). The Skill activates AI agents inside it. Together they're a complete workflow.

Org Graph

Six agent nodes, each owning a zone with persistent context and defined edges. Stable structure that persists across sessions.

Zone
Contracts
Rust, WASM, deploy
Zone
Frontend
Next.js, Wallets Kit
Zone
Backend
Express, RPC, x402
Zone
Payments
USDC, Channels, MPP
Zone
DevOps
CI/CD, Docker
Zone
ZK
Groth16, Circom

Graph Engine (CLAUDE.md)

The kernel is not a runtime — it is a structured prompt that tells the AI how to organize its own work. It generates a work graph for every task.

Org Graph

6 agent nodes, each with zone ownership, persistent context, and edge definitions. Stable across sessions.

Work Graph

Per-task dynamic wiring: sequential, parallel, conditional, fan-out, fan-in. Determined by data dependencies, not hardcoded order.

Node Contract

Each node gets intent + context + tools. Returns output + state delta + verifier result. No node writes code outside its zone.

Dynamic Orgs

Graph rewrites itself: spawn nodes mid-task, reroute on failure, collapse on early convergence, reorder on priority shift.

Eval Gate

After each node, run its verifier. Pass → proceed. Fail → retry with corrective context (max 3) → reroute to fallback → escalate.

Edge Context

Shared state (contract IDs, deploy records, .env) travels along edges. Nodes never rediscover what sibling nodes already computed.

Example work graph: "Build a token contract with a React frontend"
[contracts]──(contract_id)──→[frontend]verifier ↓verifier ↓pass → [kernel: synthesize]pass →

Which one?

Two entry points, one framework. Here's how to choose.

Add AI orchestration to an existing Stellar project
Skill → npx skills add ...
Scaffold a brand-new Stellar dApp monorepo
CLI → npx create-stellar-agentic
Build a dApp with AI assistance (recommended)
Both — CLI scaffolds, Skill builds
Use AI agents without Claude Code
CLI only — standalone scaffolding
Skill

Agent Orchestration

For Claude Code and OpenCode users

Adds 6 AI agents to your sessions. The graph engine activates automatically — describe what you want in natural language.

Shell
$ npx skills add rylsherdamz-rgb/stellar-agentic-framework

# or specify your agent
$ npx skills add ... --agent claude-code
$ npx skills add ... --agent opencode
Drops into any existing repo — no project structure required.
CLI

Project Scaffold

For standalone projects (no AI required)

Generates a production-ready monorepo: contracts, frontend, backend, CI/CD, and agent files. The CLI auto-installs the Skill too.

Shell
$ npx create-stellar-agentic my-dapp --yes

✔ Scaffolding Stellar Agentic dApp...
✔ contracts/hello-world/src/lib.rs
✔ contracts/token/src/lib.rs
✔ frontend/src/app/page.tsx
✔ backend/src/index.ts
✔ All 10 skills installed
Killer feature: opening the generated project in Claude Code auto-activates the full harness — no extra steps.

Everything you need to ship on Stellar

Six specialist agents, 10 domain skills, 5 eval files. From contract to deployment in minutes.

Smart Contracts

Scaffold Rust/Soroban contracts with build, test, and deploy workflows — testnet gated.

dApp Frontends

Generate Next.js apps pre-integrated with Stellar Wallets Kit, hooks, and tx flows.

Backend APIs

Build API servers and indexers that query Stellar RPC and Horizon with x402 middleware.

x402 Payments

Monetize APIs with HTTP 402 and Stellar USDC — zero-XLM clients via OZ Channels.

Zero-Knowledge Proofs

Integrate Groth16, Circom, and Noir verifiers into Stellar contracts via BLS12-381.

Eval-Driven Pipeline

Every agent output verified against structured evals with max 3 retries. No blind trust.

Six agents with edge context

Each agent is a structured prompt configuration (not a running process). They communicate through a defined graph — data flows along edges, not through the kernel.

@stellar-contracts
Rust smart contract engineer
contract IDs, ABI
soroban-sdkWASMdeploy
@stellar-frontend
dApp frontend developer
contract IDs
API route specs
ReactWallets KitTailwind
@stellar-backend
API and indexer engineer
payment middleware, API needs
RPCHorizonData
@stellar-payments
Payment flow architect
middleware code
USDCPaywallMPP
@stellar-ops
DevOps and platform engineer
build artifacts from all nodes
CI/CDDockerGitHub Actions
@stellar-zk
Zero-knowledge engineer
verifier contract WASM
Groth16CircomNoir

Ship in 3 steps

From empty directory to deployed dApp — the graph engine handles routing, verification, and knowledge graphing.

01

Install

Pick your entry point — Skill for AI orchestration, CLI for project scaffolding, or both.

$ npx skills add rylsherdamz-rgb/stellar-agentic-framework
$ npx create-stellar-agentic my-dapp --yes
02

Describe

Tell the graph engine what to build. It generates a work graph and routes to the right agents.

@stellar-contracts create a SAC-compatible token with mint, burn, and transfer operations
03

Ship

Agents write code, evals verify it, knowledge graph maps the project. Deploy with one command.

Contract compiles to WASM
Tests pass
Auth on privileged functions
TTL on writes
Frontend wallet connect/disconnect
6/6 evals passed
/deploy . testnet