Poo Audit

POO Audit — Codebase Duplication Scanner

Scan the entire codebase for violations of DRY/SOLID principles and report consolidation opportunities.

Workflow

Phase 1: Map the Codebase

1. Find all component files:
   Glob: **/*.tsx, **/*.jsx, **/*.vue, **/*.svelte

2. Find all utility/hook files:
   Glob: **/utils/**/*.ts, **/hooks/**/*.ts, **/lib/**/*.ts, **/helpers/**/*.ts

3. Find all service/API files:
   Glob: **/services/**/*.ts, **/api/**/*.ts

4. Count totals for baseline

Phase 2: Detect Duplicates

For each category, run detection:

A. Component Name Similarity

1. List all exported component names (Grep: "export.*function|export.*const.*=.*=>|export default")
2. Group by similar names (e.g., DownloadButton, DownloadBtn, ButtonDownload)
3. Flag groups with 2+ similar names

B. Function Signature Similarity

1. List all exported functions
2. Compare parameter patterns
3. Flag functions with same params doing similar things

C. Content Similarity

For each flagged pair:
1. Read both files
2. Compare:
   - Import overlap (same libraries?)
   - JSX structure overlap (same elements?)
   - Logic overlap (same operations?)
3. Score: 0-100% similarity

D. Import Pattern Analysis

1. Find most-imported internal modules (Grep: "from.*@/|from.*\.\./")
2. Find files that import the same external libs
3. Files importing same things likely do same things

Phase 3: Report

Generate a structured report:

# POO Audit Report

## Summary
- Files scanned: N
- Duplicates found: N
- Consolidation opportunities: N
- Estimated lines saveable: N

## Critical (exact/near duplicates)
| Files | Similarity | Recommendation |
|-------|-----------|----------------|
| `PageA/Download.tsx` vs `PageB/Download.tsx` | 87% | Merge into `components/shared/Download.tsx` |

## Warning (similar functionality)
| Files | Overlap | Recommendation |
|-------|---------|----------------|
| `utils/format.ts` vs `helpers/date.ts` | 45% | Extract shared date utils |

## Info (potential abstractions)
| Pattern | Count | Recommendation |
|---------|-------|----------------|
| Inline fetch calls | 12 | Extract to service layer |
| Repeated useState+useEffect | 8 | Extract custom hook |

## Action Plan
1. [Highest impact consolidation first]
2. [...]

Phase 4: Offer Fix

After showing the report, ask: > "Quer que eu corrija os duplicados? Posso rodar /poo fix para consolidar automaticamente."

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: keysjoao
• Source: keysjoao/poo-skills
• License: MIT

Install and usage instructions live in the source repository linked above.