Does the Discover skill modify my source code?

No, the Discover skill is strictly read-only. It analyzes your files and produces a suggestion report without making any changes or creating new files in your repository.

How does it identify architectural patterns?

It uses a multi-agent approach to scan package manifests, directory structures, and code patterns such as REST controllers, ORM usage, and infrastructure-as-code configurations.

Can I limit the discovery to a specific part of my project?

Yes, you can provide an optional scope argument such as a directory path (e.g., 'src/auth/') or a domain keyword to focus the analysis on a specific subtree or module.

What is the difference between a suggested ADR and a suggested Spec?

Suggested ADRs focus on technology and pattern choices where alternatives existed, while Suggested Specs identify complex subsystem boundaries that warrant formal interface definitions.

Architectural Discovery Agent

Name: Architectural Discovery Agent
Author: joestump

byjoestump

•

학습 및 문서화

Analyzes existing codebases to reverse-engineer implicit architectural decisions and identify subsystems worthy of formal specification.

The Discover skill acts as an automated technical architect that crawls your repository to identify undocumented patterns, technology choices, and structural boundaries. By scanning dependencies, configuration files, and code structures across four specialized analysis categories, it generates a comprehensive report suggesting Architecture Decision Records (ADRs) and OpenSpec specifications. This skill is essential for developers onboarding onto legacy projects, teams looking to bootstrap documentation for rapid prototypes, or leads ensuring architectural consistency across large monorepos.

주요 기능

01Multi-agent parallel scanning using Task tools for comprehensive codebase coverage

02Automated dependency and framework analysis to detect core technology choices

034 GitHub stars

04Pattern recognition for API designs, state management, and data access layers

05Confidence-scored suggestions with ready-to-use commands for documentation generation

06Subsystem boundary detection to identify complex modules needing formal documentation

사용 사례

01Identifying architectural drift and undocumented patterns in rapidly evolving projects

02Bootstrapping documentation and ADRs for an inherited legacy codebase

03Mapping out subsystem boundaries and API surfaces for technical audits or refactoring

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design discover

For use in Claude.ai and ChatGPT

Download Skill