LerianStudio/ring

Adopt The Huma OpenAPI Wrapper wires a Go service to the shared Huma OpenAPI 3.1 and RFC 9457 problem packages. Use it when migrating or standardizing an HTTP API on the lib-commons wrapper and its spec generation and error handling patterns.

Analyzing Options structures multiple viable approaches with trade-offs, effort estimates, and a recommendation. Use it for strategic decisions, architecture choices, or any problem that needs a clear comparison.

Cleaning Comments removes redundant, obvious, and commented-out code comments while preserving intent, warnings, and documentation. Use it during code review or post-refactor cleanup, including git-scoped changes.

Code Review dispatches default reviewer subagents in parallel, plus conditional specialists when the diff touches observability, systemplane, or streaming. Use it as Gate 8 before merge to aggregate findings by severity without changing files.

Code Search helps locate specific functions, patterns, bugs, or vulnerabilities in a codebase. Use it for targeted investigation, dependency tracing, and concise analysis with optional Chain of Draft mode.

Codebase Explorer scans a codebase in phases to identify architecture, components, layers, and organization, then summarizes findings with file:line evidence. Use it to understand unfamiliar systems before planning changes.

Dispatching Workflows executes a phased plan as reviewed multi-agent workflows, with TDD, mandatory in-harness review, and contrarian verification before each phase returns. Use it when each wave should be validated inside the harness rather than by a lone subagent.

Engineering Prompts creates and optimizes prompts for LLMs and AI systems. Use it when you need a new prompt, better prompt structure, or a fit-for-purpose prompting technique.

Executing Plans loads a plan, checks it critically, and runs tasks in autonomous or batch mode with code review checkpoints. Use it when implementation needs pauses for human feedback between batches.

Git Worktrees Setup creates an isolated git worktree for feature work. It selects a workspace location, checks .gitignore safety, installs dependencies, runs a baseline test, and reports readiness.

Lint Fixing Ring runs the linter, groups independent errors, and dispatches parallel fixer agents until the codebase is clean. Use it for multi-file lint failures, not for a single error or view-only lint output.

Multi-Tenant Development Cycle orchestrates Go service changes to add database-per-tenant isolation with dispatch-layer middleware, repositories, metrics, and tests. Use it when adding tenant isolation to an existing Go service.

Opening Pull Requests opens a GitHub pull request with base-branch detection, scope validation, template filling, and post-create base verification. Use it after pushing a branch when you are ready to open a PR.

PR Description Generator creates pull request titles and descriptions from branch-specific git changes. Use it when preparing a PR for review, and skip it for trivial single-commit changes or when a description already exists.

Production Readiness Audit evaluates a service against Ring engineering standards across structure, security, operations, quality, and infrastructure. Use it before production deploys, during periodic reviews, onboarding, or major releases.

Release Guide generates an internal Ops-facing update or migration guide from the diff between two refs. It documents client impact, deploy order, monitoring, and rollback notes in English, pt-br, or both, and previews before saving.

Ring Committing Changes analyzes a dirty working tree, checks the repo's commit scope policy, groups edits into atomic commits, and drafts signed Conventional Commit messages. Use it when changes are ready to record and need to pass PR validation.

Ring Orchestrator enforces the Ring conversation protocol by checking for applicable skills, dispatching agents, and avoiding direct tool use. Use it at the start of a task or whenever a request calls for exploration, refactoring, or file work.

Ring Shipping Changes orchestrates a full git workflow from branch creation through commit, push, and pull request. Use it when you're ready to ship one complete unit of work and want the plan shown before any mutating command.

Ring Visualizing generates self-contained Lerian-branded HTML artifacts for diagrams, comparison tables, slide decks, and review views, then opens them in the browser. Use it for architecture overviews, large tables, visual diffs, plans, recaps, and dashboards.

Session Handoff creates a plan-mode handoff document with completed work, decisions, open items, and next steps. Use it when ending a session, transferring work, or resuming later with a fresh context.

Test-Driven Development enforces the red-green-refactor loop for new features, bugfixes, and new production code. Write a failing test first, then minimal code to pass, and refactor only after green.

Testing Skills With Subagents hardens discipline-enforcing skills by running RED-GREEN-REFACTOR scenarios on a subagent without the skill, then tightening the wording until the agent follows it under pressure. Use it when a skill could be rationalized away.

Writing Plans turns a spec into a rolling-wave implementation plan for multi-file features. Use it before coding when you need phase-by-phase decomposition, with only Phase 1 detailed up front.

Writing Skills defines how to create or revise a Ring skill with correct SKILL.md structure, ASO rules, token-efficiency targets, and rationalization-resistant safeguards. Use it when writing skills that need to withstand pressure and excuses.