workflow-reflection

workflow-reflection is a skill for Claude Code from Kastalien-Research/thoughtbox. It costs 33 tokens per session (1,370 once invoked), scanned A, original, MIT.

The final stage of a software development workflow, focused on recording lessons, moving temporary records, closing tracking issues, and preparing the branch for merging. A branch is a separate line of code changes.

In plain words
What is it for?
Use it to review the whole workflow, write a structured reflection, move architecture decisions, close issues, update claims, and prepare or mark the branch ready for merge.
Why use it?
It turns completed work into a clean, documented result and makes sure earlier workflow records and decisions are properly finalized.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: mentions subagents; installed under .agents/ (shared by several agents).

Good fit Use it to review the whole workflow, write a structured reflection, move architecture decisions, close issues, update claims, and prepare or mark the branch ready for merge.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/kastalien-research/thoughtbox/workflow-reflection
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.

Any agent
npx skills add Kastalien-Research/thoughtbox --skill workflow-reflection
Clone the repo
git clone --depth 1 https://github.com/Kastalien-Research/thoughtbox

Made for: Claude Code.

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.

agentmods badge for workflow-reflection

README.md
[![agentmods](https://agentmods.dev/badge/skills/kastalien-research/thoughtbox/workflow-reflection/github.svg)](https://agentmods.dev/skills/kastalien-research/thoughtbox/workflow-reflection)
Your own site
<a href="https://agentmods.dev/skills/kastalien-research/thoughtbox/workflow-reflection"><img src="https://agentmods.dev/badge/skills/kastalien-research/thoughtbox/workflow-reflection/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.

agentmods 80×15 button for workflow-reflection

Your own site · 80×15
<a href="https://agentmods.dev/skills/kastalien-research/thoughtbox/workflow-reflection"><img src="https://agentmods.dev/badge/skills/kastalien-research/thoughtbox/workflow-reflection.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,370 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. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.1 $0.00033 $0.01370
Opus 5.5 $0.00013 $0.00548
Sonnet 5.5 $0.00007 $0.00274
Haiku 4.5 $0.00003 $0.00137

Measured 1mo ago against content hash 9b6952b49100, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

workflow-reflection 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 1mo 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.

.agents/skills/workflow-reflection/SKILL.md · 185 lines

How it starts

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

Execute the reflection and finalization stage. $ARGUMENTS

Purpose

You are executing Stage 8 (Reflection) of the development workflow. The implementation is reviewed, revised, and compounded. Your job is to finalize: reflect on what happened, move artifacts to their permanent locations, close tracking issues, and prepare the branch for merge.

Pre-Conditions

Before starting, verify:

  1. .workflow/state.json exists and currentStage is "reflection"
  2. Stages 1-7 are all completed or skipped (check state file)
  3. All sub-agent work has been committed (no uncommitted implementation changes)

Process

Step 1: Agent Structured Reflection

Review the entire workflow by reading the state file and any persisted summaries. Produce a structured reflection:

WORKFLOW REFLECTION
====================

Workflow: <id> - <title>
Branch: <branch>
Duration: <startedAt> to now

## What Worked
- [specific things that went well, with evidence]
- [approaches that should be repeated]

## What Didn't Work
- [specific things that went poorly, with evidence]
- [approaches to avoid in future]

## Hypothesis Outcomes
- H1 "<text>": VALIDATED / REFUTED / INCONCLUSIVE
- H2 "<text>": ...

## Revision Iterations
- Total: N/3
- Root causes of revision: [what triggered each iteration]

## Unexpected Discoveries
- [things learned that weren't part of the original plan]
- [codebase behaviors that surprised us]

## Process Improvements
- [suggestions for improving the workflow itself]

Step 2: User Reflection (Optional)

Ask the user if they want to add their own reflection:

Would you like to add your own reflection notes?
This is optional but valuable for the compound learning record.

If the user provides input, append it to the reflection under a ## Chief Agentic Notes section.

Step 3: Move ADR to Permanent Location

Based on the workflow outcome:

If hypotheses were validated (happy path):

  1. Move the spec with frontmatter to accepted:
    # Historical: ADRs archived — update spec status in frontmatter instead of mv .adr/<NNN>-<name>-adr.md .adr/accepted/<NNN>-<name>.md
    
  2. Move associated summaries with it:
    # Historical: ADRs archived — update spec status in frontmatter instead of mv .adr/<NNN>-<name>-summary-*.md .adr/accepted/
    
  3. If the spec was in staging, move it to specs/
  4. If any existing docs in specs/ or docs/decisions/archive/adr/accepted/ are now outdated by this work, update them

Read the full file on GitHub · 185 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. 1mo ago First seen · 185 lines · 33 tokens per session scan A 9b6952b49100

Subscribe to this mod's changes

workflow-reflection is a skill published in the GitHub repository Kastalien-Research/thoughtbox (65 stars, last pushed 3mo ago), licensed MIT. It adds 33 tokens to every session and 1,370 once invoked, about $0.0001 per session on Opus 5.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

datalad

Retrieves, versions, and publishes scientific datasets with DataLad and git-annex, and captures computational provenance with datalad run, rerun, and containers-run. Use when cloning or fetching data from OpenNeuro, DANDI, datasets.datalad.org, or any DataLad dataset; when a file in a dataset reads as a broken symlink…

K-Dense-AI/scientific-agent-skills · 147 tokens

commit-context

Trace a file, function, or line back to the agent session that produced its current commit. Use when the user asks "why is this code here", "what was the agent doing when this changed", "who wrote this", or wants context on a specific location in the codebase.

rohitg00/agentmemory · 61 tokens

commit-history

List recent git commits linked to agent sessions, optionally filtered by branch or repo. Use when the user asks "show agent commits", "what has the agent shipped", "list linked commits", or wants commits with their session context.

rohitg00/agentmemory · 49 tokens

baby-sit

Monitor a GitHub pull request until CI is green, diagnose failures, and rerun only evidence-backed flaky GitHub Actions jobs.

langchain-ai/open-swe · 30 tokens

release-pr-review

Review pass on an open release PR (release/ → main) — the step between git-wrapup and release-and-publish when a project releases in gated release PR mode. Reads the PR's commit range through the code-simplifier lens plus a correctness review, verifies whatever an automated reviewer left on the PR, lands fixes as…

cyanheads/obsidian-mcp-server · 136 tokens

cyrus-setup-repository

Add one or more Git repositories to Cyrus configuration so it can process issues from those repos.

cyrusagents/cyrus · 25 tokens