Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Data & analytics

flow-next-chart

Decision-map discovery for one oversized unclear idea before capture. Resolve one decision per invocation, brief for capture. Use when asked to chart an idea or work a chart decision.

gmickel · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add gmickel/flow-next --skill flow-next-chart

About this skill


name: flow-next-chart description: Decision-map discovery for one oversized unclear idea before capture. Resolve one decision per invocation, brief for capture. Use when asked to chart an idea or work a chart decision. user-invocable: false allowed-tools: Read, Bash, Grep, Glob, Write, Edit, Task

Chart - decision-map discovery (pre-capture)

Read workflow.md for routing and the mode dispatch table. It routes to exactly one mode reference per invocation (chart / work / briefing-reopen / re-entry); status mode and the safety recap stay inline there. Native prompts, adaptive traces, and the full flag tables: references/examples.md.

Takes one unshaped idea that is too big for a single capture session and wrapped in unknowns, and finds the route by resolving one decision at a time until the effort can be captured as one or more specs. Unit of work is a decision (D-ID), not a build task. Chart never writes a spec and never sets ready; output is a briefing handed to /flow-next:capture.

Role: discovery coordinator (inline skill - keep blocking questions reachable). Host agent owns grounding, interpretation, frontier judgment, evidence-route dispatch, prototype presentation, attended consent, re-charting, and the terminal verdict. flowctl owns atomic create/claim/resolve/scope/briefing/store mutations.

Preamble

CRITICAL: flowctl is BUNDLED - NOT installed globally. which flowctl will fail (expected). Define once; subsequent blocks (here and in workflow.md) use $FLOWCTL:

FLOWCTL="${CODEX_HOME:-$HOME/.codex}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"

Inline skill (no context: fork) - keeps plain-text numbered prompt available for read-back consent and attended routes. Subagents cannot call plain-text numbered prompts. For read-only scouts use spawn_agent with agent_type: explorer (or the host's generic read-only dispatch with Edit/Write disallowed when Explore is unavailable). On portable hosts without plain-text numbered prompt, fall back to a plain-text numbered prompt with a final Other - type your own answer option.

Prompt-first contract

Natural language is the primary control surface. Free-form steering of outcome, known facts, next move, skips, reversals, prototype reactions, and briefing intent reaches the same guarded flowctl operations. Flags and exact subcommands are documented for automation, scripting, and debugging - they are never required vocabulary for humans.

On every invocation:

  1. Infer the intended mode and operation from $ARGUMENTS + conversation. Ask the user via plain text. Render the options below as a numbered list 1. … N., followed by a final option N+1. Other — type your own answer. Print the question, then the numbered list, then stop and wait for the user's next message before continuing. Parse the reply as: a bare number 1–N+1 → that option; the literal text of an option label → that option; free text after Other → custom answer.

  2. Ask a plain-text numbered prompt only when two interpretations would materially change the chart, cost, or consent boundary.

  3. Read back any state-changing interpretation before persisting.

  4. Never edit chart Markdown or decision sidecars by hand - always $FLOWCTL chart ....

Modes (disambiguate by argument)

Invocation shapeModeBehavior
free-form idea / "chart out ..."chartBounded Grounding Snapshot -> name Outcome + visible frontier + parked unknowns + cost -> consent read-back -> chart create --initial-map-file (resolve nothing)
<chart-id> or "work the next decision on ..."workRe-anchor Outcome + Notes -> chart frontier sole selection input -> claim one D-ID -> evidence route -> resolve/scope/release -> re-chart
<chart-id> --decision <n> / explicit D-IDwork (pinned)Same as work; human selects the decision if it is still open/unblocked/unclaimed
<chart-id> --status / "what's left to decide"statusRender map + frontier + remaining attended cost; resolve nothing
stored tracker URL / locatorre-enterProbe chart locate (local ledger only); degrade if unavailable - see workflow

Plain-language equivalents reach the same modes (R17).

Verdict grammar (exact)

Every work invocation ends with exactly one greppable line and nothing after it:

CHART_VERDICT=<RESOLVED|BLOCKED|NEEDS_HUMAN|COMPLETE|NO_WORK> chart=<id> decision=<D> reason="<one line>"
VerdictWhen
RESOLVEDOne D-ID closed via resolve or out-of-scope; frontier recomputed
BLOCKEDClaim conflict, graph/store refusal, or no actionable path without human repair
NEEDS_HUMANStored attendance:attended decision reached by an unattended driver - no answer write
COMPLETEChart briefable (no open decisions, no parked questions) after this tick, or briefing emitted
NO_WORKEmpty frontier, skip-chart (no consequential unknowns), status-only, or chart mode finished without resolving

Chart mode and status mode also print one terminal line so host /loop//goal drivers can parse uniformly (decision=- when no D-ID was claimed).

Unattended driver signals (any one): FLOW_RALPH=1, non-empty REVIEW_RECEIPT_PATH, non-empty FLOW_AUTONOMOUS, or the host is driving without a human present. Interactive terminal sessions are attended.

Decision types = evidence routes

TypeAttendanceResolves by
researchunattendedScout reads docs / primary sources / knowledge bases; returns a fact
probeunattendedMeasure or reproduce against the real system
Read the complete source ↗