💍 The Ring - Skills Library for AI Agents

Proven engineering practices, enforced through skills.

Ring is a comprehensive skills library and workflow system for AI agents that transforms how AI assistants approach software development. Currently implemented as a Claude Code plugin marketplace with 6 active plugins and 89 skills (see .claude-plugin/marketplace.json for current versions), the skills themselves are agent-agnostic and can be used with any AI agent system. Ring provides battle-tested patterns, mandatory workflows, and systematic approaches across the entire software delivery value chain.

✨ Why Ring?

Without Ring, AI assistants often:

Skip tests and jump straight to implementation
Make changes without understanding root causes
Claim tasks are complete without verification
Forget to check for existing solutions
Repeat known mistakes

Ring solves this by:

Enforcing proven workflows - Test-driven development, systematic debugging, proper planning
Providing 89 specialized skills (22 core + 29 dev-team + 15 product planning + 7 FinOps regulatory + 7 technical writing + 9 PMO)
38 specialized agents - 10 review/planning + 12 developer + 4 product research + 3 FinOps regulatory + 3 technical writing + 6 PMO
Automating skill discovery - Skills load automatically at session start
Preventing common failures - Built-in anti-patterns and mandatory checklists

🤖 Specialized Agents

Review & Planning Agents (default plugin):

ring:code-reviewer - Foundation review (architecture, code quality, design patterns)
ring:business-logic-reviewer - Correctness review (domain logic, requirements, edge cases)
ring:security-reviewer - Safety review (vulnerabilities, OWASP, authentication)
ring:test-reviewer - Test quality review (coverage, edge cases, assertions, test anti-patterns)
ring:nil-safety-reviewer - Nil/null safety review (traces pointer risks, missing guards, panic paths)
ring:consequences-reviewer - Ripple effect review (traces how changes propagate beyond modified files - caller chains, consumer contracts, downstream breakage)
ring:dead-code-reviewer - Dead code review (orphaned code detection, reachability analysis, dead dependency chains)
ring:review-slicer - Review slicer (groups large multi-themed PRs into thematic slices for focused parallel review)
ring:write-plan - Implementation planning agent
ring:codebase-explorer - Deep architecture analysis (deep-analysis, complements built-in Explore)
Use /ring:codereview command to orchestrate parallel review workflow

Developer Agents (dev-team plugin):

ring:backend-engineer-golang - Go backend specialist for financial systems
ring:backend-engineer-typescript - TypeScript/Node.js backend specialist (Express, NestJS, Fastify)
ring:devops-engineer - DevOps infrastructure specialist
ring:frontend-bff-engineer-typescript - BFF & React/Next.js frontend with Clean Architecture
ring:frontend-designer - Visual design specialist
ring:frontend-engineer - Senior Frontend Engineer (React/Next.js)
ring:prompt-quality-reviewer - Agent Quality Analyst
ring:qa-analyst - Quality assurance specialist
ring:qa-analyst-frontend - Frontend QA specialist (accessibility, visual, E2E, performance)
ring:sre - Site reliability engineer (monitoring, alerting, SLOs)
ring:ui-engineer - UI component specialist (design systems, accessibility)
ring:helm-engineer - Helm chart specialist (chart structure, security, Lerian conventions)

Standards Compliance: All dev-team agents include a ## Standards Compliance output section with conditional requirement:

Optional when invoked directly or via ring:dev-cycle

MANDATORY when invoked from ring:dev-refactor (triggered by **MODE: ANALYSIS ONLY** in prompt)

When mandatory, agents load Ring standards via WebFetch and produce comparison tables with:

Current Pattern vs Expected Pattern

Severity classification (Critical/High/Medium/Low)

File locations and migration recommendations

See dev-team/docs/standards/*.md for standards source. Cross-references: CLAUDE.md (Standards Compliance section), dev-team/skills/dev-refactor/SKILL.md

Product Research Agents (ring-pm-team plugin):

ring:repo-research-analyst - Repository structure and codebase analysis
ring:best-practices-researcher - Industry best practices research
ring:framework-docs-researcher - Framework documentation research
ring:product-designer - Product design and UX research

Technical Writing Agents (ring-tw-team plugin):

ring:functional-writer - Functional documentation (guides, tutorials, conceptual docs)
ring:api-writer - API reference documentation (endpoints, schemas, examples)
ring:docs-reviewer - Documentation quality review (voice, tone, structure, completeness)

FinOps Agents (ring-finops-team plugin):

ring:finops-analyzer - Financial operations analysis
ring:finops-automation - FinOps template creation and automation
ring:infrastructure-cost-estimator - Infrastructure cost estimation and analysis

PMO Agents (ring-pmo-team plugin):

ring:portfolio-manager - Portfolio-level planning and multi-project coordination
ring:resource-planner - Capacity planning and resource allocation optimization
ring:risk-analyst - Portfolio risk identification and mitigation planning
ring:governance-specialist - Gate reviews and process compliance
ring:executive-reporter - Executive dashboards and stakeholder communications
ring:delivery-reporter - Delivery status reporting and tracking

Plugin versions are managed in .claude-plugin/marketplace.json

📦 Archived Plugins

The following plugins have been archived and are not actively maintained. They remain available in .archive/ for reference:

| Plugin | Description | Status | | -------------- | ------------------------------------------------------- | -------------------------------------------------------- | | pmm-team | Product Marketing (GTM, positioning, competitive intel) | Archived - functionality may be restored based on demand | | finance-team | Financial planning and analysis | Archived - under evaluation | | ops-team | Operations management | Archived - under evaluation |

To restore an archived plugin, move its folder from .archive/ to the root directory and register it in marketplace.json.

🖥️ Supported Platforms

Ring works across multiple AI development platforms:

| Platform | Format | Status | Features | | --------------- | ----------- | ------------------ | ------------------------------- | | Claude Code | Native | ✅ Source of truth | Skills, agents, commands, hooks | | Factory AI | Transformed | ✅ Supported | Droids, commands, skills | | Cursor | Transformed | ✅ Supported | Skills, agents, commands | | Cline | Transformed | ✅ Supported | Prompts |

Transformation Notes:

Claude Code receives Ring content in its native format
Factory AI: agents → droids terminology
Cursor: Skills → ~/.cursor/skills/, Agents → ~/.cursor/agents/, Commands → ~/.cursor/commands/
Cline: All content → structured prompts

Platform-Specific Guides:

See the installer README for platform-specific setup and transformation details.

🚀 Quick Start

Multi-Platform Installation (Recommended)

The Ring installer automatically detects installed platforms and transforms content appropriately.

Linux/macOS/Git Bash:

# Interactive installer (auto-detects platforms)
curl -fsSL https://raw.githubusercontent.com/lerianstudio/ring/main/install-ring.sh | bash

# Or clone and run locally
git clone https://github.com/lerianstudio/ring.git ~/ring
cd ~/ring
./installer/install-ring.sh

Windows PowerShell:

# Interactive installer (auto-detects platforms)
irm https://raw.githubusercontent.com/lerianstudio/ring/main/install-ring.ps1 | iex

# Or clone and run locally
git clone https://github.com/lerianstudio/ring.git $HOME\ring
cd $HOME\ring
.\installer\install-ring.ps1

Direct Platform Installation

Install to specific platforms without the interactive menu:

# Install to Claude Code only (native format)
./installer/install-ring.sh install --platforms claude

# Install to Factory AI only (droids format)
./installer/install-ring.sh install --platforms factory

# Install to multiple platforms
./installer/install-ring.sh install --platforms claude,cursor,cline

# Install to all detected platforms
./installer/install-ring.sh install --platforms auto

# Dry run (preview changes without installing)
./installer/install-ring.sh install --platforms auto --dry-run

Installer Commands

# List installed platforms and versions
./installer/install-ring.sh list

# Update existing installation
./installer/install-ring.sh update

# Check for available updates
./installer/install-ring.sh check

# Sync (update only changed files)
./installer/install-ring.sh sync

# Uninstall from specific platform
./installer/install-ring.sh uninstall --platforms cursor

# Detect available platforms
./installer/install-ring.sh detect

Claude Code Plugin Marketplace

For Claude Code users, you can also install from the marketplace:

Open Claude Code
Go to Settings → Plugins
Search for "ring"
Click Install

Manual Installation (Claude Code only)

# Clone the marketplace repository
git clone https://github.com/

Ring

Install / Use

README