flow-comparelisted

Triggered by /flow-compare <github-url-or-local-path> [path-to-reviewer-blocks] [--force]. Compares THIS workflow repo against another agentic-workflow repo and produces a structured gap report (seven lenses, severity emoji, gaps table + prioritized recommendations, fixed verdict) in docs/flow-compare/. Freshness-checked: if the target hasn't changed since the last run, it reports and stops at near-zero tokens. Use when the user runs /flow-compare, or asks to "compare our workflow against <repo>", "gap-compare with X", "what does <repo> do that we don't".
orassayag/agentic-project-workflow · ★ 1 · AI & Automation · score 65

Install: claude install-skill orassayag/agentic-project-workflow

# /flow-compare — gap-compare this workflow against another repo Repeats the proven comparison process (the one that produced PLAN-IMPROVEMENTS.md) against any other agentic-workflow repo. **Deliverable stops at the gap report + recommendations table — adoption stays a manual per-item choice; never auto-edit skills from a comparison run.** ## Arguments 1. **Target** (required): a GitHub URL or a local path. 2. **Reviewer blocks file** (optional): externally collected reviews, separated by lines of 5+ `=` characters with a `Reviewer:` header line each — merged exactly the way `/plan-review` merges external reviews. 3. `--force`: skip the freshness check. ## State `~/.claude/flow-compare/state.json` — per-target entries: ```json { "target": "<url-or-path>", "targetCommit": "<sha>", "ownRepoCommit": "<sha>", "date": "<ISO>", "reportPath": "<path>" } ``` `ownRepoCommit` is the HEAD of `~/Repos/agentic-project-workflow` at run time — recorded so the skill can suggest a forced re-run when our side has changed a lot since the last comparison, even if the target hasn't. ## Step 1 — Freshness check (before reading ANYTHING) Resolve the target's current HEAD **without acquiring it**: - URL: `git ls-remote <url> HEAD` — no clone needed. - Local path: `git -C <path> rev-parse HEAD`. Compare with the state file. If unchanged and no `--force`: > "No changes since <date> (<commit>). Last report: <reportPath>." > (If our own repo has moved substantially since `ownRepoComm