ai-development-guide
Applies language-agnostic and backend technical decision criteria, anti-pattern detection, debugging, and quality gates. Use when reviewing general/backend implementation choices, code smells, failures, or implementation completeness.
npx skills add shinpr/claude-code-workflows --skill ai-development-guide --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# AI Developer Guide - Technical Decision Criteria and Anti-pattern Collection ## Value-First Engineering Explore broadly, then converge on the lowest-lifecycle-cost solution that delivers the required user, operator, or maintainer value while keeping the system correct and maintainable. - Resolve verified problems within confirmed scope or dependencies required for the outcome; report other findings with evidence for a scope decision. - Introduce capabilities, infrastructure, abstractions, or speculative edge-case handling when a current outcome, verified constraint, or evidence-backed material risk requires them. ## Technical Anti-patterns (Red Flag Patterns) Pause the affected decision and review the design when detecting the following patterns: ### Code Quality Anti-patterns 1. **Writing similar code 3 or more times** - Violates Rule of Three 2. **Multiple responsibilities mixed in a single file** - Violates Single Responsibility Principle (SRP) 3. **Defining same content in multiple files** - Violates DRY principle 4. **Making changes without checking dependencies** - Potential for unexpected impacts 5. **Disabling code with comments** - Should use version control 6. **Error s
- Value-First Engineering
- Technical Anti-patterns (Red Flag Patterns)
- Code Quality Anti-patterns
- Design Anti-patterns
- Fail-Fast Fallback Design Principles
- Core Principle
- Implementation Guidelines
- Error Masking Detection
- Implementation Pattern
- Rule of Three - Criteria for Code Duplication
- Criteria for Commonalization
- Common Failure Patterns and Avoidance Methods
- Pattern 1: Error Fix Chain
- Pattern 2: Circumventing Correctness Guarantees
What does the ai-development-guide skill do?
Applies language-agnostic and backend technical decision criteria, anti-pattern detection, debugging, and quality gates. Use when reviewing general/backend implementation choices, code smells, failures, or implementation completeness.
How do I install it?
Run `npx skills add shinpr/claude-code-workflows --skill ai-development-guide --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From shinpr/claude-code-workflows, a repository with 664 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.