archflow-marketplace

Archflow

Document-driven development skills with Multi-Agent Debate for AI coding tools

Archflow is a skill-based plugin for AI coding tools (Cursor, Claude Code, OpenCode) that enables systematic, document-driven development workflows. It leverages Multi-Agent Debate to produce high-quality architectural designs and maintains full traceability from requirements to implementation.

System Workflow

┌─────────────────────────────────────────────────────────────────────────────┐
│                            Backend Development                              │
│                                                                             │
│  /spec → /arch → /check → /pre-build → /build → /test                      │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                           Frontend Development                              │
│                                                                             │
│  /spec → /arch(BE) → /check → /ui → /arch(FE) → /check → /pre-build       │
│       → /build → /test                                                      │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                              Bug Fix                                        │
│                                                                             │
│  /debug → /trace → /sync                                                    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                             Enhancement                                     │
│                                                                             │
│  /reinforce → /arch → /check → /pre-build → /build → /test                 │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                         Legacy Documentation                                │
│                                                                             │
│  /reverse → /reinforce (optional) → /check                                  │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

SSOT Principle: All changes start from spec.md. arch.md is a derived document.

Features

• Document-Driven Development: Maintain clear requirements, designs, and changelogs throughout the development lifecycle
• Multi-Agent Debate: Two specialized agents (Domain Architect and Best Practice Advisor) collaborate to produce optimal designs
• Systematic Workflows: 15 pre-built skills for common development tasks
• Full Traceability: Keep documentation synchronized with code changes

Installation

AI-Assisted (Recommended)

Open docs/launchpad.md in your AI tool and tell the AI:

"Follow this launchpad to install archflow"

The AI will clone the repository and copy the necessary files automatically.

Manual Installation

Cursor

git clone https://github.com/samdae/archflow.git .archflow-tmp
cp -r .archflow-tmp/skills/ .cursor/skills/
cp -r .archflow-tmp/rules/ .cursor/rules/
cp -r .archflow-tmp/agents/ .cursor/agents/
rm -rf .archflow-tmp

Claude Code

Inside Claude Code, run these commands:

/plugin marketplace add samdae/archflow
/plugin install archflow@samdae
/plugin enable archflow@samdae

OpenCode

git clone https://github.com/samdae/archflow.git .archflow-tmp
cp -r .archflow-tmp/skills/ .opencode/skills/
cp -r .archflow-tmp/commands/ .opencode/commands/
cp -r .archflow-tmp/agents/ .opencode/agents/
cp -r .archflow-tmp/rules/ .opencode/rules/
rm -rf .archflow-tmp

Then add to opencode.json in the project root (create if absent):

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": [".opencode/rules/archflow-rules.md"]
}

If opencode.json already exists, append to the instructions array instead of overwriting.

Supported Tools