plan

A planning command that turns a proposed gflow-cli feature into a written checklist of small implementation tasks. It records the feature plan in the project’s documentation.

In plain words
What is it for?
Use it after a feature proposal is approved, or whenever a backlog item needs to be broken into committable tasks before coding.
Why use it?
It removes the uncertainty of starting a larger feature without a clear order of work. The checklist also includes implementation and testing steps.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/ffroliva/gflow-cli/plan
Any agent
npx skills add ffroliva/gflow-cli --skill plan
Clone the repo
git clone --depth 1 https://github.com/ffroliva/gflow-cli

Made for: Claude Code, Codex.

Per session 89 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,873 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00089 $0.01873
Opus 5 $0.00044 $0.00937
Sonnet 5 $0.00018 $0.00375
Haiku 4.5 $0.00009 $0.00187

Measured 2d ago against content hash bbe187cb9af4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

plan 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 2d 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.

skills/plan/SKILL.md · 216 lines

How it starts

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

plan — Feature Plan Creator

Turns a feature description into a task-by-task implementation plan and writes it to docs/superpowers/plans/<YYYY-MM-DD>-<feature-slug>/PLAN.md.

Position in the gflow-cli workflow:

/gflow:predict <proposal>   →  GO / CAUTION / STOP verdict
/gflow:scenario <feature>   →  edge cases + BDD skeleton
/gflow:plan <feature>       →  writes the task checklist  ← this skill
/gflow:status               →  surfaces next task during execution
/gflow:check                →  before each commit

When to invoke

  • After /gflow:predict returns GO or CAUTION
  • When a backlog item in PLAN.md needs a concrete task breakdown before starting work
  • Any feature larger than a single isolated file change

When not to invoke

  • Simple bug fixes (< 10 lines, no boundary crossing) — go straight to the fix
  • Pure doc changes
  • A task already fully specified in a superpowers plan — use /gflow:status to find it

Protocol

Phase 1 — Gather inputs from context

From /gflow:predict output in context (do not ask if already present):

  • Verdict (GO / CAUTION) and confidence score
  • Architectural constraints and module placement
  • Security risks and mandatory mitigations
  • Devil's Advocate simplifications or sequencing blockers

From /gflow:scenario output in context (do not ask if already present):

  • Critical and High scenarios → these become must-cover tests in the task checklist
  • BDD Scenario: blocks → seeds the BDD scaffold task

From the feature description passed to this skill:

  • Feature name → derive a slug (lowercase, hyphen-separated, no dates)
  • Stated goal (one sentence)

From the repo — run once:

uv run python scripts/dev/active_plan.py

Note the active phase name and its open tasks. Then read PLAN.md § "Phase status" and § "Decision log" directly to verify the proposed feature is within current scope and does not contradict an existing ADR. (The script shows the current task, not a backlog index — use PLAN.md for scope confirmation.)

Read the full file on GitHub · 216 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. 2d ago First seen · 216 lines · 89 tokens per session scan A bbe187cb9af4

Subscribe to this mod's changes

plan is a skill published in the GitHub repository ffroliva/gflow-cli (136 stars, last pushed 2d ago), licensed MIT. It adds 89 tokens to every session and 1,873 once invoked, about $0.0004 per session on Opus 5. 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-30.

Related

Other skills, from other repositories

github-issue-triage

Issue triage and lifecycle management agent for ZeroClaw. Use this skill whenever the user wants to: triage open issues, close stale/duplicate/fixed issues, apply labels, run a backlog sweep, enforce the current issue stale policy, or handle a specific issue. Trigger on: 'triage issues', 'issue triage', 'sweep…

zeroclaw-labs/zeroclaw · 140 tokens

docs-planner

Identify documentation gaps and prioritize the docs backlog. Use when planning a docs improvement sprint, after signals surface repeated friction, when new SDK features ship without docs, or for periodic health assessment. Also triggers on "plan docs work", "what docs need writing", "prioritize the backlog", "docs…

strands-agents/harness-sdk · 73 tokens

team-workflow

Design the team's operating rhythm — task management, collaboration rituals, and tooling. Use when the day-to-day cadence needs structure. For a time-boxed sprint, use design-sprint-plan.

Owl-Listener/designer-skills · 43 tokens

design-sprint-plan

Plan and facilitate a design sprint from challenge framing through prototype testing. Use when compressing discovery into days. For ongoing team cadence, use team-workflow.

Owl-Listener/designer-skills · 37 tokens

Technical Debt Tracking with PMAT

Tracks and manages technical debt using PMAT (Pragmatic AI Labs MCP Agent Toolkit). Use this skill when: User asks about technical debt, TODO comments, or code quality issues Planning sprint work and need to prioritize debt repayment Conducting code audits or technical debt assessments Tracking debt accumulation…

paiml/paiml-mcp-agent-toolkit · 123 tokens

backlog

Capture single backlog items, or list and triage an existing project backlog. Use this skill whenever the user wants to file a bug, feature request, or backlog item without writing a full PRD, including casual requests mid-conversation like "create an issue for that", "add this to the backlog", or "file a quick bug…

sammcj/agentic-coding · 182 tokens