agentleFS
kwiggenkwiggen/claude-code-plugin/skills/antipattern-detector/SKILL.md

antipattern-detector

Skill1 starsChanged 4 months agoMITView on GitHub

Detects common failure patterns in proposals, architectures, plans, and decisions. Use when reviewing any plan to identify red flags before they become problems. Covers architecture, timeline, team, process, and technology anti-patterns. Works on any domain — not just code.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Look for phrases that indicate anti-patterns:

    line 72
  2. Very specific:

    Use antipattern-detector for recognizing known failure patterns (architecture, timeline, team, process, technology).

    line 121
  3. Distinctive:

    Before presenting an analysis, verify:

    line 125

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Anti-Pattern Detector

Identifies recurring failure patterns in plans and decisions. Anti-patterns look reasonable on the surface but lead to predictable problems. Detecting them early saves months of pain.

Anti-Pattern Categories

1. Architecture Anti-Patterns

PatternDescriptionSymptoms
Big Ball of MudNo clear structure, everything coupledCan't change X without breaking Y
Golden HammerUsing one approach for everything"We'll use [tool] for that too"
Premature MicroservicesSplitting before understanding boundaries3 people managing 20 services
Distributed MonolithMicroservices with tight couplingMust deploy all services together
Resume-Driven DevelopmentChoices for career, not product"Let's use Rust for the admin panel"

2. Timeline Anti-Patterns

PatternDescriptionSymptoms
Timeline FantasyOptimistic estimates ignoring reality"6 weeks if everything goes well"
Scope Creep BlindnessNot accounting for inevitable growthSame deadline, 2x scope
Parallel Path DelusionAssuming unlimited parallelization"Add more people to go faster"
MVP MaximalismMVP that's actually V347 features in "minimum" product
Demo-Driven DevelopmentBuilding for demos, not production"It works on my machine"

3. Team Anti-Patterns

PatternDescriptionSymptoms
Hero CultureReliance on key individuals"Only Sarah can fix that"
Knowledge SilosCritical info in one person's headBus factor of 1
Conway's Law ViolationStructure doesn't match teamBoundaries don't align
Understaffed AmbitionBig plans with tiny teams2 people building "the platform"
Absent OwnershipNo clear owner for componentsIssues fall through cracks

4. Process Anti-Patterns

PatternDescriptionSymptoms
Cargo Cult AgileCeremonies without principlesStandups but no shipping
Analysis ParalysisOver-planning, under-executingMonth 3 of "finalizing requirements"
Infinite RefactoringNever shipping, always improving"One more cleanup before release"
Documentation TheaterDocs that no one reads200-page spec, outdated day 1
Meeting MadnessMore meetings than doing"Let's schedule a meeting"

5. Technology Anti-Patterns

PatternDescriptionSymptoms
Shiny Object SyndromeChasing latest tech without reason"Rewrite in [new hotness]"
Not Invented HereBuilding what should be boughtCustom auth, custom logging, custom everything
Vendor Lock-in DenialIgnoring exit costs"We can always migrate later"
Premature OptimizationOptimizing before measuringCaching layer with 10 users
Framework OverloadToo many frameworks/libraries47 dependencies for a button

Detection Process

Step 1: Scan for Signals

Look for phrases that indicate anti-patterns:

Timeline signals: "If everything goes well...", "We can do it faster if...", "Just need to hire...", "Should only take..."

Architecture signals: "We'll figure out boundaries later...", "Everything talks to everything...", "It's only temporary...", "We can always refactor..."

Team signals: "Only [person] knows...", "We'll hire for that...", "[Person] will handle all of...", "The team can absorb..."

Process signals: "We don't need docs...", "We'll add tests later...", "Let's discuss in the meeting...", "Requirements are evolving..."

Step 2: Verify Pattern Match

For each suspected anti-pattern:

  1. Identify: Which specific pattern?
  2. Evidence: What in the plan matches?
  3. Severity: How bad? (Critical / High / Medium / Low)
  4. Context: Could this be a reasonable exception?

Step 3: Check for Combinations

Certain patterns appear together and compound risk:

Startup Death Spiral: Timeline Fantasy + Understaffed Ambition + Hero Culture

  • Result: Burnout, missed deadlines, key person leaves

Enterprise Trap: Analysis Paralysis + Documentation Theater + Meeting Madness

  • Result: Nothing ships, team frustrated, competition wins

Tech Debt Avalanche: "Refactor later" + No ownership + Premature optimization

  • Result: System unmaintainable, rewrite required

Microservices Mistake: Premature Microservices + Distributed Monolith + Understaffed

  • Result: Complexity explosion, slower than monolith

Severity Framework

LevelMeaningAction
CriticalWill cause failure if not addressedStop and fix before proceeding
HighWill cause significant problemsAddress in planning phase
MediumWill cause friction and delaysInclude in risk mitigation
LowWorth noting but manageableTrack and address opportunistically

When to Use This Skill

Use antipattern-detector for recognizing known failure patterns (architecture, timeline, team, process, technology). Use assumption-challenger for surfacing hidden assumptions treated as facts. Both run together in /validate.

Pre-Delivery Checklist

Before presenting an analysis, verify:

  • Every detected pattern includes a direct evidence quote from the plan
  • Every pattern has a severity rating (Critical/High/Medium/Low)
  • Pattern combinations are checked and reported
  • "Patterns NOT Detected" section is included for confidence
  • Fixes are specific and actionable, not generic advice

Output Format

# Anti-Pattern Analysis: [Plan Name]

## Summary
- **Patterns Detected**: [Count]
- **Critical**: [Count] | **High**: [Count] | **Medium**: [Count] | **Low**: [Count]
- **Overall Risk Level**: Critical / High / Medium / Low
- **Pattern Combinations Found**: [List any compound patterns]

## Critical Issues (Must Address)

### [Pattern Name]
**Category**: [Category] | **Severity**: Critical
**Evidence**: [What triggered detection]
**Risk**: [What will go wrong]
**Fix**: [How to address]

---

## High-Priority Issues (Should Address)
[Same format]

## Medium-Priority Issues (Consider Addressing)
[Same format]

## Patterns NOT Detected
[List patterns checked but not found — builds confidence]

## Recommendations
### Before Proceeding
1. [Critical action]
### During Execution
1. [Mitigation]
### Warning Signs to Monitor
- [Metric or signal to watch]

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.