backfill

A recovery command for FluencyLoop records that were missed because work was completed outside its normal workflow. It reconstructs the feature, session, decisions, knowledge, and architecture concepts from a merged code change.

In plain words
What is it for?
Use it after a merge to backfill FluencyLoop records from a diff and preserve what the change did and why.
Why use it?
It gives unrecorded work a durable explanation after the fact while marking reconstructed decisions as unverified.

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/baokhang83/fluencyloop/backfill
Any agent
npx skills add baokhang83/fluencyloop --skill backfill
Clone the repo
git clone --depth 1 https://github.com/baokhang83/fluencyloop

Made for: Claude Code, Codex.

Per session 86 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,976 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.00086 $0.02976
Opus 5 $0.00043 $0.01488
Sonnet 5 $0.00017 $0.00595
Haiku 4.5 $0.00009 $0.00298

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

Security

Grade A, and why

backfill 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 yesterday.

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.

claude-skills/backfill/SKILL.md · 233 lines

How it starts

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

/fluencyloop:backfill — reconstruct, make fluent, then flag

FluencyLoop never blocks a merge. The safety net for work that skipped the loop is post-merge backfill: it gives ad-hoc work a home retroactively. Backfilled rationale usually had no real-time teaching in FluencyLoop's format to force honesty, so it is the entry most at risk of plausible post-hoc fiction — which is why every backfilled entry is stamped trust: ⚠ unverified by default. It lands immediately and never asks for a confirmation; a contemporaneous record can strengthen the reconstruction without changing that default.

Backfill is not just bookkeeping. Its job is to recover the durable explanation of the components the work touched — the fluency the missing real-time loop never gave them. Record that explanation as the same feature, session, decision, knowledge, and concept records a live loop would write, while making uncertainty visible in the record rather than turning it into a conversation gate.

Bundled CLI (Claude Code)

Before invoking a deterministic command, use this plugin's bundled launcher: "${CLAUDE_PLUGIN_ROOT}/bin/fluencyloop" <arguments>. Every fluencyloop … command below means that exact Bash-tool command; it is never a chat instruction or a globally installed command.

Do not hand-scaffold .fluencyloop/, .claude/skills/, designs, sessions, state, or helper scripts. The bundled CLI creates the deterministic files and returns their paths.

Local site — open once

Before the first user-visible response, invoke "${CLAUDE_PLUGIN_ROOT}/bin/fluencyloop" site --ensure --open-once --json. This ensures the reader for every workflow entry, but opens a browser tab only once while that managed reader is alive. If it reports running: true and no earlier assistant message in this session starts with FluencyLoop site:, say FluencyLoop site: <url> (opened in browser). once, using its returned URL. Do not mention an unavailable site or repeat the announcement.

Generated prose — ASD-STE100

Read the full file on GitHub · 233 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. yesterday First seen · 233 lines · 86 tokens per session scan A eeee45978d22

Subscribe to this mod's changes

backfill is a skill published in the GitHub repository baokhang83/fluencyloop (44 stars, last pushed 16d ago), licensed Apache-2.0. It adds 86 tokens to every session and 2,976 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

add-community-extension

Add a community extension to the Spec Kit catalog from a GitHub issue submission. USE FOR: processing extension submission issues, validating catalog entries, updating catalog.community.json and docs/community/extensions.md, creating PRs. DO NOT USE FOR: creating new extensions from scratch, or first-party extension…

github/spec-kit · 63 tokens

openspec-verify-change

Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving.

Fission-AI/OpenSpec · 32 tokens

openspec-new-change

Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.

Fission-AI/OpenSpec · 40 tokens

agent-harness-fault-injection

Use when an agent workflow needs deterministic recovery evidence for sandbox, MCP/tool, worker, checkpoint, memory, or orchestration failures.

sickn33/agentic-awesome-skills · 34 tokens

ce-optimize

Run metric-driven optimization loops. Use when improving a measurable outcome through experiments.

EveryInc/compound-engineering-plugin · 19 tokens

ce-pov

Give a decisive, project-grounded point of view: a graded verdict on an external-adoption question, a holistic take on a document, or a position on a supplied approach set. Use for a solo POV. Use when asked to consult other models, reconcile their opinions, or oracle. Not for findings review (use ce-doc-review)…

EveryInc/compound-engineering-plugin · 92 tokens