How does it handle error management?

It enforces 'Fail-Fast' principles, prohibiting silent fallbacks or error masking. It requires that failures be made explicit with full context to ensure system reliability and easier debugging.

What is the mandatory 3-stage impact analysis?

Before implementation, the skill requires documentation of Discovery (identifying affected code), Understanding (analyzing dependencies), and Identification (producing a structured impact report).

What is the 'Rule of Three' used by this skill?

It follows Martin Fowler's refactoring principle: keep code inline for the first two occurrences and only implement commonalization/abstraction on the third occurrence to avoid premature optimization.

When does the AI Development Guide skill activate?

The skill is automatically triggered when Claude detects technical decisions being made, or when keywords like 'code smell', 'technical debt', or 'quality check' are used in the prompt.

Is this skill restricted to specific programming languages?

No, the guide provides language-agnostic engineering principles and quality workflows that are applicable to any software development environment.

AI Development Guide & Quality Guardrails

Name: AI Development Guide & Quality Guardrails
Author: tundraray

bytundraray

•

開発者ツール

Enforces production-ready engineering standards through anti-pattern detection, systematic quality checks, and technical decision frameworks.

The AI Development Guide skill transforms Claude into a senior technical architect by providing a rigorous framework for decision-making and quality assurance. It automates the detection of common code smells, enforces the 'Rule of Three' for refactoring, and mandates a three-stage impact analysis before any code modification. By integrating fail-fast principles and a multi-phase quality gate—from static analysis to build verification—it ensures that every contribution minimizes technical debt and maintains architectural integrity.

主な機能

01Mandatory 3-stage impact analysis (Discovery, Understanding, Identification)

02Standardized 'Rule of Three' logic for managing code duplication

03Structured '5 Whys' root cause analysis and debugging techniques

04Automatic detection of technical anti-patterns and code quality red flags

05Multi-phase quality assurance workflow including static analysis and test gates

061 GitHub stars

ユースケース

01Performing thorough impact assessments before implementing complex feature changes in large codebases.

02Refactoring legacy systems by identifying and eliminating technical debt and anti-patterns.

03Establishing a standardized, language-agnostic quality gate for CI/CD and local development workflows.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tundraray/claude-code-workflows ai-development-guide

For use in Claude.ai and ChatGPT

Download Skill