mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-09 03:17:54 +00:00
ea94a78bac
Review follow-up on PR #972: docs/plugins/index.md still described the old "two approved extension fields in plugin.json" policy reversed by #954 — rewritten to point at .claude-plugin/authoring-notes.json and the CI hard-fail. 32 generated docs pages still linked the gitignored megaprompts/ tree via absolute GitHub URLs (404s); converted to the same annotated plain-text form used in the source files. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
121 lines
4.8 KiB
Markdown
121 lines
4.8 KiB
Markdown
---
|
|
title: "/cs-reflect — Slash Command for AI Coding Agents"
|
|
description: "/cs:reflect — Mid-conversation reflection: halts current thread, re-reads full conversation from original goal forward, runs 5-dimension analysis. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
|
---
|
|
|
|
# /cs-reflect
|
|
|
|
<div class="page-meta" markdown>
|
|
<span class="meta-badge">:material-console: Slash Command</span>
|
|
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/2-claude-skills/tree/main/productivity/reflect/commands/cs-reflect.md">Source</a></span>
|
|
</div>
|
|
|
|
|
|
**Command:** `/cs:reflect`
|
|
|
|
The `cs-reflect` persona pauses execution and honestly reassesses where the conversation has been heading.
|
|
|
|
## When to Run
|
|
|
|
- Conversation has gone 10+ turns deep on implementation details without strategic check-in
|
|
- Repeated dead-ends or pivots within a short span
|
|
- You suspect the framing has drifted from the original goal
|
|
- You want a bias check before committing to next steps
|
|
- Pre-decision sanity check on a substantive direction change
|
|
|
|
## When NOT to Run
|
|
|
|
- Quick lookups or factual questions
|
|
- Conversations <5 turns deep (not enough to reflect on)
|
|
- Mid-task when you just need execution, not reassessment
|
|
|
|
## What You Get
|
|
|
|
A flowing-prose reassessment covering:
|
|
|
|
1. **Macro Perspective** — original goal vs current direction; drift detection
|
|
2. **Gap Analysis** — unverified assumptions, missing stakeholders, skipped constraints, dismissed alternatives
|
|
3. **Reflective Inquiry** — right problem vs adjacent easier one? Simpler path overcomplicated? Harder valuable path avoided?
|
|
4. **Bias Check** — confirmation / sunk cost / anchoring / complexity / recency
|
|
5. **Contextual Alignment** — does direction serve goals + best use of time
|
|
|
|
Closing with **one of three recommendations**:
|
|
|
|
- **Continue** — and why (specific evidence)
|
|
- **Pivot to {direction}** — and what to drop
|
|
- **Pause for {question}** — and which question to answer first
|
|
|
|
## Trigger Phrases (auto-invoke without /cs:)
|
|
|
|
**Explicit:**
|
|
- "reflect"
|
|
- "take a step back" / "step back"
|
|
- "zoom out"
|
|
- "are we missing something"
|
|
- "bigger picture"
|
|
- "what are we missing"
|
|
- "let's pause"
|
|
- "sanity check this"
|
|
- "are we on track"
|
|
- "are we overthinking this"
|
|
- "forest for the trees"
|
|
|
|
**Implicit (no phrase needed):**
|
|
- 10+ turns of implementation detail without strategic check-in
|
|
- User shows signs of frustration or stuck-ness
|
|
- Repeated dead-ends or pivots within a short span
|
|
|
|
## Discipline
|
|
|
|
- **Re-read FULL conversation** — from original goal forward, not just recent turns
|
|
- **Honest output** — no manufactured problems when path is solid; specific reasoning when validating
|
|
- **Flowing prose** — no headers, no bullet lists
|
|
- **Specific evidence** — anchor every observation to specific conversation moments
|
|
- **Closing recommendation mandatory** — Continue / Pivot / Pause every time
|
|
- **Low-intake** — max 1 optional clarifier (only when context is too thin)
|
|
- **No name references** — generic second-person throughout
|
|
|
|
## Workflow
|
|
|
|
```bash
|
|
# When triggered, the skill:
|
|
# 1. Halts current thread (no continuation of the in-progress task)
|
|
# 2. Re-reads full conversation from original goal
|
|
# 3. Runs 5-dimension analysis in head
|
|
# 4. Delivers flowing-prose reassessment
|
|
|
|
# Optional pre-flight: scan for bias patterns + depth signals
|
|
python ../skills/reflect/scripts/conversation_depth_analyzer.py --conversation /tmp/transcript.txt
|
|
python ../skills/reflect/scripts/bias_pattern_detector.py --conversation /tmp/transcript.txt
|
|
|
|
# Post-flight: validate output meets discipline
|
|
python ../skills/reflect/scripts/directional_recommendation_validator.py --output /tmp/output.txt
|
|
```
|
|
|
|
## Stop Conditions
|
|
|
|
- Reflection complete + closing recommendation delivered → done
|
|
- Context too thin → 1 clarifying question, then run
|
|
- User says "stop reflecting" → drop back to task immediately
|
|
|
|
## Anti-Patterns Rejected
|
|
|
|
- Hardcoded user names or specific domain references
|
|
- Structured-report output (headers, bullets) when prose is required
|
|
- Manufactured problems when things are actually fine
|
|
- Vague reassurance ("looks good!") instead of specific reasoning
|
|
- Reassessing only recent turns instead of the full conversation
|
|
- Skipping the closing directional recommendation
|
|
|
|
## Related
|
|
|
|
- Agent: [`cs-reflect`](https://github.com/alirezarezvani/claude-skills/tree/main/productivity/reflect/agents/cs-reflect.md)
|
|
- Skill: [`reflect`](https://github.com/alirezarezvani/claude-skills/tree/main/productivity/reflect/skills/reflect/SKILL.md)
|
|
- Source spec: `megaprompts/02-reflect-megaprompt.md` (maintainer-local draft spec — gitignored, not in the public repo)
|
|
- Sibling: `/cs:capture` (productivity, brain-dump organizer)
|
|
- Adjacent (different shape): `/cs:grill-me`, `/cs:grill-with-docs`
|
|
|
|
---
|
|
|
|
**Version:** 1.0.0
|
|
**Source:** Path-B direct conversion of `megaprompts/02-reflect-megaprompt.md`
|