The starting procedure for a new need in a software design workflow called SDD, or specification-driven development. It prepares the environment, checks required command-line tools, resolves a name, and hands the work to the next stage.

Use it when starting a new item through the waterfall workflow. It checks Bash, agent teams, and jq before continuing.

It catches missing prerequisites before the workflow begins, such as Bash, jq, or the required experimental agent-team setting. It also provides a defined entry point for starting a new need.

wf-new — Skill for Claude Code by mgallet92i

Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code

/plugin marketplace add mgallet92i/waterfall

Claude Code

/plugin install waterfall

Made for: Claude Code.

Or install waterfall, the plugin that ships this one along with the rest of its 6 skills, 3 commands, 8 agents, 1 hook.

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/mgallet92i/waterfall/wf-new/github.svg)](https://agentmods.dev/skills/mgallet92i/waterfall/wf-new)

Your own site

<a href="https://agentmods.dev/skills/mgallet92i/waterfall/wf-new"><img src="https://agentmods.dev/badge/skills/mgallet92i/waterfall/wf-new/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/mgallet92i/waterfall/wf-new"><img src="https://agentmods.dev/badge/skills/mgallet92i/waterfall/wf-new.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 25 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 4,404 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.

Model	Per session	Once invoked
Fable 5.1	$0.00025	$0.04404
Opus 5	$0.00013	$0.02202
Sonnet 5	$0.00005	$0.00881
Haiku 4.5	$0.00003	$0.00440

Measured 9d ago against content hash ce63c6285cc3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

wf-new 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 9d 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/wf-new/SKILL.md · 320 lines

How it starts

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

wf-new — Bootstrap a new need

This skill is the entry point of the waterfall workflow for a new need. It is invoked by the /waterfall:new slash command. Its sole role: prepare the environment, resolve the name, and hand off to OR.

Flow Z — Bootstrap Agent Teams

Step 1 — Preflight

bash ${CLAUDE_PLUGIN_ROOT}/scripts/wf-check-bash.sh

If exit ≠ 0: display the error to HO and stop. The plugin requires bash (Git Bash on Windows).

bash ${CLAUDE_PLUGIN_ROOT}/scripts/wf-check-teams.sh

If exit ≠ 0: display the error to HO and stop. The flag CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is required (see README.md Prerequisites).

Step 1.bis — jq verification

jq is used by all wf scripts to parse .wf-state.json, .team-registry.json, etc.

INSTALL_CMD=$(bash ${CLAUDE_PLUGIN_ROOT}/scripts/wf-check-jq.sh) || JQ_RC=$?

Exit 0 → continue.
Exit 2 → jq missing. $INSTALL_CMD contains the install command adapted to the detected OS (empty if no known package manager).
- If INSTALL_CMD non-empty → AskUserQuestion: "jq is required. Install it now via ${INSTALL_CMD}?" (Yes / No).
  - Yes → bash -c "$INSTALL_CMD" then re-run wf-check-jq.sh. If still missing → display stderr and stop.
  - No → display the command to HO for manual install and stop.
- If INSTALL_CMD empty → display stderr (manual instructions + URL) and stop.

Step 2 — Name resolution

The name is resolved by PM (main conversation) before any spawn — PM has the fresh verbal context from HO.

If $ARGUMENTS provided → validate kebab-case, use directly as <name>
If $ARGUMENTS empty: a. AskUserQuestion (open question): "Describe your need in a few words." b. Generate 3 kebab-case proposals (2-4 words, semantically relevant) c. AskUserQuestion with the 3 options (HO can also enter a free-form name) d. Validate the chosen name: strict kebab-case
Check non-collision: ls wf/needs/<name>/ → if it exists, AskUserQuestion to confirm overwrite or pick another name

Read the full file on GitHub · 320 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.

9d ago First seen · 320 lines · 25 tokens per session scan A ce63c6285cc3

Subscribe to this mod's changes

wf-new is a skill published in the GitHub repository mgallet92i/waterfall (2 stars, last pushed 1mo ago), licensed MIT. It adds 25 tokens to every session and 4,404 once invoked, about $0.0001 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-31.

Claude Code Planning agent-framework agentic claude claude-ai claude-code-plugin

plan

Use this skill at the START of every coding task — new builds, bug fixes, and change requests. Classifies the work item, validates it against project scope, produces a high-level estimate, proposes a technology stack, and checks stack compatibility. Writes a plan artifact to .claude/sdlc/plans/ that every downstream…

lantisprime/claude-sdlc · 130 tokens

start

Use this skill when the user runs /start, says "start", "enable the SDLC workflow", "I want to build", "I want to fix", "set up", "get started", or otherwise signals they want to activate or re-enable the SDLC workflow. Handles three distinct paths based on marker state — fresh install (opt-in activation), re-enable…

lantisprime/claude-sdlc · 107 tokens

domain-expert

Use this skill during /plan (between scope validation and writing the plan artifact) to inject domain-specific context, gap questions, and regulatory concerns into the plan. Triggers automatically when the plan skill evaluates the task and scope.md against the domain registry in domains/index.json using semantic…

lantisprime/claude-sdlc · 70 tokens

configure

Use this skill when the user runs /configure, /configure --needs, or /configure --check. Also auto-invoked by env-detect.sh on fresh install (Layer 0) and by skills that find required config missing at runtime (Layer 2). Guides setup of config/tools.json and config/tools.local.json through a question bank; handles…

lantisprime/claude-sdlc · 88 tokens

status

Use this skill when the user asks "where am I", "what's the current task", "what's blocking me", "show status", "what needs sign-off", or "what's next". Prints a snapshot of the active plan, gate, sign-off progress, and next action. Reads only — writes nothing.

lantisprime/claude-sdlc · 67 tokens

analyze

Use this skill after Phase 1 Plan to create or intake requirements for a task. Produces requirements with stable IDs (REQ-001, REQ-002, ...), validates each requirement against the project's scope statement, and — critically — halts and asks for UX designs and brand guidelines whenever the work touches a frontend or…

lantisprime/claude-sdlc · 111 tokens