project-health-check

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 66 specialized skills (25 core + 9 dev-team + 10 product planning + 7 FinOps regulatory + 7 technical writing + 8 PMO)
• 30 specialized agents - 7 review/planning + 9 developer + 3 product research + 3 FinOps regulatory + 3 technical writing + 5 PMO
• Automating skill discovery - Skills load automatically at session start
• Preventing common failures - Built-in anti-patterns and mandatory checklists

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:write-plan - Implementation planning agent
• ring:codebase-explorer - Deep architecture analysis (Opus-powered, 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
• frontend-bff-engineer-typescript - BFF & React/Next.js frontend with Clean Architecture
• ring:frontend-designer - Visual design specialist
• ring:qa-analyst - Quality assurance specialist
• ring:sre - Site reliability engineer
• ring:frontend-engineer - Senior Frontend Engineer (React/Next.js)
• prompt-quality-reviewer - Agent Quality Analyst

> 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

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

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

FinOps Agents (ring-finops-team plugin):

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

PMO Agents (ring-pmo-team plugin):

• portfolio-manager - Portfolio-level planning and multi-project coordination
• resource-planner - Capacity planning and resource allocation optimization
• risk-analyst - Portfolio risk identification and mitigation planning
• governance-specialist - Gate reviews and process compliance
• executive-reporter - Executive dashboards and stakeholder communications

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

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 | Rules, workflows |

| Cline | Transformed | ✅ Supported | Prompts |

Transformation Notes:

• Claude Code receives Ring content in its native format
• Factory AI: agents → droids terminology
• Cursor: Skills/agents → .cursorrules and workflows
• Cline: All content → structured prompts

Platform-Specific Guides:

• [Claude Code Installation Guide](docs/platforms/claude-code.md) - Native format setup and usage
• [Factory AI Installation Guide](docs/platforms/factory-ai.md) - Droids transformation and configuration
• [Cursor Installation Guide](docs/platforms/cursor.md) - Rules and workflow setup
• [Cline Installation Guide](docs/platforms/cline.md) - Prompt-based configuration
• [Migration Guide](docs/platforms/MIGRATION.md) - Moving between platforms or upgrading

Multi-Platform Installation (Recommended)

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

Linux/macOS/Git Bash:

```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:

```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:

```bash

# 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

```bash

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

```bash

# Clone the marketplace repository

git clone https://github.com/lerianstudio/ring.git ~/ring

# Skills auto-load at session start via hooks

# No additional configuration needed f