Build Architect

Define repository architecture and migration steps in an ARCHITECTURE_PLAN.md.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/soheunyi/get-research-done --skill build-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Build Architect
Source: https://github.com/soheunyi/get-research-done/tree/main/skills/grd-build-architect
Command: npx skills add https://github.com/soheunyi/get-research-done --skill build-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a disciplined approach to designing repository architecture, module boundaries, and migration steps before implementation, reducing future decision cost and rewrites.

Core Features & Use Cases

  • Defines concrete repository shapes and ownership guidelines to minimize coupling and clarify responsibilities.
  • Outlines dependency directions and migration slices aligned with existing conventions to support incremental refactors.
  • Use Case: Start a new project or plan a large refactor by producing an executable ARCHITECTURE_PLAN.md that guides teams.

Quick Start

Ask for constraints and deliver a concrete architecture plan outlining repository structure, module boundaries, and migration steps.

Frequently Asked Questions about Build Architect

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

FAQPage Schema
How do I plan a scalable repository architecture for a large codebase refactor?

To plan a scalable repository architecture, you define clear module boundaries, ownership guidelines, and dependency directions to minimize coupling. This approach produces a concrete architecture plan that guides incremental refactors and reduces future decision costs.

What is the best way to define module boundaries and ownership for a platform migration?

Defining module boundaries for a platform migration involves outlining dependency directions and creating concrete implementation slices aligned with existing conventions. This clarifies responsibilities and supports incremental migration steps without disrupting the entire codebase.

When do I need to document repository structure and dependency directions?

You need to document repository structure and dependency directions when starting a new project or planning a large refactor. It is essential for medium-to-large codebases to establish clear ownership and prevent tightly coupled modules before implementation begins.

How do I create an architecture plan for incremental refactoring?

You create an architecture plan by asking for project constraints and delivering a concrete outline of repository structure, module boundaries, and migration steps. This results in an executable plan that guides teams through incremental refactoring.

Can I use this approach for medium-to-large codebases with existing conventions?

Yes, this architecture planning approach is designed for medium-to-large codebases and explicitly aligns migration slices with existing conventions. It ensures that any structural changes or refactors respect current project conventions while clarifying ownership.

What are the limitations of planning repository architecture before implementation?

Planning repository architecture before implementation requires strict discipline to gather accurate constraints upfront. Without clear requirements for dependency direction and ownership, the resulting architecture plan may not effectively minimize coupling or guide incremental refactors.