ai-rules

AI assistant configurations for Claude Code, Codex CLI, OpenCode, and Gemini CLI. Supports Solidity and TypeScript development with enterprise-grade defaults. Ideal for operations teams automating blockchain and cloud-native infrastructure tasks.

[{"step":"Identify your primary use case","action":"Select between Solidity smart contract development or TypeScript API scaffolding. For blockchain ops, focus on gas optimization and reentrancy checks. For cloud-native apps, prioritize type safety and security headers.","tip":"Use the 'rules' section to filter relevant checks for your project type. Example: If auditing a DeFi protocol, enable all 'solidity_audit' rules."},{"step":"Customize the configuration file","action":"Edit the [FORMAT] file (e.g., .claude.json) to update benchmarks, thresholds, and regulatory frameworks. Replace [PLACEHOLDERS] with your specific values (e.g., change 'ethereum_mainnet' to 'polygon_pos' if deploying to Polygon).","tip":"For enterprise teams, collaborate with security and compliance teams to validate regulatory rules before deployment."},{"step":"Integrate with your AI assistant","action":"Save the configuration file in your project root or home directory. For Claude Code, place it as '.claude.json'. For Codex CLI, use '.codexrc'. Restart your AI assistant to load the new rules.","tip":"Test the configuration with a non-critical file first. Example: Run 'claude audit --dry-run' on a test contract before applying to production code."},{"step":"Automate execution","action":"Set up CI/CD pipelines to run the AI assistant checks on every commit. Example: Add a GitHub Actions workflow that triggers 'codex check --rules=solidity_audit' on pull requests.","tip":"Use the 'performance' section to set up automated benchmarks. Example: Configure a nightly job to compare gas usage against your target threshold."},{"step":"Monitor and iterate","action":"Review the AI assistant's output logs and adjust rules as needed. Use the 'error_handling' section to refine fallback strategies based on common failures.","tip":"Log false positives/negatives to improve rule accuracy. Example: If the AI flags a safe pattern as reentrant, update the 'reentrancy_guard' rule to exclude that pattern."}]