Ring

Native plugin install (per harness)

Each Ring plugin ships native manifests for Claude Code, Codex, Cursor, and OpenCode. The harness installs the plugin directly from this repo via its own package manager — no transformation step, no local installer.

ring-default is the foundation plugin — install it alongside any other Ring plugin since it provides the using-ring bootstrap that orients agent behavior. Example for OpenCode:

{
  "plugin": [
    "ring-default@git+https://github.com/lerianstudio/ring.git#main",
    "ring-dev-team@git+https://github.com/lerianstudio/ring.git#main"
  ]
}

Each harness's INSTALL.md (for OpenCode) or plugin.json (for Codex/Cursor) carries the exact install command for that platform.

Symlink installer (local dev)

ring-install.sh symlinks your harness's local config dir into this cloned Ring repo. For Codex and OpenCode, it first builds a transformed tree at .ring-build/ (namespace + frontmatter rewrites required by those tools).

Supported targets: Claude Code, Factory AI, OpenCode, Codex. Not supported by the installer: Cursor (use the native plugin install above).

```bash

Manual Installation (Claude Code only)

```bash

Building a Feature

User: "Add user authentication to the app"
Claude: I'm using ring:planning-small-features to scope this feature...
        [Pre-dev workflow: PRD, TRD, plan]
Claude: I'm using ring:test-driven-development to implement...
        [RED-GREEN-REFACTOR cycle for each component]
Claude: I'm using ring:reviewing-code to validate...
        [9 defaults + conditional specialist parallel dispatch]

🚀 Quick Start

💡 Usage Examples

No additional configuration needed for Claude Code

```

📦 Archived Plugins

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

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

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

Code Analysis Pipeline

The ring:reviewing-code pipeline uses Mithril, an external code analysis tool installed via go install. Mithril performs static analysis, AST extraction, call graph generation, and context compilation for AI-assisted code review.

Install via go install github.com/lerianstudio/mithril@latest. See the Mithril repository for full installation details and release notes.

📚 All 67 Skills (Across 4 Plugins)

Core Skills (ring-default plugin - 16 skills)

Testing & Quality (2):

• ring:test-driven-development - Write test first, watch fail, minimal code
• ring:fixing-lint - Parallel lint fixing with agent dispatch

Collaboration & Planning (5):

• ring:reviewing-code - Parallel 9 defaults + conditional specialist dispatch with severity-based handling
• ring:creating-worktrees - Isolated development
• ring:committing-changes - Smart commit organization with atomic grouping, conventional commits, and trailers
• ring:writing-plans - Author phased implementation plans (phase → epic → task) from a spec; first phase detailed into dispatch-ready tasks, later phases epic-level for rolling-wave elaboration
• ring:executing-plans - Rolling-wave execution of a phased plan: implement the detailed phase, checkpoint with the user, elaborate the next phase against the real codebase, repeat

Meta Skills (3):

• ring:using-ring - Mandatory skill discovery
• ring:writing-skills - TDD for documentation
• ring:testing-skills-with-subagents - Skill validation

Integration (1):

• ring:delegating-to-gandalf - Send tasks to Gandalf (AI team member) via webhook for Slack, Google Workspace, and Jira interactions

Session & Learning (4):

• ring:exploring-codebases - Two-phase codebase exploration
• ring:generating-release-guides - Generate Ops Update Guide from git diff analysis
• ring:visualizing - Generate self-contained HTML pages to visually explain systems, code changes, and data
• ring:creating-handoffs - Create handoff documents capturing session state for seamless context-clear and resume

Audit & Readiness (1):

• ring:auditing-production-readiness - 44-dimension production readiness audit; runs explorers in batches of up to 10, appends incrementally to a single report; output: scored report (0-430, max 440 with multi-tenant) with severity ratings. See default/skills/auditing-production-readiness/SKILL.md for invocation and implementation details.

Developer Skills (ring-dev-team plugin - 33 skills)

Orchestration & Refactoring (7):

• ring:using-dev-team - Introduction to developer specialist agents
• ring:running-dev-cycle - Lean backend development cycle orchestrator driven by a rolling-wave phased plan (phases → epics Epic N.M → tasks Task N.M.T): Gate 0 implementation-owned TDD/coverage/docker-compose/runtime/delivery verification per task, Gate 8 review + Gate 9 validation per epic, phase boundary (Step 11.5) closes each phase and elaborates the next against the real codebase
• ring:running-dev-cycle-frontend - Lean frontend development cycle orchestrator on the same rolling-wave phased plan (Gate 0 per task, Gate 7 review per epic, Gate 8 validation per task, phase boundary per phase)
• ring:planning-backend-refactor - Backend/codebase standards analysis
• ring:planning-frontend-refactor - Frontend standards analysis and task generation
• ring:planning-codebase-simplification - Whole-codebase structural simplification sweep (hunts unjustified abstractions, adapters, shims; KILL/REVIEW/KEEP output; DELETE-by-default burden of proof for pre-public applications)
• ring:managing-dev-cycle - Development cycle state management (phase/epic status reporting and cancellation)

Backend Gate Skills:

• ring:implementing-tasks - Gate 0: TDD implementation
• ring:adding-multi-tenancy - Multi-tenant adaptation (database-per-tenant isolation, integrated into Gate 0)
• ring:hardening-dockerfiles - Docker image security audit for Docker Hub Health Score grade A
• ring:creating-helm-charts - Helm chart creation and maintenance following Lerian conventions
• ring:mapping-service-resources - Service/module/resource hierarchy scanner for dispatch layer
• ring:implementing-readyz - Comprehensive readiness probes (/readyz) with per-dependency status and TLS validation
• ring:instrumenting-streaming-events - Wire lib-streaming event emission from a validated instrumentation map

Testing & Validation:

• ring:detecting-goroutine-leaks - Goroutine leak detection and regression testing
• ring:load-testing-with-k6 - k6 load test generation following Lerian platform conventions
• ring:validating-acceptance-criteria - Gate 9: User approval
• ring:writing-dev-reports - Assertiveness scoring and metrics
• ring:verifying-code - Atomic Go code verification with MERGE_READY/NEEDS_FIX verdict

Migration & Reference (6):

• ring:using-lib-commons - Comprehensive reference for lib-commons v5.0.2 (Lerian's shared Go library with 30+ packages)
• ring:using-runtime - Deep reference and 6-angle audit for lib-observability/runtime: SafeGo, panic recovery, observability trident, policy selection, framework integration. Catches naked goroutine launches that cause silent production failures.
• ring:using-assert - Deep reference and 6-angle audit for lib-observability/assert: production runtime assertions with observability trident, full domain predicate catalog (double-entry, transaction state machine, financial validations), AssertionError unwrapping patterns. Converts financial invariants into production-enforced rules.
• ring:migrating-to-lib-systemplane - Migrate Lerian Go services from .env/YAML config to systemplane (database-backed hot-reloadable config)
• ring:generating-llms-txt - Generate or audit llms.txt files following llmstxt.org spec for AI-friendly repository entry points
• ring:applying-licenses - Repository license management (Apache 2.0, Elastic v2, Proprietary)

Security (1):

• ring:auditing-dependency-security - Supply-chain gate for dependency installations (validates identity, vulnerabilities, suspicious signals)

Frontend Quality Skills (1):

• ring:checking-frontend-quality - Frontend quality checks in modes accessibility (axe-core/WCAG), visual (snapshots/viewports), e2e (Playwright 3-browser), performance (Lighthouse/Core Web Vitals), or all; dispatches ring:qa-frontend

Frontend and backend dev-cycle workflows both use ring:reviewing-code (core plugin) as the review gate.

Product Planning Skills (ring-pm-team plugin - 14 skills)

Pre-Development Workflow (includes ring:using-pm-team + 7 gate skills; Large track gate numbers shown):

• ring:using-pm-team - Introduction to product planning workflow

1. ring:researching-features - Deep technical/product research (parallel agents)
2. ring:writing-prds - Squad-facing product requirements (WHAT/WHY)
3. ring:mapping-feature-relationships - Feature relationships and phasing (Large only)
4. ring:writing-trds - Technical architecture (HOW)
5. ring:designing-api-contracts - OpenAPI 3.1 contract (openapi.yaml)
6. ring:designing-data-model - Stack-native schema (schema.sql / schema.prisma)
7. ring:pinning-dependency-versions - Technology selection
8. ring:writing-plans (ring-default) - Single execution plan (plan.md), invoked by the orchestrator

Workflow Orchestrators:

• ring:planning-small-features - 4-gate orchestrator for small features (<2 days)
• ring:planning-large-features - 8-gate orchestrator for large features (>=2 days)

Additional Planning Skills:

• ring:validating-ux-completeness - Standalone UX validation for UI features (run before the TRD)
• ring:reconciling-predev-docs - Deep cross-reference review of pre-dev documentation artifacts
• ring:mapping-streaming-events - Standalone streaming-event discovery (event catalog + instrumentation map)
• ring:creating-grafana-dashboards - Grafana dashboard generation for instrumented services

Technical Writing Skills (ring-tw-team plugin - 4 skills)

Documentation Creation:

• ring:using-tw-team - Introduction to technical writing specialists
• ring:structuring-documentation - Document hierarchy and organization
• ring:applying-voice-and-tone - Voice and tone guidelines (assertive, encouraging, human)
• ring:reviewing-docs - Quality checklist and review process