# Architecture Ideation

> Trigger: architecture refactor ideas, target architecture, modular monolith, architecture patterns, restructure the system. Produce an ADR and one neutral execution plan.

- Skill: `andresnator/architecture-ideation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add andresnator/architecture-ideation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/andresnator/architecture-ideation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: andresnator (https://skillmd.com/u/andresnator)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/andresnator/architecture-ideation

---


## Contract

Design architecture-level change from verified state. Class or method refactors belong to Deep Plan. Write only one ADR and one plan; never edit source, commit, or push.

## Flow

1. Establish evidenced current architecture.
2. Shape modules from domain boundaries, not folders.
3. Compare 2-3 candidates by forces, trade-offs, migration cost, first reversible step. Recommend one; microservices must justify operational cost.
4. Converge on boundaries, incremental migration; no big bang.
5. Record decision and rejected candidates in one ADR.
6. Load `execution-plan` and `implementation-skill-routing`. Write one `.ai/architect/plans/<slug>.md`. Record selected names per work group. Group 1 creates fitness-function guardrails; later groups keep the build green.

Patterns need evidenced forces plus pragmatic and KISS gates. Each work item maps to an ADR decision or architecture gap and names real files. Return the chosen architecture, ADR path, plan path, first reversible step, and `ejecuta el plan <path>`.