xp-harness: Skill for Claude Code

.apm/skills/retrospective/SKILL.md

retrospective is a skill for Claude Code, Codex from sei-newbear/xp-harness. It costs 114 tokens per session (3,353 once invoked), scanned A, original, MIT.

A retrospective skill guides a review of completed work to identify improvements and record them in project rules or procedures. A retrospective is a structured look back at what happened and what should change next time.

In plain words
What is it for?
It is for reviewing finished stories or a completed work session, finding process improvements, and recording agreed changes.
Why use it?
It helps preserve lessons that an agent might otherwise lose between sessions and separates observed facts from guesses.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions CLAUDE.md; mentions subagents.

This is sei-newbear/xp-harness's own configuration. It tells Claude Code and Codex how to work on xp-harness itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything xp-harness configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sei-newbear/xp-harness. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sei-newbear/xp-harness/main/.apm/skills/retrospective/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/sei-newbear/xp-harness

Made for: Claude Code, Codex.

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 retrospective

README.md
[![agentmods](https://agentmods.dev/badge/skills/sei-newbear/xp-harness/retrospective.svg)](https://agentmods.dev/skills/sei-newbear/xp-harness/retrospective)
Your own site
<a href="https://agentmods.dev/skills/sei-newbear/xp-harness/retrospective"><img src="https://agentmods.dev/badge/skills/sei-newbear/xp-harness/retrospective.svg" alt="Measured on agentmods" height="20"></a>
Per session 114 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,353 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.
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.00114 $0.03353
Opus 5 $0.00057 $0.01677
Sonnet 5 $0.00023 $0.00671
Haiku 4.5 $0.00011 $0.00335

Measured 7d ago against content hash cea8ce84719e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

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

.apm/skills/retrospective/SKILL.md · 126 lines

How it starts

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

ふりかえり skill

なぜこの skill があるか

作業中に気付く改善点を、気付いた時に拾えるサイクルが回っていないと、改善が言語化されないまま流れていく。気づきを引き出して、改善案や取り決めへ書き戻すべき知識・手順を残すまでがこの skill の責務。改善実装そのものは別 skill / 人間判断に委ねる (= 「気づきを出して残す場」であって「直す場」ではない)。

コーディングエージェントのふりかえりでは、人間のふりかえりと違って次の 3 つが効く。これがこの skill の作りを決めている:

  • 学びが人に残らない: エージェントは学びを次セッションに持ち越せない。気づきを取り決め (skill / subagent / CLAUDE.md・ルール) に書き戻さないと、改善は次までに消える。残す先は人の記憶でなく取り決め。
  • 自己分析は捏造されやすい: エージェントは「もっともらしい因果」を後付けで作る。だから正直さの監査が要る。
  • 対象は「働き方」: エージェントの働き方は取り決めに刻まれている。表面の出来事でなく、取り決めの挙動を見る。

通底する構え (流れの全段に効く)

進行は対話駆動で dialogue-principles skill のルールに従う。以下は特定の Step でなく、ふりかえり全体を通じて効かせる構え。

  • 責任追及でなく改善の場: このふりかえりは main session (= コーディングエージェント) を責めるためのものではなく、今後の改善のためにやる。だから失敗・抜け・迷いを正直に出してよい (= 隠さず出すほど価値がある)。下の「正直さ」はこの前提があって初めて成り立つ。
  • 正直さ: 自己分析は、後付けで「もっともらしい因果連鎖」を捏造しやすい (= 実際に起きる失敗モード)。出す前に点検する:
    • 検証できる事実 (会話履歴・成果物・実行結果に残るもの) と推測を分けて書く
    • 内部状態に基づく主張 (「〜と思っていた」「〜のつもりだった」) は推測と明示し、かつ 自分で正直に出す。依頼者に当てさせない (= 内省は main session にしかできない。依頼者は外側から事実・論理の整合をチェックする役)
    • 綺麗に揃いすぎた因果図は捏造のサインとして疑う (= 都合よく一本道に見えるときほど、別の要因を潰せていない)
    • 発火・タイミングなど挙動の主張が改善の判断を左右するときは、自分の語りを信じず記録で裏を取る (= 毎回見る儀式にはしない、判断に効くときだけ)。記憶 (= context に残る会話) は使えるが、序盤はやり取りが圧縮され、発火の語りには捏造が混じりうる、という 2 つの穴を前提に扱う
  • 共創・発散と収束: 一方的に完成形を出さず、認識を揃えながら共同で作る。発散 (候補を短く 1 行で並べる) と 収束 (1 つを選んで深掘りする) を 1 つの出力に混ぜない (= 混ぜると議論観点が積み上がって認知負荷が上がる)。
  • 既存フレームワーク (KPT / YWT / Fun-Done-Learn 等) は採用しない: 対話駆動の独自プロセスで足りる。型を持ち込むと Step 間の責務 (= 観測 / 深掘り / アクション) が混ざる。

流れ

skill が呼ばれたら以下を順に回す。各段で上の「構え」を効かせる。

観測

「よかった点 / 伸びしろ」を出す (発散なので短く並べる、深掘りは後段)。main session が先に会話履歴・観察からリストを出し、依頼者が追加 / 削除 / 修正する (= 依頼者は main session の出力に引きずられず、自分の実感を優先して書き換えてよい)。軸は基本「よかった点 / 伸びしろ」の 2 軸、依頼者が「KPT で」「3 軸で」等と指示してきたら柔軟に変える。

表面の出来事だけでなく、働き方を規定する取り決め (skill / subagent / CLAUDE.md・ルール) が適切に働いたか を必ず見る (= エージェントの働き方はそこに刻まれているので、見ないと表面の伸びしろしか拾えない)。観測の幅と深さ:

  • 利用可能だった skill / subagent / ルールを 一通り当てる (= 1 件見つけて止めない、都合のいい 1 件で満足しない)
  • 表面の出来事を 「skill / ルールを呼んだ・呼ばなかった挙動」として捉える (= 「先走った」でなく「define-requirements を呼ばなかった」と書く)。当てる観点: 明示的に発火・起動したもの / 「必ず発火」と書かれているのに発火しなかったもの / 呼ぶべきタイミングで呼ばなかったもの / 順序・タイミングのミス / 暗黙適用で済ませたもの / CLAUDE.md・ルールがその場面を導けたか
  • 発火の有無だけでなく、関係する skill / subagent / CLAUDE.md・ルールの中身 (本文) まで読む。呼んだものも、呼ぶべきだったのに呼ばなかったものも。中身がその場面を適切に導けたか / 薄くて導けなかったかを見る (= 直す対象が「発火のさせ方」なのか「中身の不足」なのかを切り分けられる)
  • ハーネスの発火だけで見ない。ハーネスに絡まない純粋な推論ミス・良い振る舞いも拾う。よかった点は 「取り決めに宿って再現する」か「偶然救われた」か を見分ける (= 偶然の良い点は「次は再現しない」ので、それ自体が伸びしろ。安定化はアクションで取り決めに書き戻す)

Read the full file on GitHub · 126 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. 7d ago First seen · 126 lines · 114 tokens per session scan A cea8ce84719e

Subscribe to this mod's changes

retrospective is a skill published in the GitHub repository sei-newbear/xp-harness (9 stars, last pushed 1mo ago), licensed MIT. It adds 114 tokens to every session and 3,353 once invoked, about $0.0006 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

recipe-create-meet-space

Create a Google Meet meeting space and share the join link.

googleworkspace/cli · 18 tokens

atmos-config

Atmos root configuration: atmos.yaml discovery, precedence, deep merging, basepath, imports, minimal bootstrap, and routing to narrower Atmos skills.

cloudposse/atmos · 31 tokens

workthreads

SpecStory Workthreads - a weekly work-thread rollup across a team's repos from SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more). It groups the window's sessions into threads of work per project and labels each new / open / recently closed, so a lead sees what shipped, what is still…

specstoryai/getspecstory · 126 tokens

story-readiness

Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes, clear acceptance criteria, and no open design questions. Produces READY / NEEDS WORK / BLOCKED verdict with specific gaps. Use when user says 'is this story ready', 'can I start on this story', 'is…

Donchitos/Claude-Code-Game-Studios · 77 tokens

autotask-creator

Rules for automation CRUD from the group-chat commander. The commander does not call mutation tools and does not edit cloud/autotasks files directly. It emits one or more top-level ... containers in its final text; the bus parses and applies them after the turn.

Orkas-AI/Orkas · 5 tokens

monorepo-management

Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management. Use when setting up monorepos, optimizing builds, or managing shared dependencies.

wshobson/agents · 54 tokens