sync-feature-flows

Sync Feature Flows

ℹ️ First, set expectations: before anything else, print one short line with this skill's version and its most recent change — the top entry of metadata.changelog above — e.g. sync-feature-flows vX.Y — recent: <summary>. Then proceed.

Analyze code changes and synchronize feature flow documentation.

Purpose

Keep feature flow documentation in sync with code changes by:

• Detecting which features were affected by recent changes
• Updating existing flow documents with new file paths, line numbers, endpoints
• Creating new flow documents for newly introduced features
• Maintaining a minimal, navigable index in feature-flows.md

State Dependencies

Source	Location	Read	Write	Description
Feature Flows Index	docs/memory/feature-flows.md	✅	✅	Flow index (keep minimal)
Feature Flow Docs	docs/memory/feature-flows/*.md	✅	✅	Individual flow documents
Git History	.git	✅		Recent changes
Source Code	src/	✅		All source files

Arguments

• $ARGUMENTS:
  • recent or empty: Analyze last 5 commits
  • HEAD~N..HEAD: Specific commit range
  • file1.py file2.vue: Specific files to analyze

Process

Step 1: Identify Changed Files

# If 'recent' or no argument
git log --oneline -5 --name-only | grep -E '\.(py|vue|js|ts|tsx|jsx)$' | sort -u

# If commit range provided
git diff --name-only $ARGUMENTS | grep -E '\.(py|vue|js|ts|tsx|jsx)$'

Step 2: Map Files to Features

Find which existing flow documents reference the changed files:

grep -rl "changed-file-name" docs/memory/feature-flows/*.md

Step 3: Check Existing Flows

Categorize:

• Needs Update: Flow exists but code changed significantly
• Needs Creation: No flow exists for this feature
• Up to Date: Flow exists and changes are minor

Step 4: Present Analysis

[APPROVAL GATE]

Present findings and wait for approval before making changes.