flows

flows is a command for Claude Code from anshss/shiploop. It costs 0 tokens per session (2,011 once invoked), scanned A, original, Apache-2.0.

A command for managing a registry of user-accessible paths through a product. It can extract those paths, list their validation status, and create validation tickets for selected paths.

In plain words
What is it for?
Building a flow inventory, checking its status, and filing validation work for stale or untested flows in a Shiploop workspace.
Why use it?
It keeps track of which product flows have been tested and which may be outdated, without relying on manual registry edits.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; mentions subagents.

Part of the shiploop plugin — 2 skills, 7 commands, 3 agents shipped together

Good fit Building a flow inventory, checking its status, and filing validation work for stale or untested flows in a Shiploop workspace.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/anshss/shiploop/flows
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/anshss/shiploop

Made for: Claude Code.

Or install shiploop, the plugin that ships this one along with the rest of its 2 skills, 7 commands, 3 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for flows

README.md
[![agentmods](https://agentmods.dev/badge/commands/anshss/shiploop/flows/github.svg)](https://agentmods.dev/commands/anshss/shiploop/flows)
Your own site
<a href="https://agentmods.dev/commands/anshss/shiploop/flows"><img src="https://agentmods.dev/badge/commands/anshss/shiploop/flows/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for flows

Your own site · 80×15
<a href="https://agentmods.dev/commands/anshss/shiploop/flows"><img src="https://agentmods.dev/badge/commands/anshss/shiploop/flows.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,011 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.02011
Opus 5.5 $0.00000 $0.00804
Sonnet 5.5 $0.00000 $0.00402
Haiku 4.5 $0.00000 $0.00201

Measured 18d ago against content hash cdf5e42203fc, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

flows scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 18d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/flows.md · 117 lines

How it starts

The opening of the file, as written. The whole thing — 117 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/shiploop:flows

Defer to the workspace-local copy. If the current workspace has installed its own .claude/commands/flows.md (every scaffolded shiploop workspace does), follow THAT copy — it is pinned to the workspace's harness version and its scripts/govern/flows-*.sh helpers. This global copy is the fallback for a workspace that predates the flows feature; the playbook below is identical in shape, but always run the workspace's own scripts/govern/flows-*.sh, never a hub path.

Manage the flow registry (.claude/shiploop/validation/flows.md) — the git-tracked inventory of user-reachable paths through the product, each keyed by a stable id and pinned to the code SHAs it was last validated at. $ARGUMENTS selects the subcommand: extract · list · file <ids…|--all-stale|--all-untested>.

Load-bearing division of labor: the model (you) orchestrates and inventories; all registry writes go through the scripts/govern/flows-*.sh scripts (deterministic bash owns bookkeeping, under the same lock as the governor). You never hand-edit .claude/shiploop/validation/flows.md.

Run from the workspace root (main checkout or a worktree). First learn the layout: source scripts/lib/workspace.sh (for $REPOS, $GITHUB_ORG).


extract — inventory the flows (staged, operator-gated)

Build the combinatorial list of every user-facing path that might break — the paths a user might take through the product that could regress. This is the product's risk map, and a fresh extract is often an adopter's first taste of shiploop. Fan out with Agent across subagents, one per surface, so no single context has to hold the whole codebase:

  1. Enumerate the surfaces to inventory. Typically: every UI route/page, every API endpoint, every provider/integration matrix (a dimension that's enumerable — e.g. N providers × {deploy, feature-X, migration} — expands combinatorially into one flow id per cell), plus any snapshot/migration/backup paths. Use $REPOS to scope.
  2. Dispatch one subagent per surface (sized per the delegation table; the shipped investigator agent type fits most surfaces), each returning a list of proposed flow blocks in the registry grammar (## <id> + Kind / Surface / Paths / Status: UNTESTED; Gate for an effectiveness flow). Ids are lowercase dot-kebab, coarse→fine (deploy-gpu.vastai). Derive Paths: from the real imports/dependencies, not just the obvious feature dir — first segment of every glob MUST be a sub-repo folder name.
  3. Collect the subagents' blocks into ONE staged file, e.g. logs/investigations/flows-extract/staged.md (gitignored scratch — not the registry).
  4. Vet gate — merge is staged and operator-approved. Show the diff, then apply only on an explicit yes:
    scripts/govern/flows-extract-merge.sh logs/investigations/flows-extract/staged.md          # DRY: ADD / REFRESH / FLAGGED
    # …review the classification with the operator…
    scripts/govern/flows-extract-merge.sh logs/investigations/flows-extract/staged.md --approve # apply ADD + REFRESH
    
    The merge only adds new flows and refreshes Paths/Surface on existing ones. It never touches verdict state (Status/Validated/Disposition), and a Kind or Gate change on an existing id is FLAGGED, never auto-applied — a hallucinated or silently-reclassified flow must not become a fileable, later-billable row. Relay the flagged rows for a manual decision.

Read the full file on GitHub · 117 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 18d ago Changed cdf5e42203fc
  2. 1mo ago Changed · -1 lines 9d023aaedd7c
  3. 1mo ago Changed · +1 lines 4506c6130b3f
  4. 1mo ago Changed · +4 lines 6f548343516a
  5. 1mo ago Changed 4355344ceb8b
  6. 1mo ago First seen · 113 lines · 0 tokens per session scan A fbefc0cb1edd

Subscribe to this mod's changes

flows is a command published in the GitHub repository anshss/shiploop (9 stars, last pushed 12d ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 2,011 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.