dev-refactor

Analyze codebases against Ring standards and generate refactoring tasks.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665 --skill dev-refactor-withmartian-sandbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-refactor
Source: https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665/tree/main/dev-team/skills/dev-refactor
Command: npx skills add https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665 --skill dev-refactor-withmartian-sandbox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates discovery and remediation planning for codebases that diverge from Ring standards by producing an auditable set of findings and prioritized refactor tasks so teams never skip required checks or miss hidden violations.

Core Features & Use Cases

  • Standards Enforcement: Scans repositories, verifies adherence to Ring/Lerian standards, and treats any divergence as a mandatory finding.
  • Agent-Orchestrated Analysis: Dispatches specialist agents (Go, TypeScript, frontend, QA, DevOps, SRE) to produce standardized reports and a unified findings manifest.
  • Artifacted Workflow: Produces required artifacts (codebase-report.md, per-agent reports, findings.md, tasks.md) and enforces hard gates and verification rules for audits and modernization efforts.
  • Use Case: Ideal for legacy modernization, project audits, and pre-refactor acceptance where traceable findings and gate verification are required before handing off to implementation.

Quick Start

Run the dev-refactor process to analyze the repository, generate findings.md, and produce REFACTOR-XXX tasks ready for the dev-cycle.

Frequently Asked Questions about dev-refactor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate codebase analysis for legacy modernization and standards compliance?

Codebase analysis for legacy modernization automates repository scanning against Ring standards, dispatches specialist agents for Go, TypeScript, and frontend stacks, and generates prioritized refactoring tasks with traceable findings.

What artifacts are generated when auditing a codebase for refactoring?

Auditing a codebase for refactoring generates mandatory artifacts including codebase-report.md, findings.md, and tasks.md, alongside per-agent reports that enforce hard gates and verification rules for modernization efforts.

Can I enforce mandatory gap tracking and standards coverage verification during a project audit?

Yes, you can enforce mandatory gap tracking and standards coverage verification during a project audit by treating any divergence from Ring standards as a mandatory finding and producing an auditable set of prioritized refactor tasks.

Does agent-orchestrated code review support both Go and TypeScript stacks?

Yes, agent-orchestrated code review supports Go and TypeScript stacks by dispatching specialist agents that analyze codebases, verify standards compliance, and produce unified findings manifests for modernization projects.

Why use a standards enforcement workflow for pre-refactor acceptance?

A standards enforcement workflow for pre-refactor acceptance ensures teams never skip required checks or miss hidden violations by producing an auditable set of findings and prioritized refactor tasks before handing off to implementation.

What is the best way to track findings and remediation tasks for codebase audits?

The best way to track findings and remediation tasks for codebase audits is to generate standardized reports and a unified findings manifest, producing REFACTOR-XXX tasks ready for the dev-cycle to ensure traceable gap tracking.