mirror of
https://github.com/wshobson/agents.git
synced 2026-03-18 09:37:15 +00:00
feat: add Conductor plugin for Context-Driven Development
Add comprehensive Conductor plugin implementing Context-Driven Development methodology with tracks, specs, and phased implementation plans. Components: - 5 commands: setup, new-track, implement, status, revert - 1 agent: conductor-validator - 3 skills: context-driven-development, track-management, workflow-patterns - 18 templates for project artifacts Documentation updates: - README.md: Updated counts (68 plugins, 100 agents, 110 skills, 76 tools) - docs/plugins.md: Added Conductor to Workflows section - docs/agents.md: Added conductor-validator agent - docs/agent-skills.md: Added Conductor skills section Also includes Prettier formatting across all project files.
This commit is contained in:
Seth Hobson
@@ -7,11 +7,13 @@ model: opus
|
||||
You are a blockchain developer specializing in production-grade Web3 applications, smart contract development, and decentralized system architectures.
|
||||
|
||||
## Purpose
|
||||
|
||||
Expert blockchain developer specializing in smart contract development, DeFi protocols, and Web3 application architectures. Masters both traditional blockchain patterns and cutting-edge decentralized technologies, with deep knowledge of multiple blockchain ecosystems, security best practices, and enterprise blockchain integration patterns.
|
||||
|
||||
## Capabilities
|
||||
|
||||
### Smart Contract Development & Security
|
||||
|
||||
- Solidity development with advanced patterns: proxy contracts, diamond standard, factory patterns
|
||||
- Rust smart contracts for Solana, NEAR, and Cosmos ecosystem
|
||||
- Vyper contracts for enhanced security and formal verification
|
||||
@@ -23,6 +25,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Multi-signature wallet implementation and governance contracts
|
||||
|
||||
### Ethereum Ecosystem & Layer 2 Solutions
|
||||
|
||||
- Ethereum mainnet development with Web3.js, Ethers.js, Viem
|
||||
- Layer 2 scaling solutions: Polygon, Arbitrum, Optimism, Base, zkSync
|
||||
- EVM-compatible chains: BSC, Avalanche, Fantom integration
|
||||
@@ -33,6 +36,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Cross-chain bridge development and security considerations
|
||||
|
||||
### Alternative Blockchain Ecosystems
|
||||
|
||||
- Solana development with Anchor framework and Rust
|
||||
- Cosmos SDK for custom blockchain development
|
||||
- Polkadot parachain development with Substrate
|
||||
@@ -43,6 +47,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Bitcoin Lightning Network and Taproot implementations
|
||||
|
||||
### DeFi Protocol Development
|
||||
|
||||
- Automated Market Makers (AMMs): Uniswap V2/V3, Curve, Balancer mechanics
|
||||
- Lending protocols: Compound, Aave, MakerDAO architecture patterns
|
||||
- Yield farming and liquidity mining contract design
|
||||
@@ -54,6 +59,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Synthetic asset protocols and oracle integration
|
||||
|
||||
### NFT & Digital Asset Platforms
|
||||
|
||||
- ERC-721 and ERC-1155 token standards with metadata handling
|
||||
- NFT marketplace development: OpenSea-compatible contracts
|
||||
- Generative art and on-chain metadata storage
|
||||
@@ -65,6 +71,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Dynamic NFTs with chainlink oracles and time-based mechanics
|
||||
|
||||
### Web3 Frontend & User Experience
|
||||
|
||||
- Web3 wallet integration: MetaMask, WalletConnect, Coinbase Wallet
|
||||
- React/Next.js dApp development with Web3 libraries
|
||||
- Wagmi and RainbowKit for modern Web3 React applications
|
||||
@@ -75,6 +82,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Decentralized identity (DID) and verifiable credentials
|
||||
|
||||
### Blockchain Infrastructure & DevOps
|
||||
|
||||
- Local blockchain development: Hardhat, Foundry, Ganache
|
||||
- Testnet deployment and continuous integration
|
||||
- Blockchain indexing with The Graph Protocol and custom indexers
|
||||
@@ -85,6 +93,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Multi-chain deployment strategies and configuration management
|
||||
|
||||
### Oracle Integration & External Data
|
||||
|
||||
- Chainlink price feeds and VRF (Verifiable Random Function)
|
||||
- Custom oracle development for specific data sources
|
||||
- Decentralized oracle networks and data aggregation
|
||||
@@ -95,6 +104,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Time-sensitive data handling and oracle update mechanisms
|
||||
|
||||
### Tokenomics & Economic Models
|
||||
|
||||
- Token distribution models and vesting schedules
|
||||
- Bonding curves and dynamic pricing mechanisms
|
||||
- Staking rewards calculation and distribution
|
||||
@@ -105,6 +115,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Economic security analysis and game theory applications
|
||||
|
||||
### Enterprise Blockchain Integration
|
||||
|
||||
- Private blockchain networks and consortium chains
|
||||
- Blockchain-based supply chain tracking and verification
|
||||
- Digital identity management and KYC/AML compliance
|
||||
@@ -115,6 +126,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Regulatory compliance frameworks and reporting tools
|
||||
|
||||
### Security & Auditing Best Practices
|
||||
|
||||
- Smart contract vulnerability assessment and penetration testing
|
||||
- Decentralized application security architecture
|
||||
- Private key management and hardware wallet integration
|
||||
@@ -125,6 +137,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Security monitoring and anomaly detection systems
|
||||
|
||||
## Behavioral Traits
|
||||
|
||||
- Prioritizes security and formal verification over rapid deployment
|
||||
- Implements comprehensive testing including fuzzing and property-based tests
|
||||
- Focuses on gas optimization and cost-effective contract design
|
||||
@@ -137,6 +150,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Considers cross-chain compatibility and interoperability from design phase
|
||||
|
||||
## Knowledge Base
|
||||
|
||||
- Latest blockchain developments and protocol upgrades (Ethereum 2.0, Solana updates)
|
||||
- Modern Web3 development frameworks and tooling (Foundry, Hardhat, Anchor)
|
||||
- DeFi protocol mechanics and liquidity management strategies
|
||||
@@ -149,6 +163,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
- Enterprise blockchain adoption patterns and use cases
|
||||
|
||||
## Response Approach
|
||||
|
||||
1. **Analyze blockchain requirements** for security, scalability, and decentralization trade-offs
|
||||
2. **Design system architecture** with appropriate blockchain networks and smart contract interactions
|
||||
3. **Implement production-ready code** with comprehensive security measures and testing
|
||||
@@ -159,6 +174,7 @@ Expert blockchain developer specializing in smart contract development, DeFi pro
|
||||
8. **Provide security assessment** including potential attack vectors and mitigations
|
||||
|
||||
## Example Interactions
|
||||
|
||||
- "Build a production-ready DeFi lending protocol with liquidation mechanisms"
|
||||
- "Implement a cross-chain NFT marketplace with royalty distribution"
|
||||
- "Design a DAO governance system with token-weighted voting and proposal execution"
|
||||
|
||||
@@ -150,6 +150,7 @@ contract GameItems is ERC1155, Ownable {
|
||||
## Metadata Standards
|
||||
|
||||
### Off-Chain Metadata (IPFS)
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "NFT #1",
|
||||
@@ -175,6 +176,7 @@ contract GameItems is ERC1155, Ownable {
|
||||
```
|
||||
|
||||
### On-Chain Metadata
|
||||
|
||||
```solidity
|
||||
contract OnChainNFT is ERC721 {
|
||||
struct Traits {
|
||||
|
||||
@@ -20,9 +20,11 @@ Master smart contract security best practices, vulnerability prevention, and sec
|
||||
## Critical Vulnerabilities
|
||||
|
||||
### 1. Reentrancy
|
||||
|
||||
Attacker calls back into your contract before state is updated.
|
||||
|
||||
**Vulnerable Code:**
|
||||
|
||||
```solidity
|
||||
// VULNERABLE TO REENTRANCY
|
||||
contract VulnerableBank {
|
||||
@@ -41,6 +43,7 @@ contract VulnerableBank {
|
||||
```
|
||||
|
||||
**Secure Pattern (Checks-Effects-Interactions):**
|
||||
|
||||
```solidity
|
||||
contract SecureBank {
|
||||
mapping(address => uint256) public balances;
|
||||
@@ -60,6 +63,7 @@ contract SecureBank {
|
||||
```
|
||||
|
||||
**Alternative: ReentrancyGuard**
|
||||
|
||||
```solidity
|
||||
import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
|
||||
|
||||
@@ -81,6 +85,7 @@ contract SecureBank is ReentrancyGuard {
|
||||
### 2. Integer Overflow/Underflow
|
||||
|
||||
**Vulnerable Code (Solidity < 0.8.0):**
|
||||
|
||||
```solidity
|
||||
// VULNERABLE
|
||||
contract VulnerableToken {
|
||||
@@ -95,6 +100,7 @@ contract VulnerableToken {
|
||||
```
|
||||
|
||||
**Secure Pattern (Solidity >= 0.8.0):**
|
||||
|
||||
```solidity
|
||||
// Solidity 0.8+ has built-in overflow/underflow checks
|
||||
contract SecureToken {
|
||||
@@ -109,6 +115,7 @@ contract SecureToken {
|
||||
```
|
||||
|
||||
**For Solidity < 0.8.0, use SafeMath:**
|
||||
|
||||
```solidity
|
||||
import "@openzeppelin/contracts/utils/math/SafeMath.sol";
|
||||
|
||||
@@ -126,6 +133,7 @@ contract SecureToken {
|
||||
### 3. Access Control
|
||||
|
||||
**Vulnerable Code:**
|
||||
|
||||
```solidity
|
||||
// VULNERABLE: Anyone can call critical functions
|
||||
contract VulnerableContract {
|
||||
@@ -139,6 +147,7 @@ contract VulnerableContract {
|
||||
```
|
||||
|
||||
**Secure Pattern:**
|
||||
|
||||
```solidity
|
||||
import "@openzeppelin/contracts/access/Ownable.sol";
|
||||
|
||||
@@ -166,6 +175,7 @@ contract RoleBasedContract {
|
||||
### 4. Front-Running
|
||||
|
||||
**Vulnerable:**
|
||||
|
||||
```solidity
|
||||
// VULNERABLE TO FRONT-RUNNING
|
||||
contract VulnerableDEX {
|
||||
@@ -179,6 +189,7 @@ contract VulnerableDEX {
|
||||
```
|
||||
|
||||
**Mitigation:**
|
||||
|
||||
```solidity
|
||||
contract SecureDEX {
|
||||
mapping(bytes32 => bool) public usedCommitments;
|
||||
@@ -206,6 +217,7 @@ contract SecureDEX {
|
||||
## Security Best Practices
|
||||
|
||||
### Checks-Effects-Interactions Pattern
|
||||
|
||||
```solidity
|
||||
contract SecurePattern {
|
||||
mapping(address => uint256) public balances;
|
||||
@@ -226,6 +238,7 @@ contract SecurePattern {
|
||||
```
|
||||
|
||||
### Pull Over Push Pattern
|
||||
|
||||
```solidity
|
||||
// Prefer this (pull)
|
||||
contract SecurePayment {
|
||||
@@ -256,6 +269,7 @@ contract RiskyPayment {
|
||||
```
|
||||
|
||||
### Input Validation
|
||||
|
||||
```solidity
|
||||
contract SecureContract {
|
||||
function transfer(address to, uint256 amount) public {
|
||||
@@ -273,6 +287,7 @@ contract SecureContract {
|
||||
```
|
||||
|
||||
### Emergency Stop (Circuit Breaker)
|
||||
|
||||
```solidity
|
||||
import "@openzeppelin/contracts/security/Pausable.sol";
|
||||
|
||||
@@ -294,6 +309,7 @@ contract EmergencyStop is Pausable, Ownable {
|
||||
## Gas Optimization
|
||||
|
||||
### Use `uint256` Instead of Smaller Types
|
||||
|
||||
```solidity
|
||||
// More gas efficient
|
||||
contract GasEfficient {
|
||||
@@ -315,6 +331,7 @@ contract GasInefficient {
|
||||
```
|
||||
|
||||
### Pack Storage Variables
|
||||
|
||||
```solidity
|
||||
// Gas efficient (3 variables in 1 slot)
|
||||
contract PackedStorage {
|
||||
@@ -334,6 +351,7 @@ contract UnpackedStorage {
|
||||
```
|
||||
|
||||
### Use `calldata` Instead of `memory` for Function Arguments
|
||||
|
||||
```solidity
|
||||
contract GasOptimized {
|
||||
// More gas efficient
|
||||
@@ -349,6 +367,7 @@ contract GasOptimized {
|
||||
```
|
||||
|
||||
### Use Events for Data Storage (When Appropriate)
|
||||
|
||||
```solidity
|
||||
contract EventStorage {
|
||||
// Emitting events is cheaper than storage
|
||||
@@ -394,45 +413,44 @@ const { expect } = require("chai");
|
||||
const { ethers } = require("hardhat");
|
||||
|
||||
describe("Security Tests", function () {
|
||||
it("Should prevent reentrancy attack", async function () {
|
||||
const [attacker] = await ethers.getSigners();
|
||||
it("Should prevent reentrancy attack", async function () {
|
||||
const [attacker] = await ethers.getSigners();
|
||||
|
||||
const VictimBank = await ethers.getContractFactory("SecureBank");
|
||||
const bank = await VictimBank.deploy();
|
||||
const VictimBank = await ethers.getContractFactory("SecureBank");
|
||||
const bank = await VictimBank.deploy();
|
||||
|
||||
const Attacker = await ethers.getContractFactory("ReentrancyAttacker");
|
||||
const attackerContract = await Attacker.deploy(bank.address);
|
||||
const Attacker = await ethers.getContractFactory("ReentrancyAttacker");
|
||||
const attackerContract = await Attacker.deploy(bank.address);
|
||||
|
||||
// Deposit funds
|
||||
await bank.deposit({value: ethers.utils.parseEther("10")});
|
||||
// Deposit funds
|
||||
await bank.deposit({ value: ethers.utils.parseEther("10") });
|
||||
|
||||
// Attempt reentrancy attack
|
||||
await expect(
|
||||
attackerContract.attack({value: ethers.utils.parseEther("1")})
|
||||
).to.be.revertedWith("ReentrancyGuard: reentrant call");
|
||||
});
|
||||
// Attempt reentrancy attack
|
||||
await expect(
|
||||
attackerContract.attack({ value: ethers.utils.parseEther("1") }),
|
||||
).to.be.revertedWith("ReentrancyGuard: reentrant call");
|
||||
});
|
||||
|
||||
it("Should prevent integer overflow", async function () {
|
||||
const Token = await ethers.getContractFactory("SecureToken");
|
||||
const token = await Token.deploy();
|
||||
it("Should prevent integer overflow", async function () {
|
||||
const Token = await ethers.getContractFactory("SecureToken");
|
||||
const token = await Token.deploy();
|
||||
|
||||
// Attempt overflow
|
||||
await expect(
|
||||
token.transfer(attacker.address, ethers.constants.MaxUint256)
|
||||
).to.be.reverted;
|
||||
});
|
||||
// Attempt overflow
|
||||
await expect(token.transfer(attacker.address, ethers.constants.MaxUint256))
|
||||
.to.be.reverted;
|
||||
});
|
||||
|
||||
it("Should enforce access control", async function () {
|
||||
const [owner, attacker] = await ethers.getSigners();
|
||||
it("Should enforce access control", async function () {
|
||||
const [owner, attacker] = await ethers.getSigners();
|
||||
|
||||
const Contract = await ethers.getContractFactory("SecureContract");
|
||||
const contract = await Contract.deploy();
|
||||
const Contract = await ethers.getContractFactory("SecureContract");
|
||||
const contract = await Contract.deploy();
|
||||
|
||||
// Attempt unauthorized withdrawal
|
||||
await expect(
|
||||
contract.connect(attacker).withdraw(100)
|
||||
).to.be.revertedWith("Ownable: caller is not the owner");
|
||||
});
|
||||
// Attempt unauthorized withdrawal
|
||||
await expect(contract.connect(attacker).withdraw(100)).to.be.revertedWith(
|
||||
"Ownable: caller is not the owner",
|
||||
);
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
|
||||
@@ -32,30 +32,30 @@ module.exports = {
|
||||
settings: {
|
||||
optimizer: {
|
||||
enabled: true,
|
||||
runs: 200
|
||||
}
|
||||
}
|
||||
runs: 200,
|
||||
},
|
||||
},
|
||||
},
|
||||
networks: {
|
||||
hardhat: {
|
||||
forking: {
|
||||
url: process.env.MAINNET_RPC_URL,
|
||||
blockNumber: 15000000
|
||||
}
|
||||
blockNumber: 15000000,
|
||||
},
|
||||
},
|
||||
goerli: {
|
||||
url: process.env.GOERLI_RPC_URL,
|
||||
accounts: [process.env.PRIVATE_KEY]
|
||||
}
|
||||
accounts: [process.env.PRIVATE_KEY],
|
||||
},
|
||||
},
|
||||
gasReporter: {
|
||||
enabled: true,
|
||||
currency: 'USD',
|
||||
coinmarketcap: process.env.COINMARKETCAP_API_KEY
|
||||
currency: "USD",
|
||||
coinmarketcap: process.env.COINMARKETCAP_API_KEY,
|
||||
},
|
||||
etherscan: {
|
||||
apiKey: process.env.ETHERSCAN_API_KEY
|
||||
}
|
||||
apiKey: process.env.ETHERSCAN_API_KEY,
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
@@ -64,7 +64,10 @@ module.exports = {
|
||||
```javascript
|
||||
const { expect } = require("chai");
|
||||
const { ethers } = require("hardhat");
|
||||
const { loadFixture, time } = require("@nomicfoundation/hardhat-network-helpers");
|
||||
const {
|
||||
loadFixture,
|
||||
time,
|
||||
} = require("@nomicfoundation/hardhat-network-helpers");
|
||||
|
||||
describe("Token Contract", function () {
|
||||
// Fixture for test setup
|
||||
@@ -94,8 +97,11 @@ describe("Token Contract", function () {
|
||||
it("Should transfer tokens between accounts", async function () {
|
||||
const { token, owner, addr1 } = await loadFixture(deployTokenFixture);
|
||||
|
||||
await expect(token.transfer(addr1.address, 50))
|
||||
.to.changeTokenBalances(token, [owner, addr1], [-50, 50]);
|
||||
await expect(token.transfer(addr1.address, 50)).to.changeTokenBalances(
|
||||
token,
|
||||
[owner, addr1],
|
||||
[-50, 50],
|
||||
);
|
||||
});
|
||||
|
||||
it("Should fail if sender doesn't have enough tokens", async function () {
|
||||
@@ -103,7 +109,7 @@ describe("Token Contract", function () {
|
||||
const initialBalance = await token.balanceOf(addr1.address);
|
||||
|
||||
await expect(
|
||||
token.connect(addr1).transfer(owner.address, 1)
|
||||
token.connect(addr1).transfer(owner.address, 1),
|
||||
).to.be.revertedWith("Insufficient balance");
|
||||
});
|
||||
|
||||
@@ -219,6 +225,7 @@ contract TokenTest is Test {
|
||||
## Advanced Testing Patterns
|
||||
|
||||
### Snapshot and Revert
|
||||
|
||||
```javascript
|
||||
describe("Complex State Changes", function () {
|
||||
let snapshotId;
|
||||
@@ -242,6 +249,7 @@ describe("Complex State Changes", function () {
|
||||
```
|
||||
|
||||
### Mainnet Forking
|
||||
|
||||
```javascript
|
||||
describe("Mainnet Fork Tests", function () {
|
||||
let uniswapRouter, dai, usdc;
|
||||
@@ -249,23 +257,25 @@ describe("Mainnet Fork Tests", function () {
|
||||
before(async function () {
|
||||
await network.provider.request({
|
||||
method: "hardhat_reset",
|
||||
params: [{
|
||||
forking: {
|
||||
jsonRpcUrl: process.env.MAINNET_RPC_URL,
|
||||
blockNumber: 15000000
|
||||
}
|
||||
}]
|
||||
params: [
|
||||
{
|
||||
forking: {
|
||||
jsonRpcUrl: process.env.MAINNET_RPC_URL,
|
||||
blockNumber: 15000000,
|
||||
},
|
||||
},
|
||||
],
|
||||
});
|
||||
|
||||
// Connect to existing mainnet contracts
|
||||
uniswapRouter = await ethers.getContractAt(
|
||||
"IUniswapV2Router",
|
||||
"0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
|
||||
"0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
|
||||
);
|
||||
|
||||
dai = await ethers.getContractAt(
|
||||
"IERC20",
|
||||
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
|
||||
"0x6B175474E89094C44Da98b954EedeAC495271d0F",
|
||||
);
|
||||
});
|
||||
|
||||
@@ -276,19 +286,22 @@ describe("Mainnet Fork Tests", function () {
|
||||
```
|
||||
|
||||
### Impersonating Accounts
|
||||
|
||||
```javascript
|
||||
it("Should impersonate whale account", async function () {
|
||||
const whaleAddress = "0x...";
|
||||
|
||||
await network.provider.request({
|
||||
method: "hardhat_impersonateAccount",
|
||||
params: [whaleAddress]
|
||||
params: [whaleAddress],
|
||||
});
|
||||
|
||||
const whale = await ethers.getSigner(whaleAddress);
|
||||
|
||||
// Use whale's tokens
|
||||
await dai.connect(whale).transfer(addr1.address, ethers.utils.parseEther("1000"));
|
||||
await dai
|
||||
.connect(whale)
|
||||
.transfer(addr1.address, ethers.utils.parseEther("1000"));
|
||||
});
|
||||
```
|
||||
|
||||
@@ -299,8 +312,11 @@ const { expect } = require("chai");
|
||||
|
||||
describe("Gas Optimization", function () {
|
||||
it("Compare gas usage between implementations", async function () {
|
||||
const Implementation1 = await ethers.getContractFactory("OptimizedContract");
|
||||
const Implementation2 = await ethers.getContractFactory("UnoptimizedContract");
|
||||
const Implementation1 =
|
||||
await ethers.getContractFactory("OptimizedContract");
|
||||
const Implementation2 = await ethers.getContractFactory(
|
||||
"UnoptimizedContract",
|
||||
);
|
||||
|
||||
const contract1 = await Implementation1.deploy();
|
||||
const contract2 = await Implementation2.deploy();
|
||||
@@ -337,7 +353,7 @@ npx hardhat coverage
|
||||
// Verify on Etherscan
|
||||
await hre.run("verify:verify", {
|
||||
address: contractAddress,
|
||||
constructorArguments: [arg1, arg2]
|
||||
constructorArguments: [arg1, arg2],
|
||||
});
|
||||
```
|
||||
|
||||
@@ -362,7 +378,7 @@ jobs:
|
||||
- uses: actions/checkout@v2
|
||||
- uses: actions/setup-node@v2
|
||||
with:
|
||||
node-version: '16'
|
||||
node-version: "16"
|
||||
|
||||
- run: npm install
|
||||
- run: npx hardhat compile
|
||||
|
||||
Reference in New Issue
Block a user