irahardianto / awesome-agv

Awesome AGV A rugged, high-quality configuration suite for AI Agents. View Rules & Skills · Report Bug · Request Feature About Awesome AGV **Awesome AGV** provides a comprehensive sets of standards and practices designed to elevate the capabilities of AI coding agents. It provides a suite of strict rules distilled from software engineering best practices that ensure generated code is secure, defensible, and maintainable. It also provides specialized skills that will help throughout software development. Instead of just generating code that works, the rules and skills ensures agents generate code that **survives**. > **⚠️ Opinionated by design.** Awesome AGV ships with opinionated defaults for specific technology stacks. See Opinionated Technology Choices for details and how to customize. While this configuration is originally designed for **Antigravity**, it is built on standard markdown-based context protocols that are easily portable to other AI coding tools. As a matter of fact, the original form Technical Constitution was first created for **Gemini CLI** You can drop this configuration into the context or custom rule settings of: • **Roo Code** • **Claude Code** • Any other agentic tool that supports custom system prompts or context loading. For example, the principles of the Rugged Software Constitution which is based on Rugged Software Manifesto are universal and will improve the output of any LLM-based coding assistant. Key Features • 📏 **42 Rules** — covering security, reliability, architecture, maintainability, language idioms, and DevOps. • 🛠️ **7 Skills** — specialized capabilities for debugging, design, code review, and more. • 🔄 **10 Workflows** — end-to-end development processes from research to ship. • 🏗️ **Two-Tier Rule System** — always-on mandates + contextual principles for zero-noise enforcement. > **💡 Everything is modular.** Rules and skills work independently — you don't need workflows to benefit from them. Use only what you need, modify anything, or build your own workflows. It's a toolkit, not a framework. Getting Started To equip your AI agent with these superpowers, follow these steps. Prerequisites • An AI Coding Assistant (Antigravity, Roo Code, Cline, etc.) • A project where you want to enforce high standards. Installation **Quick Install (recommended):** This downloads and installs the latest directory into your current project. Your AI agent will automatically pick it up — no additional configuration needed. **Options:** | Flag | Description | | -------------- | ---------------------------------------------- | | | Directory to install into (default: ) | | | Overwrite existing without prompting | | | Show help | Examples **Manual Install:** • Clone this repository or copy the folder into the root of your project. • Ensure your AI agent is configured to read from the directory (most of well-known AI coding assistant are adhering to the convention by default, no action needed) or manually ingest the as part of its system prompt. Usage Once installed, the rules and skills in this repository become active for your agent. Rule Architecture The setup uses a **two-tier rule system** to minimize noise while maximizing coverage: | Type | Trigger | Purpose | | -------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | | **Mandates** | | Non-negotiable constraints loaded in every session (security, logging, code completion). | | **Principles** | | Contextual guidance activated only when working on relevant areas (e.g., database rules activate only when writing queries). | Conflicts between rules are resolved by Rule Priority — security always wins. Rule Dependencies The rules are highly interconnected to provide comprehensive coverage. You can explore these relationships using the **Interactive Rule Dependency Graph**, or view the static diagram below. View Dependency Graph (Mermaid) Comprehensive Rule Suite The power of the setup comes from its extensive collection of rules covering every aspect of software engineering. 🛡️ Security & Integrity • **Rugged Software Constitution**: The core philosophy of defensible coding. • **Security Mandate**: Non-negotiable security requirements. • **Security Principles**: Best practices for secure design. ⚡ Reliability & Performance • **Error Handling Principles**: Techniques for robust error management. • **Concurrency & Threading**: Safe parallel execution and deadlock prevention. • **Concurrency & Threading Mandate**: When to use (and not use) concurrency. • **Performance Optimization**: Writing efficient and scalable code. • **Resource Management**: Handling memory and system resources responsibly. • **Monitoring & Alerting**: Health checks, metrics, and graceful degradation. • **[Configur _...truncated for preview_