using-superpowers

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

```bash

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

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

```text

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/

└── ...

```

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.

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.

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