Arch

Coordinate multi-agent debates to produce architecture decision documents from spec.md.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/samdae/archflow --skill arch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Arch
Source: https://github.com/samdae/archflow/tree/main/skills/arch
Command: npx skills add https://github.com/samdae/archflow --skill arch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Arch addresses the challenge of converging on high-quality architectural decisions in complex software projects by coordinating structured, multi-agent debates.

Core Features & Use Cases

  • Round-based debate between Domain Architect and Best Practice Advisor to derive design proposals for backend and frontend architectures.
  • Template-driven outputs that generate arch-be.md or arch-fe.md from spec-driven inputs.
  • Traceability and mapping from requirements to architecture decisions, with documentation templates and code-mapping guidance.

Quick Start

Use Arch by providing your spec path (e.g., docs/{serviceName}/spec.md). Arch will generate arch-be.md or arch-fe.md using the built-in templates and code-mapping guidance.

Frequently Asked Questions about Arch

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

FAQPage Schema
How do I generate architecture documentation from a spec.md file?

To generate architecture documentation from a spec.md file, you provide the spec path and the system outputs arch-be.md or arch-fe.md. It applies template-driven outputs to produce architecture decisions and code-mapping guidance based on your requirements.

What is the best way to derive architectural decisions for complex software projects?

The best way to derive architectural decisions is through structured, multi-agent debates. By coordinating a round-based debate between a Domain Architect and a Best Practice Advisor, you converge on high-quality design proposals for backend and frontend architectures.

Can I use multi-agent debates for both frontend and backend architecture work?

Yes, you can use multi-agent debates for both frontend and backend architecture work. The process accepts spec-driven inputs and generates specific arch-be.md or arch-fe.md files, applying traceability and mapping from requirements to architecture decisions.

How does code-mapping guidance work with generated architecture templates?

Code-mapping guidance works by providing traceability from captured requirements to architecture decisions. After generating arch-be.md or arch-fe.md from your spec.md, the templates include documentation and mapping guidance to connect the design to the codebase.

Do I need a spec.md file to start the architecture design process?

Yes, you need a spec.md file to start the architecture design process. The system requires a spec path as input to initiate the round-based debate and generate the corresponding arch-be.md or arch-fe.md output files.