zhongwei/gh-khgs2411-flow-flow-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Zhongwei Li
2025-11-30 08:31:21 +08:00
commit c2b4c1cd61
4 changed files with 448 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
.claude-plugin/plugin.json Normal file
View File

@@ -0,0 +1,12 @@
{
"name": "flow",
"description": "Flow framework - Ultra-lightweight installer. Run /flow-init to download all 29 commands + 8 skills + 1 Claude agent",
"version": "1.6.12",
"author": {
"name": "Topsyde Utils",
"url": "https://github.com/topsyde-utils/flow"
},
"commands": [
"./commands"
]
}

3
README.md Normal file
View File

@@ -0,0 +1,3 @@
# flow
Flow framework - Ultra-lightweight installer. Run /flow-init to download all 29 commands + 8 skills + 1 Claude agent

388
commands/flow-init.md Normal file
View File

@@ -0,0 +1,388 @@
---
description: Install/update complete Flow framework (commands, skills, framework files)
---
You are executing the `/flow-init` command from the Flow framework.
**Purpose**: Download and install Flow framework files directly from GitHub repository.
**🟢 NO FRAMEWORK READING REQUIRED - This is the installation command**
**Instructions**:
1. **Detect installation mode**:
Check if `.claude/commands/` directory exists with flow-*.md files:
```bash
if [ -d ".claude/commands" ] && ls .claude/commands/flow-*.md >/dev/null 2>&1; then
echo "UPDATE"
else
echo "INSTALL"
fi
```
2. **Show what will be installed** and get user confirmation:
```
📥 Flow Framework [MODE - INSTALL or UPDATE]
I will download and install from GitHub (khgs2411/flow):
✓ 29 slash commands → .claude/commands/
✓ 8 agent skills → .claude/skills/
✓ 1 Claude agent → .claude/agents/
✓ Framework docs → .flow/framework/
✓ Example files → .flow/framework/examples/
Total download size: ~210KB
[If UPDATE mode: ⚠️ Existing Flow files will be overwritten]
Proceed with installation? (y/n)
```
3. **If user declines**, stop and show:
```
⚠️ Installation cancelled. Run /flow-init again when ready.
```
4. **If user approves**, execute installation using Bash tool:
Run this complete bash script:
```bash
# Base URL for GitHub raw files
BASE_URL="https://raw.githubusercontent.com/khgs2411/flow/master"
echo "📦 Installing Flow framework..."
echo ""
# Create directories
mkdir -p .claude/commands
mkdir -p .claude/skills
mkdir -p .claude/agents
mkdir -p .flow/framework/examples/phase-1
mkdir -p .flow/framework/examples/phase-2
echo "📝 Downloading slash commands from framework/commands/..."
# Download all 29 commands
COMMANDS=(
"flow-backlog-add" "flow-backlog-pull" "flow-backlog-view"
"flow-blueprint" "flow-brainstorm-complete" "flow-brainstorm-review"
"flow-brainstorm-start" "flow-brainstorm-subject" "flow-compact"
"flow-implement-complete" "flow-implement-start" "flow-iteration-add"
"flow-migrate" "flow-next" "flow-next-iteration"
"flow-next-subject" "flow-phase-add" "flow-phase-complete"
"flow-phase-start" "flow-plan-split" "flow-plan-update"
"flow-rollback" "flow-status" "flow-summarize"
"flow-task-add" "flow-task-complete" "flow-task-start"
"flow-verify-plan" "flow-init"
)
for cmd in "${COMMANDS[@]}"; do
if curl -sS -f -o ".claude/commands/${cmd}.md" \
"$BASE_URL/framework/commands/${cmd}.md" 2>/dev/null; then
echo " ✓ ${cmd}"
else
echo " ✗ ${cmd} (download failed)"
fi
done
echo ""
echo "🤖 Downloading agent skills from framework/skills/..."
# Download all skill directories
SKILLS=(
"flow-builder" "flow-completer" "flow-curator"
"flow-designer" "flow-initializer" "flow-navigator"
"flow-planner" "flow-verifier"
)
for skill in "${SKILLS[@]}"; do
mkdir -p ".claude/skills/${skill}"
# Download SKILL.md (required)
if curl -sS -f -o ".claude/skills/${skill}/SKILL.md" \
"$BASE_URL/framework/skills/${skill}/SKILL.md" 2>/dev/null; then
# Try to download additional skill files if they exist (optional)
for file in TEMPLATES.md PATTERNS.md VERIFICATION.md EXAMPLES.md DASHBOARD_TEMPLATE.md MIGRATION_PATTERNS.md OTHER_TEMPLATES.md PLAN_TEMPLATE.md TASK_TEMPLATES.md RESOLUTION_TYPES.md PLAN_UPDATES.md VERIFY.md; do
curl -sS -f -o ".claude/skills/${skill}/${file}" \
"$BASE_URL/framework/skills/${skill}/${file}" 2>/dev/null || true
done
echo " ✓ ${skill}"
else
echo " ✗ ${skill} (download failed)"
fi
done
echo ""
echo "🤖 Downloading Claude agent from framework/agents/..."
# Download Flow agent
if curl -sS -f -o ".claude/agents/flow.md" \
"$BASE_URL/framework/agents/flow.md" 2>/dev/null; then
echo " ✓ flow"
else
echo " ✗ flow (download failed)"
fi
echo ""
echo "📝 Updating CLAUDE.md..."
# Update CLAUDE.md with Flow agent delegation instruction
CLAUDE_MD="$(pwd)/CLAUDE.md"
FLOW_INSTRUCTION='**This project uses the Flow framework for project management.**
**CRITICAL DELEGATION RULE**: You MUST delegate ALL Flow-related operations to the Flow sub-agent.
**HOW TO DELEGATE TO FLOW:**
```
Task tool → subagent_type: "flow" → description + prompt
```
**DO NOT use these (they execute in YOUR context, not Flow'\''s):**
- ❌ Skill tool with flow-* skills
- ❌ SlashCommand tool with /flow-* commands
- ❌ Reading .flow/ files directly
- ❌ Task tool with subagent_type: "general-purpose"
**ALWAYS delegate when the user**:
- Asks about status/progress: "what am I working on?", "what'\''s next?", "show my status"
- Manages work: "add a task", "create a phase", "start iteration", "mark as complete"
- Plans features: "I want to build X", "let'\''s plan Y", "add feature Z"
- Updates architecture: "update PLAN.md", "add a guideline", "change the approach"
- Asks methodology questions: "what are iterations?", "how do phases work?"
- Mentions ANY of: tasks, phases, iterations, DASHBOARD, PLAN, brainstorm, .flow/ files, /flow-* commands
**ROLE SEPARATION:**
- Flow agent = PROJECT MANAGER (workflow, planning, status)
- You = ENGINEER (code implementation, debugging, git operations)'
if [ -f "$CLAUDE_MD" ]; then
# CLAUDE.md exists - update it
if grep -qi "flow framework" "$CLAUDE_MD"; then
# Flow notice exists - replace it with updated version
echo " ↻ Updating existing Flow framework notice"
# Strategy: Remove entire old flow section, then add new one
TEMP_FILE="${CLAUDE_MD}.tmp"
in_flow_section=0
blank_count=0
# First pass: remove the entire flow framework block (all lines until next section header)
while IFS= read -r line; do
# Detect start of flow framework section
if [[ "$line" =~ flow\ framework ]] && [ $in_flow_section -eq 0 ]; then
in_flow_section=1
blank_count=0
continue
fi
# If in flow section, skip until we hit TWO consecutive blank lines or a new section header
if [ $in_flow_section -eq 1 ]; then
# Check if this is a new markdown section (##)
if [[ "$line" =~ ^##\ ]]; then
in_flow_section=0
echo "$line"
continue
fi
# Track consecutive blank lines
if [[ "$line" =~ ^$ ]]; then
blank_count=$((blank_count + 1))
# Two consecutive blank lines = end of flow section
if [ $blank_count -ge 2 ]; then
in_flow_section=0
echo "$line"
continue
fi
else
blank_count=0
fi
# Still in flow section, skip this line
continue
fi
echo "$line"
done < "$CLAUDE_MD" > "$TEMP_FILE"
# Second pass: add new flow content
FINAL_FILE="${CLAUDE_MD}.final"
inserted=0
# Check if "## Important rules and guidelines" still exists
if grep -q "^## Important rules and guidelines" "$TEMP_FILE"; then
# Guidelines header exists - insert under it
while IFS= read -r line; do
echo "$line"
if [[ "$line" =~ ^##\ Important\ rules\ and\ guidelines ]] && [ $inserted -eq 0 ]; then
echo "$FLOW_INSTRUCTION"
inserted=1
fi
done < "$TEMP_FILE" > "$FINAL_FILE"
else
# No guidelines header - need to create it
after_title=0
while IFS= read -r line; do
echo "$line"
# Track when we pass the title
if [[ "$line" =~ ^#\ CLAUDE\.md ]]; then
after_title=1
fi
# Insert after the boilerplate line (the "This file provides..." line)
if [ $after_title -eq 1 ] && [ $inserted -eq 0 ]; then
if [[ "$line" =~ This\ file\ provides\ guidance ]]; then
echo ""
echo "## Important rules and guidelines"
echo "$FLOW_INSTRUCTION"
echo ""
inserted=1
fi
fi
done < "$TEMP_FILE" > "$FINAL_FILE"
# If never inserted, add at top
if [ $inserted -eq 0 ]; then
{
echo "## Important rules and guidelines"
echo "$FLOW_INSTRUCTION"
echo ""
cat "$TEMP_FILE"
} > "$FINAL_FILE"
fi
fi
mv "$FINAL_FILE" "$CLAUDE_MD"
rm -f "$TEMP_FILE"
else
# No flow notice - add it
echo " + Adding Flow framework notice"
TEMP_FILE="${CLAUDE_MD}.tmp"
inserted=0
if grep -q "^## Important rules and guidelines" "$CLAUDE_MD"; then
# Guidelines header exists - insert under it
while IFS= read -r line; do
echo "$line"
if [[ "$line" =~ ^##\ Important\ rules\ and\ guidelines ]] && [ $inserted -eq 0 ]; then
echo "$FLOW_INSTRUCTION"
inserted=1
fi
done < "$CLAUDE_MD" > "$TEMP_FILE"
mv "$TEMP_FILE" "$CLAUDE_MD"
else
# No guidelines header - create it
after_title=0
while IFS= read -r line; do
echo "$line"
if [[ "$line" =~ ^#\ CLAUDE\.md ]]; then
after_title=1
fi
if [ $after_title -eq 1 ] && [ $inserted -eq 0 ]; then
if [[ "$line" =~ This\ file\ provides\ guidance ]]; then
echo ""
echo "## Important rules and guidelines"
echo "$FLOW_INSTRUCTION"
echo ""
inserted=1
fi
fi
done < "$CLAUDE_MD" > "$TEMP_FILE"
if [ $inserted -eq 0 ]; then
{
echo "## Important rules and guidelines"
echo "$FLOW_INSTRUCTION"
echo ""
cat "$CLAUDE_MD"
} > "$TEMP_FILE"
fi
mv "$TEMP_FILE" "$CLAUDE_MD"
fi
fi
echo " ✓ CLAUDE.md updated"
else
echo " ⏭️ No CLAUDE.md found - skipping"
fi
echo ""
echo "📚 Downloading framework documentation..."
# Download framework reference
if curl -sS -f -o .flow/framework/DEVELOPMENT_FRAMEWORK.md \
"$BASE_URL/framework/DEVELOPMENT_FRAMEWORK.md" 2>/dev/null; then
echo " ✓ DEVELOPMENT_FRAMEWORK.md"
else
echo " ✗ DEVELOPMENT_FRAMEWORK.md (download failed)"
fi
# Download examples (failures are ok - not all may exist)
echo ""
echo "📂 Downloading framework examples..."
curl -sS -f -o .flow/framework/examples/DASHBOARD.md \
"$BASE_URL/framework/examples/DASHBOARD.md" 2>/dev/null && \
echo " ✓ examples/DASHBOARD.md" || echo " ✗ examples/DASHBOARD.md (optional file not found)"
curl -sS -f -o .flow/framework/examples/PLAN.md \
"$BASE_URL/framework/examples/PLAN.md" 2>/dev/null && \
echo " ✓ examples/PLAN.md" || echo " ✗ examples/PLAN.md (optional file not found)"
curl -sS -f -o .flow/framework/examples/phase-1/task-1.md \
"$BASE_URL/framework/examples/phase-1/task-1.md" 2>/dev/null && \
echo " ✓ examples/phase-1/task-1.md" || echo " ✗ examples/phase-1/task-1.md (optional file not found)"
curl -sS -f -o .flow/framework/examples/phase-2/task-3.md \
"$BASE_URL/framework/examples/phase-2/task-3.md" 2>/dev/null && \
echo " ✓ examples/phase-2/task-3.md" || echo " ✗ examples/phase-2/task-3.md (optional file not found)"
```
5. **Show completion message**:
```bash
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "✅ Flow framework installed successfully!"
echo ""
echo "📦 Installation summary:"
echo " • 29 commands in .claude/commands/"
echo " • 8 skills in .claude/skills/"
echo " • 1 agent in .claude/agents/"
echo " • Framework docs in .flow/framework/"
echo " • Example files in .flow/framework/examples/"
echo ""
echo "🎯 Next steps:"
echo ""
if [ ! -f ".flow/DASHBOARD.md" ]; then
echo "**New Flow project**:"
echo " Run: /flow-blueprint \"Your Project Description\""
echo ""
echo "**Migrate existing docs**:"
echo " Run: /flow-migrate"
else
echo "**Existing Flow project detected**"
echo " Framework files updated"
echo " Continue with: /flow-status"
fi
echo ""
echo "⚠️ IMPORTANT: Restart Claude Code to load the new commands!"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
```
6. **Error handling**:
- Network errors: Show "❌ Download failed. Check internet connection"
- Permission errors: Show "❌ Permission denied. Check directory permissions"
- Partial failures are OK - show which files succeeded/failed

45
plugin.lock.json Normal file
View File

@@ -0,0 +1,45 @@
{
"$schema": "internal://schemas/plugin.lock.v1.json",
"pluginId": "gh:khgs2411/flow:flow-plugin",
"normalized": {
"repo": null,
"ref": "refs/tags/v20251128.0",
"commit": "ec25c3c2ddd31f83d7fe54266d3735d21601302a",
"treeHash": "02b8c430da14eab40c12c95c1c87cb785864dc0bd5373f45b00f4242547bbbf1",
"generatedAt": "2025-11-28T10:19:29.092451Z",
"toolVersion": "publish_plugins.py@0.2.0"
},
"origin": {
"remote": "git@github.com:zhongweili/42plugin-data.git",
"branch": "master",
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
},
"manifest": {
"name": "flow",
"description": "Flow framework - Ultra-lightweight installer. Run /flow-init to download all 29 commands + 8 skills + 1 Claude agent",
"version": "1.6.12"
},
"content": {
"files": [
{
"path": "README.md",
"sha256": "5ce36a0d86d3031f1f972d9b418488cf48b62a255f2dfb533f4978916a3b8514"
},
{
"path": ".claude-plugin/plugin.json",
"sha256": "f9017a04faf1201e60b0612cb375febd3ad570ddddfd588b7d9946b54a027bc0"
},
{
"path": "commands/flow-init.md",
"sha256": "a43052f58971d1bf963b585f4b547b45b77cda9a22ee4875f8a2b4f3fe53f29a"
}
],
"dirSha256": "02b8c430da14eab40c12c95c1c87cb785864dc0bd5373f45b00f4242547bbbf1"
},
"security": {
"scannedAt": null,
"scannerVersion": null,
"flags": []
}
}