architecture-reuse-check

What problem does it solve?

Architects often spend significant time designing new components, only to discover later that similar solutions already exist within the codebase. This leads to duplicated effort, inconsistent architecture, and increased maintenance burden. This skill proactively identifies reuse opportunities, saving time and ensuring architectural consistency.

Core Features & Use Cases

• Problem Domain Identification: Automatically analyzes spec drafts to identify the underlying problem domain (e.g., inter-agent communication, configuration management).
• Existing Component Matching: Finds existing components that address similar problem domains and calculates a "fitness score" (0-100%) for reuse.
• Recommendation Engine: Provides clear recommendations (REUSE, EXTEND, ADAPT, NEW) with rationale, benefits, and trade-offs.
• Spec Comparison: Detects similarities with existing technical specifications to prevent duplicate design efforts.
• Use Case: An architect is about to create a spec for a new "Agent Notification System." Before writing, they run this skill, which identifies "Orchestrator Messaging" as a 100% fit, recommending reuse and saving 30 minutes of design work.

Quick Start

# Analyze a spec draft for reuse opportunities
spec_content = """
# SPEC-999: Agent Notification System

We need code_developer to notify architect after commits.
"""
from coffee_maker.skills.architecture import check_architecture_reuse
report = check_architecture_reuse(spec_content, "SPEC-999-notification.md")
print(report)