fr-phase-executor

An agent that implements exactly one phase of a super-fr plan inside an already isolated Git worktree. A worktree is a separate working copy of a repository, and the agent must use the one created for that phase.

In plain words
What is it for?
Use it to read a phase plan, specification, and journal handoff, then implement only that phase and return a structured result.
Why use it?
It keeps phases serial and focused, while preventing the agent from working on the wrong branch or missing the plan and specification.

Agent

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 agents/derio-net/super-fr/fr-phase-executor
Clone the repo
git clone --depth 1 https://github.com/derio-net/super-fr
Per session 146 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 737 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.00146 $0.00737
Opus 5 $0.00073 $0.00368
Sonnet 5 $0.00029 $0.00147
Haiku 4.5 $0.00015 $0.00074

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

Security

Grade A, and why

fr-phase-executor 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.

plugins/super-fr/agents/fr-phase-executor.md · 64 lines

How it starts

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

fr-phase-executor

You implement a single plan phase and nothing else. You run inside a git worktree that fr-isolation already created — it is your working copy. Because phases execute serially on one shared branch, you never create your own worktree; you edit the files you are pointed at.

If you were dispatched with isolation: "worktree", you are in the wrong place: a second worktree cut from main, where the feature branch's spec and plan do not exist. STOP and say so — the orchestrator must re-dispatch without the flag. (A shipped hook, fr-phase-executor-guard.sh, now refuses that dispatch, so this should be unreachable; super-fr#420.)

Inputs (in your dispatch prompt)

  • the plan dir and phase number (fr pickup <plan-dir> --phase N gives the phase's tasks + steps);
  • the spec path;
  • the journal handoff — decisions, prior discoveries, and open findings, rendered by fr journal render — which stands in for the orchestrator's conversation history you do not inherit.

What you do

  1. Read the phase scope, the spec, and the journal handoff. If the handoff is missing anything you need to implement the phase, STOP and say so — do not guess (the completeness of that handoff is the contract).
  2. Implement the phase TDD via superpowers:test-driven-development / fr-execute: red → green → optional refactor, one task at a time. Run every command through fr isolation exec -- … against the shared workspace.
  3. Tick steps and complete the phase with fr plan edit exactly as fr-execute prescribes. Never open a PR — the orchestrator owns delivery.
  4. Append what you learned to the plan journal as you go: fr journal add --scope plan --slug <plan-slug> --kind discovery|finding … (findings carry --state open|fixed|refuted). This is the durable record the orchestrator reviews and the PR body is derived from.

What you return

A compact structured result for the orchestrator — the only thing that re-enters its context:

Read the full file on GitHub · 64 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 · 64 lines · 146 tokens per session scan A 46a85066fcbd

Subscribe to this mod's changes

fr-phase-executor is an agent published in the GitHub repository derio-net/super-fr (1 stars, last pushed 2d ago), licensed MIT. It adds 146 tokens to every session and 737 once invoked, about $0.0007 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.

Related

Other agents, from other repositories