Antigravity Custom Rules Library

A portable, high-performance library of AI coding rules, workflows, and skills designed to supercharge agentic assistance.

This repository serves as a centralized "Gold Standard" for coding practices, architecture patterns, and operational workflows.

🚀 Quick Start

In any project (new or existing), simply run:

npx @poletron/ruleset add

This interactive wizard will:

1. Initialize your configuration (ruleset.json).
2. Help you select Skills (React, TypeScript, Docker, etc.) or Presets (Frontend, Backend, etc.).
3. Automatically link the rules into your .agent/ folder using Symlinks (keeping your repo clean).

🏗️ Repository Structure

This monorepo contains both the source of intelligence (rules) and the tooling to distribute it (CLI).

poletron-knowledge/
├── packages/
│   └── cli/                # The @poletron/ruleset CLI tool
├── rules/                  # The Intelligence Layer
│   ├── 00-orchestrator.md  # MASTER ROUTER (Always Active)
│   ├── 01-base-protocol.md # Universal Standards
│   └── roles/              # The Squad (Dynamic Personas)
├── workflows/              # Procedural Guides (e.g., feature-dev, release-flow)
└── skills/                 # Modular Knowledge & Tools (60+ skills)
    ├── react/
    ├── typescript/
    ├── docker/
    └── ...

🧠 Orchestrator & Squad

This library uses a dynamic role-switching architecture defined in .agent/rules/.

Intent	Active Role	Focus
Requirements / Business	👔 Product Manager	ROI, User Stories, Scope
System Design / DB	🏗️ Architect	Scalability, Diagrams, Data Models
Coding / Implementation	👓 Tech Lead	Clean Code, SOLID, Refactoring
Security / Audit	🛡️ Security Eng	IAM, OWASP, Prowler
Deploy / Logs / Action	🚒 SRE / DevOps	Observability, Stability, RCA
Testing / Verification	🧪 QA Engineer	E2E, Edge Cases, Bugs

The Orchestrator (00-orchestrator.md) automatically detects these intents and routes the query to the correct expert.

🤝 Contributing

1. Add a Skill: Create a new folder in skills/ using the skill-creator template.
2. Update Rules: Modify markdown files in rules/.
3. Publish: The CLI package in packages/cli is published to NPM to distribute these updates.
4. References: See rules/rule-creation.md for guidelines.

📝 License

CC0 1.0 Universal (Public Domain Dedication). See LICENSE.