aif-architecture

Analyze a project's tech stack from DESCRIPTION.md and generate ARCHITECTURE.md.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/mind-systems/mind_context --skill aif-architecture-mind-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-architecture
Source: https://github.com/mind-systems/mind_context/tree/main/.claude/skills/aif-architecture
Command: npx skills add https://github.com/mind-systems/mind_context --skill aif-architecture-mind-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate architecture guidelines for the project. Analyzes tech stack from DESCRIPTION.md, recommends an architecture pattern, and creates .ai-factory/ARCHITECTURE.md. Use when setting up project architecture, asking "which architecture", or after /aif setup.

Core Features & Use Cases

  • Analyze the project's tech stack from DESCRIPTION.md to tailor architecture decisions.
  • Recommend an architecture pattern (e.g., Clean Architecture, DDD, Modular Monolith, Layered) and produce actionable guidelines.
  • Create .ai-factory/ARCHITECTURE.md with a structured decision document for setup, refactors, and onboarding.

Quick Start

Describe your project context or provide a DESCRIPTION.md to generate tailored architecture guidelines.

Frequently Asked Questions about aif-architecture

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

FAQPage Schema
How do I auto-generate architecture guidelines for a new software project?

To generate architecture guidelines, provide your project's tech stack in a DESCRIPTION.md file. The skill analyzes the stack to recommend an architecture pattern and creates an ARCHITECTURE.md document with actionable setup rules.

What is the best way to choose an architecture pattern during project setup?

Choosing an architecture pattern is handled by analyzing your tech stack from DESCRIPTION.md. The system evaluates the stack and recommends a suitable pattern like Clean Architecture, DDD, Modular Monolith, or Layered, then documents the design decisions.

Can I use this to document design decisions for a major project refactor?

Yes, you can use this to document design decisions for a major project refactor. It applies during major refactors by evaluating your current tech stack and generating a structured ARCHITECTURE.md file with clear rules for dependencies and module communication.

What do I need to provide to generate a structured architecture document?

You need to provide a DESCRIPTION.md file containing your project context and tech stack. The system uses this input to produce a tailored .ai-factory/ARCHITECTURE.md file containing the recommended pattern and key architectural principles.

How does the system structure module communication and dependency rules?

The system structures module communication and dependency rules by applying a practical decision flow based on your tech stack. It outputs clear guidelines within the generated ARCHITECTURE.md document to enforce structured dependencies and key principles.

When should I avoid automating architecture decisioning for my software project?

You should avoid automating architecture decisioning if your project lacks a defined tech stack in DESCRIPTION.md. Without this input, the system cannot accurately analyze the stack or recommend a suitable architecture pattern and dependency rules.