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/.

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.