Luca Reflection Kit

luca-reflection-kit

Self-reflection and cross-session learning skills for Claude Code and Claude Cowork. Scan conversations for improvement points, mine recurring patterns across sessions, and get token-efficient optimization and workflow hints after high-tool-count turns.

Installation

Claude Code

Requires Claude Code.

1. /plugin marketplace add lucadellanna/luca-kit
2. /plugin install luca-reflection-kit@lucadellanna
3. Enable auto-updates: type /plugin, press Tab twice to open the Marketplaces tab, select luca-reflection-kit, and select Enable updates.
4. Run /luca-reflection-kit:luca-reflection-recommended-setup to configure session notes and privacy settings.

Claude Cowork

1. Left sidebar → Customize → Plugins → Personal → + → Add marketplace → lucadellanna/luca-kit
2. You will see all available luca-kit plugins; click + next to each one you want to install
3. Enable auto-updates: Browse Plugins → Personal → luca-reflection-kit → ··· → Sync automatically
4. Run /luca-reflection-kit:luca-reflection-recommended-setup to configure session notes and privacy settings.

To uninstall:

/plugin uninstall luca-reflection-kit@lucadellanna/luca-kit

Skills

Skill	What it does
reflect	After a session, two specialist reviewers surface insights with verbatim evidence: claude-side proposes concrete edits (clear low-risk memory entries are written automatically, everything else asks for your selection); user-side surfaces actionable recommendations for you (skills worth invoking next time, scoping techniques, workflow timing)
dream	Mines your /reflect session logs to surface patterns across sessions: recurring issues never fixed, memory contradictions, and improvements that keep coming up but never land
setup-context-search	(Power users) Installs qmd and configures it as an MCP server; after setup, /reflect and /dream use semantic search to detect conceptual overlaps when proposing new rules or skills. Requires Node.js 22+.

Agents

Spawned by skills in this plugin (you do not invoke them directly):

Agent	Used by	Mandate
claude-flow-reviewer	reflect	Reviews a conversation digest for Claude-side improvements: missed skill invocations, weak rule triggers, skill/rule/memory edits worth proposing
user-flow-reviewer	reflect	Surfaces up to 3 user-facing recommendations as Hints. Plain language, no coaching, nothing written to disk.

Hooks

Installed automatically with the plugin (no setup needed):

Hook	Event	What it does
optimization-hint	UserPromptSubmit	On every prompt, reminds Claude to append a one-sentence Optimization hint at the end of the current response if it involves 8+ tool calls (memory-worthy pattern / skill to edit or improve)
workflow-hint	UserPromptSubmit	On every prompt, reminds Claude to append a one-sentence Workflow hint at the end of the current response if it involves 8+ tool calls (skill to codify / user judgement or workflow to automate / friction to remove)
terms-acceptance-check	SessionStart	Reminds the user (via Claude) to run /luca-reflection-kit:accept-terms if no acknowledgment is recorded yet. Silent once acknowledged, and silent in non-interactive sessions (claude -p, agent SDK, CI).
consolidate-reflect-queue	PreToolUse	Before any claude-reflect skill runs in a Conductor workspace, merges queued learnings from all sibling workspace folders into the current one so /reflect sees the full history. No-op outside Conductor.

Commands

Command	What it does
/luca-reflection-kit:accept-terms	Shows the interim notice for Luca's plugins and records your decision locally. One-time per Claude install. No server calls.
/luca-reflection-kit:luca-reflection-recommended-setup	Configure session notes for /reflect. Decides once whether to save private logs to your computer.

License

Source-available, not open-source. You may inspect the repository and use it for personal evaluation. Commercial, client-facing, team, or organizational use requires a paid license. Contact Luca@Luca-Dellanna.com for more information.