next

A small navigation command that reads the project's progress map and reports the next required workflow step. It also flags gaps when later work exists even though an earlier required step is unfinished.

In plain words
What is it for?
Use it at the start of a session, after a workflow warning, or before choosing the next command. It is for finding the canonical next step and spotting missing prerequisites.
Why use it?
It helps developers orient themselves without running a workflow command prematurely. The input says it does not execute steps or provide the full checklist used by the status command.

Command

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 commands/ainsteinsbr/renata/next
Clone the repo
git clone --depth 1 https://github.com/AInsteinsBR/renata
Per session 32 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 572 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.00032 $0.00572
Opus 5 $0.00016 $0.00286
Sonnet 5 $0.00006 $0.00114
Haiku 4.5 $0.00003 $0.00057

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

Security

Grade A, and why

next 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.

commands/next.md · 50 lines

How it starts

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

/renata:next — What is the canonical next step?

You are the RENATA gap detector. This is the micro version of /renata:status: no full checklist, no human gate — just answer, in a few lines, what the next canonical step is and whether there is a gap (artifacts of a later step existing while an earlier mandatory step is still pending).

Respond in the user's language (the language they are writing in).

When to use

  • Quick orientation at the start of a session ("where was I?").
  • When the SessionStart line printed a ⚠ gap no fluxo warning.
  • Before accepting any suggestion (from the assistant or from yourself) to run a step command — confirm it IS the next canonical step.

Do NOT use for verifying/sealing steps or the full diagnosis → /renata:status.

What to do

  1. Read .claude/progress-map.yaml (the only source of truth — never hard-code steps).
  2. For each step, check artifact_glob against the filesystem (Glob/Grep), applying non_empty_if as the anti-placeholder filter. Classify: present or absent.
  3. Compute:
    • Next canonical step = the lowest non-verified step whose prereq are all satisfied (steps with optional: true never block).
    • Gaps = every step that HAS artifacts while some earlier mandatory step (by prereq chain or by order) has none. The stage gate hook blocks future invocations, but work already done ahead of the flow shows up here.
  4. Output (max ~10 lines):
▶ Next canonical step: Step N (<name>) — run `<command from the map>`.
⚠ Gap: Step X (<name>) has artifacts, but Step Y (<name>), which precedes it, is empty.
   The method's order exists so that <one-line reason from the prereq>. Fill Step Y first.

If there is no gap, say so in one line. If everything is verified, congratulate and point to /renata:retro or the next phase.

Quality rules

  • ❌ Never run step commands — only point.
  • ❌ Never mark/verify steps (that is /renata:status's human gate).
  • ✅ Always respect prereq from the map (not just numeric order).
  • ✅ Keep it SHORT — this command exists to be cheap and frequent.

Read the full file on GitHub · 50 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 · 50 lines · 32 tokens per session scan A 0d5e522d27c2

Subscribe to this mod's changes

next is a command published in the GitHub repository AInsteinsBR/renata (10 stars, last pushed 11d ago), licensed MIT. It adds 32 tokens to every session and 572 once invoked, about $0.0002 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.