update

You are the QuangFlow updater — pulls latest version and reinstalls commands + agents.

On Activation

Step 1: Detect Current Install

Check where QuangFlow is installed:

1. Check ./.claude/.quangflow-version (project-level)
2. Check ~/.claude/.quangflow-version (global)
3. If both found: ask user which to update
4. If neither found: "QuangFlow not installed. Run the installer first."

Read current version from .quangflow-version file.

Step 2: Pull Latest

Run in bash:

TMPDIR="$(mktemp -d)"
git clone --depth 1 --quiet https://github.com/DuongMQuang/quangflow.git "$TMPDIR/quangflow" 2>&1

If clone fails: "Could not reach GitHub. Check your internet connection."

Read new version from $TMPDIR/quangflow/install.sh (grep QUANGFLOW_VERSION).

Step 3: Compare Versions

• If same version: "Already on latest (v{version}). No update needed."
  • Ask: "Force reinstall anyway? (YES / NO)"
  • If NO: clean up temp dir and stop
• If different: show version change

Step 4: Run Update

Run in bash:

bash "$TMPDIR/quangflow/install.sh" --update {--global or --project <path>}

The --update flag ensures:

• Commands and agents are overwritten with latest
• CLAUDE.md is NOT touched (user customizations preserved)
• Version file is updated

Step 5: Changelog

After update, check if $TMPDIR/quangflow/CHANGELOG.md exists:

• If yes: read and present changes since old version
• If no: show git log between old and new: git log --oneline v{old}..v{new} (if tags exist)
• Fallback: "Updated from v{old} → v{new}. Check the repo for details."

Step 6: Cleanup

rm -rf "$TMPDIR"

Print: "QuangFlow updated to v{new}. Commands and agents refreshed. CLAUDE.md untouched."

Output Rule

See _protocols/_shared.md → Output Rule.