ai-rules

ai-rules is a collection of professional skills for AI assistants including Claude Code, Codex CLI, OpenCode, and Gemini CLI. It provides pre-configured, production-ready skills for Solidity smart contract development, TypeScript applications, Kubernetes deployments, infrastructure-as-code with Pulumi, and modern authentication frameworks. The skill set emphasizes security-first practices for blockchain development and enterprise-grade defaults for cloud-native infrastructure automation. Operations teams and developers can install skills globally or sync them to projects, then reference them through natural language commands to accelerate setup and implementation. Each skill includes best practices for tools like Foundry, Drizzle ORM, NestJS, and the TanStack ecosystem.

[{"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."}]