quangflow

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