Can the architect skill make decisions without user input?

Yes, it includes an automatic mode that analyzes existing code patterns and architectural constraints to recommend and document the best path forward.

Does this skill provide visual documentation?

Yes, it generates ASCII-based flow diagrams to help developers visualize the proposed component interactions and data flow.

What architectural patterns does this skill support?

The skill evaluates three specific approaches: Minimal Changes for low impact, Clean Architecture for high testability, and Pragmatic Balance for a mix of speed and quality.

Where are the architectural decisions stored?

Decisions are saved to a .dev-workflow-state.json file, which tracks the chosen approach, impacted files, and the implementation build sequence.

Architectural Design & Strategy

Name: Architectural Design & Strategy
Author: atournayre

byatournayre

0•

Productivity & Workflow

Evaluates and selects the optimal architectural approach for new features based on codebase patterns and project constraints.

The Architect Design skill is a specialized tool for Claude Code that handles the critical transition from problem discovery to implementation planning. It automatically generates and compares three distinct architectural strategies—Minimal Changes, Clean Architecture, and Pragmatic Balance—allowing developers to weigh technical debt against long-term maintainability. By analyzing existing repository patterns and 'Elegant Objects' principles, it provides a documented rationale for technical decisions, ensuring that every new feature aligns with the project's structural requirements.

Key Features

01ASCII flow diagram generation for visual architecture

020 GitHub stars

03Workflow state persistence for seamless implementation planning

04Automated recommendation engine based on codebase constraints

05Three-tier strategy evaluation (Minimalist, Clean, or Pragmatic)

06Detailed impact mapping for files and components

Use Cases

01Documenting technical debt and architectural choices for future audits

02Standardizing design patterns across a distributed development team

03Choosing between quick feature extension and deep architectural refactoring

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add atournayre/claude-personas design

For use in Claude.ai and ChatGPT