QuangFlow
A 5-phase workflow framework for Claude Code that turns your AI assistant into a deliberate, structured project manager and architect.
What It Does
Adds 12 slash commands to Claude Code:
| Command | Phase | Purpose |
|---|
/qf:adopt | — | Onboard an existing codebase into QuangFlow (adaptive scan + feature extraction + doc generation) |
/qf:0-init <idea> | 0. Init | Project setup, codebase scan, create CONTEXT.md (run once per feature) |
/qf:1-brainstorm | 1. Requirements | Clarifying questions, edge cases, milestone splits, team composition |
/qf:2-design | 2. Design | Architecture options with trade-offs, design pattern research, scalability gates |
/qf:3-handoff | 3. Handoff | Execution artifacts (ROADMAP, REQUIREMENTS finalization), SHIP/REFINE gate |
/qf:4-verify | 4. Verify & Certify | TDD compliance audit, requirements traceability, evidence certification |
/qf:5-maintain | 5. Maintain | Post-ship bug fix, systematic debugging protocol, structured log scan |
/qf:quick <task> | Quick | Streamlined flow for small tasks — minimal team (dev + tester), TDD enforced |
/qf:cook | Orchestrator | Launches agent team pipeline (domain-engineer → devs → tech-lead → tester → PM) |
/qf:status | Status | Session-aware status reporter with resume context |
/qf:test | Smoke Test | Auto-detect stack, generate integration scripts, verify real module interactions |
/qf:guide | Guide | Interactive guided tour — walk through every phase step-by-step |
/qf:update | Update | Pull latest QuangFlow from GitHub and reinstall commands + agents |
Philosophy
- Slow in phases 1-2: Surface problems before proposing solutions. Challenge assumptions. Devil's advocate every requirement.
- Structured in phases 3-4: Clear deliverables, acceptance criteria, test coverage, gap detection.
- Never self-advances: Every phase requires explicit user approval (APPROVE → pick option → CONFIRM → SHIP).
- Plan over tools: Spend more time designing, less time fixing.
Install
As a Plugin (recommended)
# Step 1: Add QuangFlow marketplace (one-time)
claude plugin marketplace add https://github.com/DuongMQuang/quangflow
# Step 2: Install
claude plugin install quangflow
# Update later
claude plugin update quangflow
Plugin benefits: one-command install, auto-updates, no file conflicts.
One-liner (remote)
# Interactive — asks global or project
curl -fsSL https://raw.githubusercontent.com/DuongMQuang/quangflow/main/remote-install.sh | bash
# Global install (available in all projects)
curl -fsSL https://raw.githubusercontent.com/DuongMQuang/quangflow/main/remote-install.sh | bash -s -- --global
# Project install (specific project only)
curl -fsSL https://raw.githubusercontent.com/DuongMQuang/quangflow/main/remote-install.sh | bash -s -- --project /path/to/project
Manual
git clone https://github.com/DuongMQuang/quangflow.git
cd quangflow
bash install.sh # interactive
bash install.sh --global # install to ~/.claude/
bash install.sh --project # install to current project
bash install.sh --update # update commands+agents only (keeps CLAUDE.md)
Global vs Project Install
| Global (~/.claude/) | Project (.claude/) |
|---|
| Scope | All projects | This project only |
| Best for | Personal workflow across all repos | Team repos (commit .claude/ to git) |
| CLAUDE.md | ~/.claude/CLAUDE.md | ./CLAUDE.md (project root) |
| Plans dir | Each project manages own ./plans/ | ./plans/ created automatically |
What Gets Installed
DuongMQuang