Commit graph

2 commits

Author SHA1 Message Date
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
Claude
7bdc98e517
feat(productivity): reflect skill — Path-B light-prompt-flow sibling of capture
Slice 8: productivity light-prompt-flow sibling. Same shape as capture
(11 files, max-1-question intake, fast-to-action), different mode —
capture organizes external dumps; reflect re-examines internal
conversation state.

After this merges: 10 of 13 v2 megaprompts shipped.

SOURCE SPEC

megaprompts/02-reflect-megaprompt.md (PR #657).

WHAT THE SKILL DOES

Mid-conversation reflection. Pauses execution, re-reads the FULL
conversation from original goal forward (not just recent turns),
runs the 5-dimension analysis framework:
  - Macro Perspective (original goal vs current; drift detection)
  - Gap Analysis (assumptions / stakeholders / constraints /
    alternatives / external factors)
  - Reflective Inquiry (right problem? simpler path? harder valuable
    path avoided?)
  - Bias Check (confirmation / sunk cost / anchoring / complexity /
    recency — each with recognition cues)
  - Contextual Alignment (does direction serve actual goals + best
    use of time + external factors)

Delivers flowing prose (NO headers, NO bullets). Ends with mandatory
directional recommendation: Continue / Pivot to {X} / Pause for {Q}.

KEY PATH-B PRESERVED ELEMENTS

- Re-read FULL conversation from original goal (not just recent turns)
  — the discipline that distinguishes real reflection from local
  summary
- Halt-current-thread stop directive (reflection is a pause, not a
  side-quest)
- Honest-output discipline: NO manufactured problems when path is
  solid; NO vague reassurance ("looks good!") instead of specific
  reasoning
- 5-dimension framework preserved verbatim
- 5 biases preserved (confirmation, sunk cost, anchoring, complexity,
  recency) with recognition cues
- Flowing prose enforced (no headers, no bullets in body)
- Closing recommendation mandatory (Continue / Pivot to X / Pause
  for Q)
- Low-intake: max 1 optional clarifier (only when context is thin);
  default to no questions
- No name references (generic second-person throughout)
- Implicit triggers OFFER reflection, never auto-invoke (10+ detail
  turns / frustration / dead-ends → ask user if they want to step
  back, don't unilaterally run)

PURE-REASONING SKILL

No external APIs. No DOCX generation. No file-system writes beyond
audit. Most portable v2 skill — works in Claude Code CLI + Claude.ai
web natively, no MCP dependencies, no Node.js, no Consensus account
required.

REPO STRUCTURE (mirrors capture 1:1)

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: Tversky/Kahneman,
    │                                          Wason, Arkes/Blumer,
    │                                          Russo/Schoemaker, Tetlock,
    │                                          Karpathy)
    │   ├── honest_output_discipline.md     ← anti-manufactured-problems
    │                                          (7 sources: Yegge, Gawande,
    │                                          Deming, Russell, Kim Scott,
    │                                          Bret Victor, skill spec)
    │   └── conversation_reflection_practice.md ← Schön reflective practice
    │                                          (7 sources: Schön 1983 + 1987,
    │                                          Argyris/Schön, Kolb, Polanyi,
    │                                          Kahneman/Tversky, Victor)
    └── scripts/
        ├── bias_pattern_detector.py        ← stdlib: regex scan for 5-bias
        │                                     signal patterns
        ├── conversation_depth_analyzer.py  ← stdlib: turn count + implicit
        │                                     trigger signal detection
        └── directional_recommendation_validator.py  ← stdlib: verify output
                                              ends with Continue/Pivot/Pause +
                                              specific evidence + flowing prose

11 files, 1,554 lines. Comparable to capture (1,560 lines).

VERIFIED CLEAN

All 3 scripts pass smoke tests:

- bias_pattern_detector --sample (notification system + sunk cost +
  anchoring + complexity scenario): correctly detects 3 biases
  (sunk_cost via "we've invested", anchoring via "sticking with",
  complexity via 9 "what about X" hits). Correctly clears confirmation
  + recency (no strong signals).
- conversation_depth_analyzer --sample (19-turn debugging conversation
  with stuck-ness markers): correctly verdicts OFFER_REFLECT based on
  frustration (8 hits) + dead-ends (4 hits). Note: "skill should OFFER
  reflection, not auto-invoke" — honors design intent.
- directional_recommendation_validator --sample-pass (honest validation
  output with 16 specific-evidence references): PASS 6/6.
- directional_recommendation_validator --sample-fail (vague
  reassurance with bullets, no recommendation, no evidence): FAIL with
  4 specific issues caught (missing closing recommendation, 2 vague
  phrases, 3 bullets, 0 specific-evidence refs).

All 3 with --output json: valid JSON.
plugin.json validates.

VERTICAL-SLICE STATUS

  ✓ Slice 1: capture (PR #659)
  ✓ Slice 2: pulse (PR #660)
  ✓ Slice 3: email pair (PR #661)
  ✓ Slice 4: landing (PR #662)
  ✓ Slice 5 batch 1: litreview (PR #663)
  ✓ Slice 5 batch 2: grants + dossier (PR #664)
  ✓ Slice 5 batch 3: patent + syllabus (PR #666)
  ✓ Cleanup PR: move pulse + capture (PR #667)
  ✓ Slice 8: reflect (this PR)
  ☐ Slice 6: notebooklm (browser-automation, last shape)
  ☐ Slice 7: 13-research orchestrator + autoresearch-agent reconciliation

10 of 13 v2 megaprompts shipped after this merge. 3 remaining:
notebooklm (browser-automation), 13-research (orchestrator), then v2
is complete.

NOT DONE IN THIS PR (intentional)

- .claude-plugin/marketplace.json not updated (separate concern;
  done after all 13 ship)
- .codex/skills/reflect symlink not added (auto-sync workflow handles
  on merge per existing pattern)

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-16 05:37:30 +00:00