README
💍 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 90 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 90 specialized skills (22 core + 31 dev-team + 15 product planning + 7 FinOps regulatory + 6 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
🧭 Project Identity
Ring is Lerian-first, open-source-friendly. Design decisions prioritize the Lerian engineering team's daily needs while keeping the architecture clean and reusable for external adoption. This means:
- Lerian-specific skills stay active — Brazilian regulatory compliance (finops-team), internal integrations, and domain-specific workflows remain in the marketplace because the team uses them
- The architecture is universal — Skills, agents, and the plugin system work with any codebase or team
- Archival is usage-driven — Skills are archived when they stop being used, not because they're "too specific"
🤖 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 agentring:codebase-explorer- Deep architecture analysis (deep-analysis, complements built-in Explore)- Use
ring:codereviewskill to orchestrate parallel review workflow
Developer Agents (dev-team plugin):
ring:backend-engineer-golang- Go backend specialist for financial systemsring:backend-engineer-typescript- TypeScript/Node.js backend specialist (Express, NestJS, Fastify)ring:devops-engineer- DevOps infrastructure specialistring:frontend-bff-engineer-typescript- BFF & React/Next.js frontend with Clean Architecturering:frontend-designer- Visual design specialistring:frontend-engineer- Senior Frontend Engineer (React/Next.js)ring:prompt-quality-reviewer- Agent Quality Analystring:qa-analyst- Quality assurance specialistring: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)