DevOS (Custom Rules Registry)

An "Enterprise-Grade but Agile" CLI transpiler and centralized registry for 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), safely initialize rules for your preferred AI agents:

npx devos init --agents opencode,copilot,antigravity

This transpiler CLI will:

Detect the requested agents.
Fetch the compiled rules from the global registry.
Scaffold .agent/, .opencode/, and .github/copilot-instructions.md intelligently tailored to those agents.

🏗️ Repository Structure

This monorepo enforces a strict separation between the "Meta-Agent" tools and the "Data" (the rules).

custom-rules/
├── packages/
│   └── cli/                # The `devos` transpiler CLI codebase
├── registry/               # The Intelligence Database (Single Source of Truth)
│   ├── roles/              # The Squad (Dynamic Personas)
│   └── skills/             # Modular Knowledge & Tools (650+ skills)
├── .agent/                 # Meta-Agent Rules (Isolated context ONLY for building the CLI itself)
└── workflows/              # Procedural Guides (e.g., feature-dev, release-flow)

🧠 Orchestrator & Squad

The custom registry files define a dynamic role-switching architecture.

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 automatically detects these intents and routes the query to the correct expert using registry/roles/.

🤝 Contributing

Add a Skill: Create a new markdown file in registry/skills/.
Update Rules: Modify markdown files in registry/roles/.
Validate: Run devos validate <path> to ensure Zod schema metadata validity before committing.
Publish: The CLI package in packages/cli is published to NPM to distribute these generic definitions to multiple formats.

📝 License

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

Name	copywriting
Description	Use this skill when writing, rewriting, or improving marketing copy for any page (homepage, landing page, pricing, feature, product, or about page). This skill produces clear, compelling, and testable copy while enforcing alignment, honesty, and conversion best practices.