AI agent configuration and domain knowledge hub for the Chia DeFi ecosystem.
This repository contains the agent brain — specialized VS Code agent configuration with deep domain knowledge:
- 🧙 aWizard Agent — custom VS Code agent mode with 40+ tools
- 📚 Skill Library — 17+ domain reference docs (blockchain, DeFi, Discord, React, battle systems)
- 📋 Documentation — Architecture guides, workflows, theme system, deployment maps
- 🎯 Agent Instructions — Workspace-wide Copilot behavior and mode definitions
git clone https://github.com/aWizardxch/aWizard-Familiar.git
cd aWizard-Familiar
code .aWizard agent appears in the VS Code agent dropdown automatically. All domain knowledge is loaded from docs/skills/.
.github/agents/awizard.agent.md— custom agent with 43 built-in tools.github/copilot-instructions.md— workspace-wide Copilot behavior
docs/skills/battleKnowledge.md— PvE/PvP flows, state channelsdocs/skills/apsTierSystem.md— scoring, ability unlocksdocs/skills/nftRewards.md— soulbound NFT mechanicsdocs/skills/aiSeedModel.md— deterministic AI, RNGdocs/skills/bondPvpEconomy.md— bond escrow, player economydocs/skills/leaderboardRankings.md— on-chain rankingsdocs/skills/tournamentSystem.md— brackets, matchmakingdocs/skills/discordActivityAuth.md— OAuth2, NFT gatesdocs/skills/deploymentInfra.md— Vercel/VPS architecturedocs/skills/projectArchitecture.md— module organizationdocs/skills/blockchainDecentralization.md— Chia blockchain philosophydocs/skills/bowAppReference.md— WalletConnect/CHIP-0002, multi-address scanning (chip0002_getPublicKeys), state channel, battle protocol, Fighter typesdocs/skills/snesWorldEngine.md— SNES chunk world, biomes, procedural gen, Godot web exportdocs/skills/networkGameplayUX.md— spell-cast UX, arcane loaders, WebSocket battles, chain tx progress
docs/skills/chiaPerpetuals.md— on-chain CLOB, perpetuals, liquidations, oraclesdocs/skills/nightspireTheme.md— Nightspire CSS token system, glow classes, shared palettedocs/skills/sageRpc.md— Sage Wallet RPC: address derivation,increase_derivation_index, multi-address scanning, coin/CAT/NFT/offer operations, operator patternsdocs/skills/chiaWalletSdk.md— Lower-level wallet-engine reference: spend construction, AggSig, signer behavior,chia-wallet-sdk(the library Sage is built on)docs/skills/chiaPrimitivesPatterns.md— Singleton state machines, CAT issuance, CR-CATs, secure-the-bag distributiondocs/skills/chiaDevTooling.md— Chia docs hub, tracing tools, RPC tooling, package and ops utilitiesdocs/skills/forgePuzzleV10.md— Forge's shipping pool puzzle (V10): coin layout, curried config/state, the bracketed weighted invariant, vaults, reserve and LP authorisation, the four fees, cutting a revisiondocs/skills/forgeLpCat.md— Pool-controlled LP CAT TAIL: the three-part lock (derived action-coin id, pinned mint/melt inners, CAT-parent melt rule) and the mutual handshakedocs/skills/forgePoolLifecycleTesting.md— Forge lanes and endpoints, the guardrails that must never be bypassed, the suite index and what a green run does not prove
docs/skills/clvmPuzzleAudit.md— How to audit a CLVM/Rue puzzle: probe the compiled hex, the announcement-binding taxonomy, ten recurring defect classes, harness and bundle-audit shape, test hygiene, the off-chain bearer-instrument surface. Protocol-agnostic — load it for any puzzle review
docs/skills/warpBridge.md— Complete Chia↔EVM bridge system: 4-step wizard, lockCATs/burnCATs/unlockCATs/mintCATs driver selection, EVM wagmi entry (bridgeEtherToChia/bridgeToChia/bridgeBack), all 3 wallet adapters (Sage WC, Ozone WC, Goby extension), NOSTR validator signature collection, portal singleton mechanics, key puzzle hashes, mainnet contract addresses. Source project:C:\Users\Ricardo\Documents\Web_Connect\warp-ui-love. Full constants:warp-ui-love/docs/agent-swarm/IMPLEMENTATION_CONSTANTS.md
docs/ARCHITECTURE.md— Full ecosystem deployment mapdocs/NIGHTSPIRE_THEME.md— Nightspire CSS token system for all frontendsdocs/AWIZARD_AGENT.md— Agent behavior and mode documentationdocs/CODE_AUDIT_REPORT.md— Code quality baseline and audit resultsdocs/FORGE_PROTOCOL_STATUS.md— Forge protocol status: V10 shipping, why V4–V9 are unsafedocs/FORGE_SECURITY_AUDIT.md— Forge findings log: ten findings, severity, how each was closeddocs/TODO_DEFI.md— DeFi build phases trackingdocs/TODO_WORLD.md— World engine development trackingdocs/QUEST_WORKFLOW.md— Foundation-First pattern quick referencedocs/skills/questManagement.md— Complete quest workflow guide
aWizard operates as a specialized VS Code agent with deep domain knowledge:
- aWizard mode — Project management, architecture enforcement, domain expertise
- Auto-loads skills from
docs/skills/based on context - Enforces TypeScript strict, React 19 hooks, Tailwind CSS 4, Zustand for state
- References Nightspire theme tokens and architecture patterns automatically
- Suggests optimal models: Sonnet 4 for standard work, Opus for complex architecture
Knowledge and power through transparency — security, decentralization, safety, and magic.
aWizard operates on these principles:
- Build brick-by-brick — foundation first, always leave the project buildable
- Transparency breeds trust — every decision is documented and verifiable
- What looks magical is rigorous engineering — the wizard's secret is discipline
MIT