arch

# Architecture Skill

## Purpose

Discover, validate, and guide project architecture. Ensures code follows layer boundaries and helps plan where new code should go.

## Quick Reference

- **Validates:** Layer boundaries, import directions, architectural compliance
- **Modes:** configure, learn, check, plan

## Modes Overview

| Mode | Command | Purpose |
|------|---------|---------|
| **configure** | `/arch configure` | Auto-discover from docs/configs (setup) |
| **learn** | `/arch learn` | Infer from code analysis or description |
| **check** | `/arch check` | Validate layer boundaries |
| **plan** | `/arch plan <desc>` | Suggest where new code belongs |

---

### Configure Mode: `/arch configure` (Setup)

Auto-discovers your project's architecture based on the selected style.

**Run during plugin installation or manually:**
```bash
/arch configure
```

**Discovery Flow:**

1. **User selects architecture style:**
   - hexagonal, layered, clean, mvc, custom

2. **Skill searches for architecture documentation:**
   - CLAUDE.md (Architecture section)
   - README.md (Project Structure section)
   - docs/architecture.md
   - docs/ADR/*.md (Architecture Decision Records)

3. **Skill checks config files:**
   - tsconfig.json (path aliases → layers)
   - .eslintrc (import restriction rules)
   - .dependency-cruiser.js
   - package.json (workspaces)

4. **Skill scans directory structure:**
   - src/, lib/, app/, packages/
   - Matches directories to style template

5. **Presents discovered config for confirmation:**

```
## Discovered Architecture

**Style:** hexagonal
**Source Root:** src/
**Confidence:** High (documented in CLAUDE.md)

### Layers (lowest → highest)

| Level | Name | Path | Responsibility |
|-------|------|------|----------------|
| 0 | config | src/config/ | Configuration, schemas |
| 1 | domain | src/domain/ | Core business logic |
| 2 | infrastructure | src/infrastructure/ | External integrations |
| 3 | application | src/application/ | Use cases, orche