Claude Code configuration for full-stack Syscoin development — Core (UTXO/SPT) + NEVM (EVM L1).
Status: v0.1.0 is a scaffold. Agents, commands, rules, and skills are not yet populated. See the roadmap in CLAUDE.md for progress.
Inspired by solana-claude-config. Same architectural patterns (two-file CLAUDE.md split, lazy-loaded rules, progressive skill loading, MCP integration, agent teams), adapted for Syscoin's tooling.
- Syscoin Core — UTXO chain, SPT assets, Z-DAG, PSBT, merged-mined with BTC
- NEVM — EVM-compatible L1, Solidity + Hardhat/Foundry
- Not supported: Rollux (being discontinued), zkSYS (deferred)
- Primary: Hardhat + Ethers v6 (matches official Syscoin docs)
- Secondary: Foundry + Viem (fully supported via lazy-loaded rules)
# Once published:
curl -fsSL https://raw.githubusercontent.com/<org>/syscoin-claude-config/main/install.sh | bash
# Or manual:
git clone --recurse-submodules https://github.com/<org>/syscoin-claude-config.git
cp -r syscoin-claude-config/.claude /path/to/your-project/
cp syscoin-claude-config/CLAUDE-syscoin.md /path/to/your-project/CLAUDE.md.
├── CLAUDE.md # Maintainer config (this repo)
├── CLAUDE-syscoin.md # Ships to user projects as CLAUDE.md
├── README.md # This file
├── QUICK-START.md # 2-minute install guide
├── .mcp.json # MCP server configs
├── .env.example # API key template
├── install.sh # One-liner installer
├── update.sh # Update to latest upstream
├── validate.sh # Config integrity check
├── tests/ # Shell-based integrity tests
├── .github/workflows/ # CI
└── .claude/
├── VERSION # Semver
├── CHANGELOG.md # Release log
├── settings.json # Permissions, hooks, agent teams
├── agents/ # Specialized agents (TBD)
├── bin/ # update.sh, resync.sh helpers (TBD)
├── commands/ # Slash commands (TBD)
├── rules/ # Auto-loading file-pattern rules (TBD)
└── skills/
├── SKILL.md # Unified skill hub (TBD)
├── ext/ # External skill submodules (TBD)
└── *.md # Local authored skills (TBD)
| Agent | Purpose |
|---|---|
syscoin-architect |
Cross-layer design (Core vs NEVM), SPT vs ERC-20 tradeoffs, bridging |
solidity-engineer |
NEVM Solidity contracts with Hardhat/Foundry |
syscoin-core-engineer |
UTXO, SPT, PSBT, node RPC |
nevm-frontend-engineer |
Viem/wagmi/Ethers, Pali + MetaMask flows |
syscoin-qa-engineer |
Foundry fuzzing, Hardhat tests, regtest for Core |
devops-engineer |
Node infra, RPC providers, CI/CD |
syscoin-guide |
Learning and tutorials |
syscoin-researcher |
Ecosystem research |
- Build:
/build-contracts,/build-app,/scaffold - Quality:
/test-foundry,/test-hardhat,/audit-syscoin,/diff-review,/gas-profile,/debug-user-tx - Deploy:
/deploy,/verify-contract,/bridge-deploy - Core-specific:
/spt-create,/regtest-up - Workflow:
/quick-commit,/setup-ci-cd,/setup-mcp,/update,/cleanup,/write-docs,/explain-code,/plan-feature,/resync
solidity.md, hardhat.md, foundry.md, ethers.md, viem.md, typescript.md, syscoin-core.md.
- Local:
spt-tokens.md,syscoin-core-rpc.md,nevm-deployment.md,pali-wallet.md,syscoin-reference.md(llms.txt-powered discovery) - Vendored submodules:
trailofbits,cloudflare,vercel
context7, playwright, context-mode, memsearch. Additional EVM RPC / explorer MCPs to be evaluated.
See the full phase plan in CLAUDE.md.
MIT — see LICENSE.