by irahardianto
Comprehensive sets of standards and practices designed to elevate the capabilities of AI coding agents.
# Add to your Claude Code skills
git clone https://github.com/irahardianto/awesome-agvNo comments yet. Be the first to share your thoughts!
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:
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.
💡 Everything is modular. Rules, skills, agents, and workflows work independently — you don't need everything to benefit. Use only what you need, modify anything, or build your own. It's a toolkit, not a framework.
To equip your AI agent with these superpowers, follow these steps.
Quick Install (recommended):
npx awesome-agv
This downloads and installs the latest .agents/ directory into your current project. Your AI agent will automatically pick it up — no additional configuration needed.
Options:
| Flag | Description |
| -------------- | ---------------------------------------------- |
| [target-dir] | Directory to install into (default: ./) |
| --force, -f | Overwrite existing .agents/ without prompting |
| --help, -h | Show help |
# Install into current directory
npx awesome-agv
# Install into a specific project
npx awesome-agv ./my-project
# Overwrite existing installation without prompting
npx awesome-agv --force
Manual Install:
.agents folder into the root of your project.
cp -r /path/to/awesome-agv/.agents ./your-project-root/
.agents directory (most of well-known AI coding assistant are adhering to the .agents convention by default, no action needed) or manually ingest the .agents/rules/** as part of its system prompt.Once installed, the rules and skills in this repository become active for your agent.
The setup uses a two-tier rule system to minimize noise while maximizing coverage:
| Type | Trigger | Purpose |
| -------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Mandates | always_on | Non-negotiable constraints loaded in every session (security, logging, code completion). |
| Principles | model_decision | 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.
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.
graph TD
accessibility_principles["accessibility-principles.md"]
api_design_principles["api-design-principles.md"]
architectural_pattern["architectural-pattern.md"]
ci_cd_principles["ci-cd-principles.md"]
code_completion_mandate["code-completion-mandate.md"]
code_idioms_and_conventions["code-idioms-and-conventions.md"]
code_organization_principles["code-organization-principles.md"]
command_execution_principles["command-execution-principles.md"]
concurrency_and_threading_mandate["concurrency-and-threading-mandate.md"]
concurrency_and_threading_principles["concurrency-and-threading-principles.md"]
configuration_management_principles["configuration-management-principles.md"]
core_design_principles["core-design-principles.md"]
data_serialization_and_interchange_principles["data-serialization-and-interchange-principles.md"]
database_design_principles["database-design-principles.md"]
dependency_management_principles["dependency-management-principles.md"]
documentation_principles["documentation-principles.md"]
error_handling_principles["error-handling-principles.md"]
flutter_idioms_and_patterns["flutter-idioms-and-patterns.md"]
git_workflow_principles["git-workflow-principles.md"]
go_idioms_and_patterns["go-idioms-and-patterns.md"]
logging_and_observability_mandate["logging-and-observability-mandate.md"]
logging_and_observability_principles["logging-and-observability-principles.md"]
monitoring_and_alerting_principles["monitoring-and-alerting-principles.md"]
performance_optimization_principles["performance-optimization-principles.md"]
project_structure_flutter_mobile["project-structure-flutter-mobile.md"]
project_structure_go_backend["project-structure-go-backend.md"]
project_structure_rust_cargo["project-structure-rust-cargo.md"]
project_structure_vue_frontend["project-structure-vue-frontend.md"]
project_structure["project-structure.md"]
resources_and_memory_management_principles["resources-and-memory-management-principles.md"]
rugged_software_constitution["rugged-software-constitution.md"]
rule_priority["rule-priority.md"]
rust_idioms_and_patterns["rust-idioms-and-patterns.md"]
security_mandate["security-mandate.md"]
security_principles["security-principles.md"]
testing_strategy["testing-strategy.md"]
typescript_idioms_and_patterns["typescript-idioms-and-patterns.md"]
vue_idioms_and_patterns["vue-idioms-and-patterns.md"]
python_idioms_and_patterns["python-idioms-and-patterns.md"]
project_structure_python_backend["project-structure-python-backend.md"]
feature_flags_principles["feature-flags-principles.md"]
ci_cd_gitops_kubernetes["ci-cd-gitops-kubernetes.md"]
accessibility_principles --> core_design_principles
accessibility_principles --> security_principles
accessibility_principles --> testing_strategy
api_design_principles --> data_serialization_and_interchange_principles
api_design_principles --> error_handling_principles
api_design_principles --> logging_and_observability_mandate
api_design_principles --> security_mandate
api_design_principles --> security_principles
architectural_pattern --> code_organization_principles
architectural_pattern --> core_design_principles
architectural_pattern --> database_design_principles
architectural_pattern --> project_structure
architectural_pattern --> testing_strategy
ci_cd_principles --> code_completion_mandate
ci_cd_principles --> git_workflow_principles
ci_cd_principles --> project_structure
ci_cd_principles --> security_mandate
ci_cd_principles --> testing_strategy
code_completion_mandate --> code_idioms_and_conventions
code_completion_mandate --> flutter_idioms_and_patterns
code_completion_mandate --> go_idioms_and_patterns
code_completion_mandate --> rugged_software_constitution
code_completion_mandate --> rust_idioms_and_patterns
code_completion_mandate --> typescript_idioms_and_patterns
code_completion_mandate --> vue_idioms_and_patterns
code_idioms_and_conventions --> code_completion_mandate
code_idioms_and_conventions --> core_design_principles
code_idioms_and_conventions --> flutter_idioms_and_patterns
code_idioms_and_conventions --> go_idioms_and_patterns
code_idioms_and_conventions --> rust_idioms_and_patterns