aif-architecture

Analyze a project's tech stack to generate an ARCHITECTURE.md with folder structure and dependency rules.

56|3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/lee-to/ai-workspace --skill aif-architecture-lee-to
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-architecture
Source: https://github.com/lee-to/ai-workspace/tree/main/.claude/skills/aif-architecture
Command: npx skills add https://github.com/lee-to/ai-workspace --skill aif-architecture-lee-to

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often ad-hoc and inconsistent across a project. This skill analyzes the project's tech stack and constraints to produce a cohesive architecture guideline and a ready-to-use ARCHITECTURE.md.

Core Features & Use Cases

  • Analyze the project's tech stack and DESCRIPTION.md to tailor recommendations.
  • Recommend an architecture pattern (Layered, Modular Monolith, Clean Architecture, DDD, Microservices) and define key module boundaries.
  • Generate .ai-factory/ARCHITECTURE.md with folder structure, dependency rules, and coding guidelines.

Quick Start

Run /aif-architecture to generate architecture guidelines for your current project.

Frequently Asked Questions about aif-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate architecture guidelines for my software project?

To generate architecture guidelines, run the skill to analyze your tech stack and DESCRIPTION.md. It identifies an architecture pattern and produces a .ai-factory/ARCHITECTURE.md with folder structure, dependency rules, and design guidelines.

What architecture pattern should I use for my project's tech stack?

Recommended architecture patterns include Layered, Modular Monolith, Clean Architecture, DDD, and Microservices. The skill analyzes your project's tech stack and constraints to recommend the most suitable pattern and define key module boundaries.

How do I create an ARCHITECTURE.md file with folder structure and dependency rules?

Creating an ARCHITECTURE.md file involves analyzing project context from DESCRIPTION.md to generate a cohesive document. The skill outputs a ready-to-use file containing recommended folder structure, dependency rules, and coding guidelines aligned to your language.

Can I tailor architecture recommendations to specific project requirements?

You can tailor architecture recommendations by providing project context through DESCRIPTION.md and skill-context overrides. The skill leverages these inputs to align the pattern selection, module boundaries, and design guidelines with your specific requirements.

How does analyzing a tech stack improve software design consistency?

Analyzing a tech stack improves software design consistency by replacing ad-hoc decisions with cohesive architecture guidelines. The skill evaluates constraints to produce standardized folder structures and dependency rules across the entire project.

When do I need to define project architecture boundaries and design patterns?

You need to define project architecture boundaries and design patterns when architecture decisions become ad-hoc and inconsistent. The skill assesses your project requirements to establish cohesive module boundaries and generate standardized guidelines.