A project retrospective command that reviews a completed development cycle using task records, progress notes, design documents, and Git history.

Use it to compare planned work with what happened, identify delays or problems, and record improvements for future cycles.

It turns completed work into documented lessons instead of leaving the team to rely on memory. It also checks that the cycle is actually finished before reviewing it.

reflect — Command by Zenobia0000

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 commands/zenobia0000/cursor-agentic-coding-template/reflect

Clone the repo

git clone --depth 1 https://github.com/Zenobia0000/cursor-agentic-coding-template

Made for: Cursor.

Per session 18 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 1,253 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin 100% copy Near-identical to another mod 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.

Model	Per session	Once invoked
Fable 5	$0.00018	$0.01253
Opus 5	$0.00009	$0.00626
Sonnet 5	$0.00004	$0.00251
Haiku 4.5	$0.00002	$0.00125

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

Security

Grade A, and why

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

Origin

This is a copy

100% identical to reflect — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.cursor/commands/reflect.md · 72 lines

How it starts

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

🔍 REFLECT MODE (v3)

從已完成的工作中汲取經驗，提煉智慧，為未來的成功鋪路。

1. PLAN 🎯 (規劃)

Objective

對一個已完成的開發週期進行全面的、數據驅動的回顧，總結成果，反思過程，並將所有學習到的經驗寫入一份新的 memory-bank/current/reflection-[date].md 文件中，作為未來改進的基礎。

Guiding Rules

在執行此指令時，AI Agent 必須遵循以下規則：

主要規則: .cursor/rules/principles/global.mdc
流程改進: .cursor/rules/process/planning-process.md
核心隔離: .cursor/rules/isolation_rules/main.mdc

Prerequisites Check

在開始反思之前，請確保：

✅ 週期已結束: memory-bank/current/tasks.md 中絕大多數任務都已標記為 completed。
✅ 歷史記錄存在: memory-bank/current/progress.md 文件存在，並包含了本週期的開發日誌。
❌ Failure Action: 如果工作尚未完成，AI 必須拒絕反思，並建議：「看起來本週期還有未完成的任務。建議先完成它們再進行反思。」

2. DO 実行 (執行)

Core Process

遵循一個客觀、公正、面向未來的復盤框架：

Step 0: 健康檢查 (Health Check)

檢查拓撲完整性: 驗證 memory-bank/current/ 中的 tasks.md 和 progress.md 的數據是否完整且可以互相印證。
批判性思考: 反思的目的是為了改進，而非指責。AI 在分析時應採取中立的語氣。如果發現某個任務延遲嚴重，應客觀描述事實，並探討原因。

Step 1: 記憶體互動 - 讀取 (Memory Interaction - Read)

讀取所有相關記憶:
- memory-bank/current/tasks.md (規劃了什麼)
- memory-bank/current/progress.md (實際執行過程)
- memory-bank/current/creative-*.md (設計決策)
- git log (提交歷史)
綜合分析: 將上述所有資訊結合起來，建立一個關於本週期的完整畫像。

Step 2: 復盤分析 (Retrospective Analysis)

客觀總結 (What happened?): 總結完成了哪些主要功能，指標數據如何。
分析亮點 (What went well?): 識別流程中的成功實踐、高效決策。
分析痛點 (What could be improved?): 識別流程中的瓶頸、錯誤的估算、技術債。
提煉學習 (What did we learn?): 總結出可供未來直接使用的、可操作的經驗教訓。

Step 3: 記憶體互動 - 寫入 (Memory Interaction - Write)

創建反思報告: 將上述所有分析結果，寫入到一個新的 memory-bank/current/reflection-[date].md 文件中。
(可選) 更新任務列表: 如果在反思中識別出新的技術債務，可以更新 memory-bank/current/tasks.md，將這些技債作為下個週期的 PENDING 任務。

3. CHECK ✓ (檢查)

Verification Checklist

報告已生成: memory-bank/current/reflection-[date].md 是否已成功創建？
分析是否深入: 報告是否不僅僅是羅列事實，而是提供了對原因的深入分析？
學習是否可操作: 總結的經驗教訓是否具體、可衡量、可應用？

4. ACT 改善 (行動)

Finalization

與用戶互動: 在生成報告後，AI 可以主動向用戶提問，以獲取更深層次的見解。例如：「報告已生成。從您個人的角度來看，本次週期最大的挑戰是什麼？」
提交報告: 將最終的 reflection-[date].md 文件提交到版本控制系統。

Read the full file on GitHub · 72 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.

2d ago First seen · 72 lines · 18 tokens per session scan A 243291edbe03

Subscribe to this mod's changes

reflect is a command published in the GitHub repository Zenobia0000/cursor-agentic-coding-template (5 stars, last pushed 4mo ago), licensed MIT. It adds 18 tokens to every session and 1,253 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to reflect, differing in 0 lines, and is treated as a copy.

Git and workflow Learning and teaching Planning

reflect