architecture-refiner

Define repository architecture principles and generate a formal architecture document.

176|13|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/techygarg/lattice --skill architecture-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-refiner
Source: https://github.com/techygarg/lattice/tree/main/plugins/lattice/skills/architecture-refiner
Command: npx skills add https://github.com/techygarg/lattice --skill architecture-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Facilitates a structured conversation to define architecture principles for a repository. Supports multiple architecture styles (clean architecture by default, hexagonal / ports & adapters, modular monolith, or custom). Produces a formal architecture document that the corresponding atom will use. Use when setting up a new project, defining architecture standards, or when the user says "setup architecture", "define layers", "architecture principles", "help me define my architecture", "hexagonal architecture", "modular monolith", "ports and adapters", or "define my architecture style".

Core Features & Use Cases

  • Structured interview to elicit organization-wide architecture decisions.
  • Generates a formal .lattice/standards/architecture.md document compatible with the architecture atom.
  • Supports multiple architecture styles and corresponding templates for quick-start standards.

Quick Start

Tell me your chosen architecture style and project context, and I will generate a ready-to-use architecture document.

Frequently Asked Questions about architecture-refiner

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

FAQPage Schema
How do I define architecture principles for a new repository?

Defining architecture principles requires a structured interview where you provide project context and a chosen style to produce a formal standards document. The Skill supports clean architecture, hexagonal, modular monolith, or custom styles and outputs the result to .lattice/standards/architecture.md.

What is the best way to set up hexagonal architecture or ports and adapters for my project?

Setting up hexagonal architecture involves specifying the ports and adapters style to generate formal documentation with style-specific guidance. You provide YAML frontmatter containing your project name and description to produce a ready-to-use architecture principles document.

Can I use a custom architecture style instead of clean architecture or modular monolith?

Yes, you can define a custom architecture style by specifying it in your input. The Skill generates a formal architecture document with architecture_mode set to custom, providing tailored guidance for your non-default design principles and repository standards.

What input format do I need to generate an architecture document?

The input requires a YAML frontmatter containing your project name and description, along with optional resource folders for scripts, references, and assets. This input drives the structured interview to produce your formal architecture document.

When should I not use a guided architecture refinement process?

You should skip guided architecture refinement if your repository already has a formal architecture document with established design principles. The process is intended for setting up new projects, defining standards, or transitioning to styles like hexagonal or modular monolith.