Arch

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

1|Updated Jan 30, 2026

Search Tags:#design #architecture #documentation #multi-agent #code-mapping

Ready to run

npx skills add https://github.com/samdae/archflow --skill arch

💬 Prompt for ChatGPT / Claude Chat▼

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.