architecture-scaffold

Generate a compilable type-level skeleton from an architecture specification document.

42|11|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/petekp/claude-code-setup --skill architecture-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-scaffold
Source: https://github.com/petekp/claude-code-setup/tree/main/skills/architecture-scaffold
Command: npx skills add https://github.com/petekp/claude-code-setup --skill architecture-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures architectural integrity by generating a compilable type skeleton before implementation, preventing design drift and costly refactoring errors.

Core Features & Use Cases

  • Architecture Validation: Creates a type-level skeleton of a new architecture, proving its structural soundness with the compiler.
  • Migration Planning: Maps existing codebase logic to the new skeleton, defining clear actions (PORT, ADAPT, REWRITE) for migration.
  • Use Case: When undertaking a large-scale refactor, use this Skill to first build the complete, type-checked shell of the new system, ensuring all modules and interfaces fit together correctly before any business logic is written.

Quick Start

Use the architecture-scaffold skill to generate a compilable type skeleton from the provided architecture specification document.

Frequently Asked Questions about architecture-scaffold

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

FAQPage Schema
How do I generate a type-level architecture skeleton from a specification document?

You can generate a type-level architecture skeleton by providing a specification document to the scaffolding process, which creates a compilable structural shell. This skeleton validates architectural soundness through compilation and dependency checks before any business logic is implemented.

What is the best way to validate architectural soundness before writing business logic?

Validating architectural soundness is achieved by generating a compilable type skeleton that proves structural integrity with the compiler. This approach prevents design drift and costly refactoring errors by ensuring all modules and interfaces fit together correctly before implementation begins.

How do I plan a large-scale refactoring migration from an existing codebase to a new architecture?

Planning a refactoring migration involves mapping existing codebase logic to the newly generated type skeleton. This mapping defines clear migration actions—PORT, ADAPT, or REWRITE—for each component, ensuring a structured transition to the new architecture.

Can I check dependency compatibility when building a new software architecture skeleton?

Checking dependency compatibility is a core feature of generating an architecture skeleton, as the process validates structural soundness through dependency checks. This ensures that all module interfaces and dependencies align correctly before implementation proceeds.

When do I need to use scaffolding for software architecture migration?

Scaffolding for software architecture migration is needed when undertaking a large-scale refactor to prevent design drift. It builds a complete, type-checked shell of the new system first, ensuring all modules and interfaces fit together correctly before any business logic is written.