cycle-retrospective

cycle-retrospective is a skill for Claude Code, Codex from morodomi/dev-crew. It costs 97 tokens per session (868 once invoked), scanned A, original, MIT.

A Japanese-language retrospective step for a TDD cycle. TDD, or test-driven development, is a method of writing a failing test first, making it pass, and then improving the code.

In plain words
What is it for?
It is for extracting reusable lessons from a completed TDD cycle, recording cases with no lesson, and handling extraction failures with retries or a user decision.
Why use it?
It records the link between the first failure, the final fix, and the reusable lesson, while preventing the review from running before the cycle reaches an allowed later stage.

Skill for Claude CodeCodex

Part of the dev-crew plugin — 29 skills, 41 agents, 3 hooks shipped together

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/morodomi/dev-crew/cycle-retrospective
Any agent
npx skills add morodomi/dev-crew --skill cycle-retrospective
Clone the repo
git clone --depth 1 https://github.com/morodomi/dev-crew

Made for: Claude Code, Codex.

Or install dev-crew, the plugin that ships this one along with the rest of its 29 skills, 41 agents, 3 hooks.

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 cycle-retrospective

README.md
[![agentmods](https://agentmods.dev/badge/skills/morodomi/dev-crew/cycle-retrospective.svg)](https://agentmods.dev/skills/morodomi/dev-crew/cycle-retrospective)
Your own site
<a href="https://agentmods.dev/skills/morodomi/dev-crew/cycle-retrospective"><img src="https://agentmods.dev/badge/skills/morodomi/dev-crew/cycle-retrospective.svg" alt="Measured on agentmods" height="20"></a>
Per session 97 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 868 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.00097 $0.00868
Opus 5 $0.00048 $0.00434
Sonnet 5 $0.00019 $0.00174
Haiku 4.5 $0.00010 $0.00087

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

Security

Grade A, and why

cycle-retrospective 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 4d 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/cycle-retrospective/SKILL.md · 43 lines

What it actually says

cycle-retrospective

Workflow

Hard Gate

  1. Cycle doc 存在: 不在 → BLOCK: 「先に spec/orchestrate を実行してください」
  2. Phase 制約 (Codex P2-1 対応、mid-cycle 実行で A2b inline 呼び出しの順序が永続破壊されるのを防ぐ): phase が REVIEW / COMMIT / DONE のいずれかのみ許可。INIT / KICKOFF / RED / GREEN / REFACTOR → BLOCK: 「cycle-retrospective は REVIEW phase 以降で実行してください (現 phase: $phase)」

Idempotency Check

  • frontmatter retro_statusnone 以外 (captured / resolved / フィールド不在) → skip + 「既に処理済み (retro_status: $value)」を出力して exit 0
  • retro_status: none の場合のみ抽出フェーズへ進む

Extraction (LLM)

  • Cycle doc 全体を読む (plan / phase summaries / review verdicts / test failures / retry log / DISCOVERED)
  • Failure → Final fix → Insight ペアを抽出 (詳細手順: reference.md)
  • 想起漏れ設問を評価: 今回の手戻りは過去のどの cycle doc を最初に読んでいれば防げたか(該当なし可、reference.md の ### 想起漏れ スキーマで記録)
  • 抽出 0 件 (no reusable lesson) — 抽出は成功したが再利用可能な知見が見つからないケース (Codex P2-2 対応): 通常 exit path、Retrospective に No reusable lesson this cycle を記録して retro_status: resolved に遷移 (user intervention 不要、AskUserQuestion も実行しない)
  • 抽出エラー (LLM error / parse error) — LLM 実行自体が失敗したケース: retry N=2 → 全失敗時は AskUserQuestion で override (proceed / abort)。no-lesson path と混同しない

Output (Cycle doc 更新)

state-ownership.md の cycle-retrospective 行に従う:

  • Body: ## Retrospective を Cycle doc EOF (## Next Steps の後) に append (APPEND-ONLY 遵守、middle-insert 禁止、既存内容は一切変更しない)
  • 想起漏れ記録: 全正常終了経路(通常テンプレート / no-lesson / override-proceed)で ### 想起漏れ を記録する。abort(ファイル非変更)のみ対象外
  • frontmatter: retro_status (none → captured / none → resolved) と updated のみ更新
    • captured: 有効な insight を追記した場合
    • resolved: no-lesson / override-proceed (Extraction skipped by override または Extraction failed after N retries) の場合
  • abort 選択時: Cycle doc は変更せず、stderr に「Retrospective aborted by user. orchestrate should BLOCK commit.」を出力して exit 1

Reference

詳細: reference.md

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 4d ago First seen · 43 lines · 97 tokens per session scan A c2aba52e4f76

Subscribe to this mod's changes

cycle-retrospective is a skill published in the GitHub repository morodomi/dev-crew (1 stars, last pushed today), licensed MIT. It adds 97 tokens to every session and 868 once invoked, about $0.0005 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 skills, from other repositories

skill-tdd

Build features with tests-before-code rigor — use for new features needing test coverage.

nyldn/claude-octopus · 19 tokens

tdd

Guides test-driven development — decomposes a feature or bug fix into testable behaviors, then runs Red-Green-Refactor cycles with a failing test before every implementation. Auto-detects specs from docs/specs/ or docs/jira/, creates a feature branch (optional worktree), commits per cycle, and pushes. Recommends…

oprogramadorreal/optimus-claude · 90 tokens

auto-loop

TDD-based autonomous development loop with checkpoint recovery and observability changelog.

claude-world/director-mode-lite · 17 tokens

workflow

Run the complete 5-step development workflow: focus problem → prevent over-development → test-first (TDD) → document → smart commit. Use when starting a new feature, or when the user runs /workflow or asks for the full development flow.

claude-world/director-mode-lite · 52 tokens

test-first

Drive one feature through a strict TDD Red-Green-Refactor cycle with checklists for each phase. Use when implementing new functionality test-first, or when the user runs /test-first.

claude-world/director-mode-lite · 42 tokens

plan-create

Create structured implementation plans for autonomous TDD development. Use for new features, multi-file changes, or anything requiring multiple steps or tests. Triggers on aspirational openers ("let's build", "let's start building", "I want to make", "I want an app that", "help me build"), capability lists ("users…

markshust/hcf · 171 tokens