claude-skills/productivity/reflect/README.md
Claude 7405298b4b
fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885)
- #954: strip non-spec source/attribution keys from all 39 plugin.json
  manifests so Claude Code's validator accepts them; metadata preserved in
  new .claude-plugin/authoring-notes.json sidecars; check_plugin_json.py now
  hard-fails manifests carrying those keys and sanity-checks the sidecar;
  CLAUDE.md ClawHub schema section updated to the new rule.
- #949: move the c-level-agents plugin out of c-level-advisor/ to a
  top-level directory so the two marketplace sources no longer overlap;
  updated marketplace.json source, homepage, descriptions, all
  cross-references, docs, harness manifest, mirror-tree symlinks/indexes,
  and rebased the moved files' relative links; domain counters trued up
  (18 -> 19 domains).
- #933: replace dead links to the gitignored maintainer-local megaprompts/
  tree with annotated plain-text references (44 files: SKILL.md, READMEs,
  agents, commands).
- #931: DynamoDB on-demand pricing updated to post-Nov-2024 rates
  ($0.625/M writes, $0.125/M strongly consistent reads).
- #969: skill_security_auditor.py and the three dossier scripts reconfigure
  stdout/stderr to UTF-8 (errors=replace) so legacy Windows codepages no
  longer crash at print time; PYTHONUTF8=1 documented.
- #968: Windows Notes section in INSTALLATION.md + README pointer for the
  core.symlinks mirror-tree checkout caveat.
- #924/#885 residuals: hook commands quote "${CLAUDE_PLUGIN_ROOT}" paths in
  all plugin hooks.json/settings.json (space-safe roots); removed the stale
  pre-rename status/review mirror symlinks and index entries left over from
  the memory-status/memory-review rename.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
2026-08-21 05:47:37 +00:00

57 lines
3.1 KiB
Markdown

# reflect
Mid-conversation reflection skill. Pauses execution and **zooms out from detail-mode** to honestly reassess direction, assumptions, and bias.
## What this skill does
When invoked mid-conversation (explicitly or via implicit signals like 10+ turns deep on details without strategic check-in), the skill:
1. **Halts the current thread** and re-reads the full conversation from the original goal forward — not just recent turns
2. Runs the **5-dimension analysis framework**:
- **Macro Perspective** — original goal vs current direction; drift detection
- **Gap Analysis** — unverified assumptions, missing stakeholders, skipped constraints, dismissed alternatives
- **Reflective Inquiry** — is the problem framed correctly? Right problem vs adjacent easier one? Simpler path overcomplicated? Harder valuable path avoided?
- **Bias Check** — confirmation / sunk cost / anchoring / complexity / recency
- **Contextual Alignment** — does direction serve actual goals + best use of time + external factors honored
3. Delivers **flowing prose** (no headers, conversational tone)
4. Ends with a **clear directional recommendation**: Continue / Pivot / Pause
## Sibling skill relationship
Productivity sibling of `capture` (Slice 1). Both share light-prompt-flow shape, max-1-question intake, fast-to-action discipline. Different mode: `capture` organizes external dumps; `reflect` re-examines internal conversation state.
## Honest-output discipline
The skill explicitly does NOT manufacture problems when things are on track. "This is solid because X" is a valid output. **Vague reassurance ("looks good!") is rejected** — when the path is solid, the skill states specific reasoning for why; when the path needs correction, the skill states specific evidence from the conversation.
## Source spec
`megaprompts/02-reflect-megaprompt.md` (maintainer-local draft spec — gitignored, not in the public repo) (PR #657).
## Plugin layout
```
productivity/reflect/
├── .claude-plugin/plugin.json
├── README.md
├── agents/cs-reflect.md ← reflection persona, honest-output enforcer
├── commands/cs-reflect.md ← /cs:reflect (or auto-triggers on phrases)
└── skills/reflect/
├── SKILL.md
├── references/
│ ├── cognitive_bias_canon.md ← 5 biases + recognition cues (7+ sources)
│ ├── honest_output_discipline.md ← anti-manufactured-problems (7+ sources)
│ └── conversation_reflection_practice.md ← Schön reflective practice canon (7+ sources)
└── scripts/
├── bias_pattern_detector.py ← stdlib: regex scan for 5-bias signals in conversation
├── conversation_depth_analyzer.py ← stdlib: turn count + implicit-trigger signal detection
└── directional_recommendation_validator.py ← stdlib: verify output ends with Continue/Pivot/Pause
```
## Dependencies
**None.** Pure-reasoning skill — most portable in the v2 collection. Works in Claude Code CLI + Claude.ai web natively.
## License
MIT.