plan-clean-architecture

Generate phased Clean Architecture specifications with interfaces and gate checks.

Updated May 21, 2025
One-click install
npx skills add https://github.com/jonparkdev/nix-config --skill plan-clean-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-clean-architecture
Source: https://github.com/jonparkdev/nix-config/tree/main/ai/skills/plan-clean-architecture
Command: npx skills add https://github.com/jonparkdev/nix-config --skill plan-clean-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and generate comprehensive architecture specifications for codebases that implement Clean Architecture.

Core Features & Use Cases

  • Produce a complete spec with architecture, interfaces, boundary enforcement, phased implementation with gate checks, and validation.
  • Trigger on planning actions like plan a feature, write a spec, add a module, design this feature, or when describing multi-layer changes.
  • Useful for teams migrating to or maintaining layered architectures, ensuring clear boundaries and roadmaps.

Quick Start

Provide a feature idea and I will generate a phased Clean Architecture spec.

Frequently Asked Questions about plan-clean-architecture

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

FAQPage Schema
How do I generate a clean architecture spec for a new software feature?

To generate a clean architecture spec, provide a feature idea to trigger the planning action. The system produces a comprehensive specification including objectives, use cases, architecture diagrams, interfaces, and boundary enforcement across controller, domain, and infrastructure layers.

What is included in a phased execution plan for layered architecture changes?

A phased execution plan for layered architecture includes implementation phases with gate checks, architecture diagrams, interface definitions, boundary enforcement rules, ADRs, and validation criteria to ensure safe module additions or changes across cmd, services, and platform layers.

Can I use this to plan a migration to clean architecture boundaries?

Yes, you can use this to plan a migration to clean architecture boundaries. It supports teams maintaining or migrating to layered architectures by generating clear boundaries and roadmaps for controller, domain, and infrastructure layers.

How do architecture gate checks work during feature implementation?

Architecture gate checks work by validating boundary enforcement and interface compliance at each implementation phase. They ensure that changes across layered boundaries adhere to the clean architecture spec before proceeding to the next phase.

What's the best way to design an architecture-first feature specification?

The best way to design an architecture-first feature specification is to use interface-driven design principles. This approach generates a complete spec template covering objectives, use cases, interfaces, boundary enforcement, and ADRs for robust architecture planning.

Do I need an existing codebase to plan clean architecture module additions?

No, you do not need an existing codebase to plan clean architecture module additions. You can provide a feature idea or describe multi-layer changes to generate a phased execution plan with gate checks and validation criteria.