Overview
Purpose: Audits architectural patterns against best practices, tracks evolution, creates Stories for improvements.
Type: Orchestrator-Worker Pattern (L2 Coordinator + ln-641 L3 Worker)
Output: Updated patterns_catalog.md + Stories via ln-220-story-coordinator
Invocation: Manual or periodic (monthly recommended).
Main Workflow (6 Phases)
graph TD
Start([START]) --> Phase1[Phase 1: Discovery
Load patterns_catalog.md
Load ADRs
Auto-detect undocumented patterns]
Phase1 --> HasPatterns{Patterns
found?}
HasPatterns -->|No| CreateCatalog[Create catalog
from template
Ask user for patterns]
HasPatterns -->|Yes| Phase2
CreateCatalog --> Phase2[Phase 2: Best Practices Research
MCP Ref + Context7
WebSearch 2026
Build contextStore]
Phase2 --> Phase3[Phase 3: Analysis Loop
FOR EACH pattern:
Task → ln-641-pattern-analyzer
Calculate 4 scores]
Phase3 --> Phase4[Phase 4: Gap Analysis
Undocumented patterns
Implementation gaps
Consistency issues]
Phase4 --> HasIssues{Patterns with
score < 70%?}
HasIssues -->|No| Phase6
HasIssues -->|Yes| Phase5
Phase5 --> DetectEpic{Can detect
Epic?}
DetectEpic -->|Yes| CreateStories[Create Stories
via ln-220
in detected Epic]
DetectEpic -->|No| AskEpic[Ask user
for Epic]
AskEpic --> CreateStories
CreateStories --> Phase6[Phase 6: Report
Update catalog
Trend analysis
Health score]
Phase6 --> End([END:
Catalog updated
Stories created])
classDef phase fill:#E3F2FD,stroke:#1976D2,stroke-width:2px
classDef decision fill:#FFF3E0,stroke:#FF9800,stroke-width:2px
classDef action fill:#E8F5E9,stroke:#4CAF50,stroke-width:2px
classDef endpoint fill:#C8E6C9,stroke:#388E3C,stroke-width:2px
class Phase1,Phase2,Phase3,Phase4,Phase6 phase
class HasPatterns,HasIssues,DetectEpic decision
class CreateCatalog,CreateStories,AskEpic action
class Start,End endpoint
Phase 3: Analysis Loop Detail
graph LR
subgraph "FOR EACH pattern"
P1[Load pattern
from catalog] --> P2[Task tool
→ ln-641]
P2 --> P3[ln-641 calculates
4 scores]
P3 --> P4[Return:
scores, issues, gaps]
P4 --> P5[Update catalog
entry]
end
classDef step fill:#E3F2FD,stroke:#1976D2,stroke-width:2px
class P1,P2,P3,P4,P5 step
4-Score Model
graph TD
subgraph "Pattern Scores"
S1[Compliance
Industry standards
ADR documentation] --> Result
S2[Completeness
All components
Error handling] --> Result
S3[Quality
Readability
Maintainability] --> Result
S4[Implementation
Production usage
Monitoring] --> Result
Result{Average
< 70%?}
end
Result -->|Yes| Story[Create Story
via ln-220]
Result -->|No| Pass[Pattern OK
Update trend]
classDef score fill:#E3F2FD,stroke:#1976D2,stroke-width:2px
classDef decision fill:#FFF3E0,stroke:#FF9800,stroke-width:2px
classDef action fill:#E8F5E9,stroke:#4CAF50,stroke-width:2px
class S1,S2,S3,S4 score
class Result decision
class Story,Pass action
Integration with Other Skills
graph LR
ln640[ln-640
Pattern Auditor] --> ln641[ln-641
Pattern Analyzer]
ln640 --> ln220[ln-220
Story Coordinator]
ln220 --> ln400[ln-400
Story Executor]
ln400 --> ln620[ln-620
Codebase Auditor]
ln112[ln-112
Creates initial
patterns_catalog.md] -.-> ln640
classDef main fill:#E3F2FD,stroke:#1976D2,stroke-width:2px
classDef worker fill:#E8F5E9,stroke:#4CAF50,stroke-width:2px
classDef downstream fill:#FFF3E0,stroke:#FF9800,stroke-width:2px
class ln640 main
class ln641,ln112 worker
class ln220,ln400,ln620 downstream