
Iris Gotcha
Capture gotchas, architecture notes, and habits in a typed personal notebook so Claude Code recalls them and strengthens rules after repeat mistakes.
Overview
Iris Gotcha is a plugin marketplace for the Build phase that stores typed gotchas and lessons in Claude Code and recalls them with stronger rules after repeated violations.
What is this marketplace?
- Six strict categories: gotchas, rules, architecture, topology, habits, best practices, lessons learned
- Recall prior captures during later Claude Code sessions
- Rule-strengthening when the same violation repeats
- MIT-licensed iris-gotcha plugin (v0.11.0)
- Personal knowledge notebook positioning for long-horizon solo projects
- Marketplace bundles 1 plugin (iris-gotcha v0.11.0)
- License: MIT
- Metadata describes it as personal knowledge notebook for Claude Code
What problem does it solve?
Solo builders keep rediscovering the same agent mistakes and project quirks because lessons vanish between sessions and chats.
Who is it for?
Long-running solo Claude Code users who want durable gotchas, architecture memory, and habit enforcement without a separate PKM ritual.
Skip if: Teams needing shared Confluence-style docs, automated production monitoring, or non-Claude agent stacks without this marketplace.
What do I get? / Deliverables
After install, captures persist in six categories, surface when relevant, and repeat violations trigger strengthened rules instead of silent repeats.
- Persistent typed gotcha and lesson library tied to the agent
- Recalled context on related tasks in later sessions
- Escalated rules after documented repeat violations
Plugins in this marketplace
1 plugin — install individually after you add the marketplace.
Recommended Marketplaces
Journey fit
The marketplace is personal knowledge and agent memory for Claude Code—tooling that makes every coding session more consistent, anchored in Build’s agent-tooling shelf. Strict six-category typing and rule-strengthening are agent-session infrastructure, not shipping tests or growth analytics.
How it compares
Agent memory notebook marketplace, not cloud IaC or a React UI builder.
Common Questions / FAQ
Who is Iris Gotcha for?
Solo builders and power users of Claude Code who want a structured personal notebook for gotchas, rules, and architecture that the agent can recall.
When should I use Iris Gotcha?
Use it after you hit a recurring mistake or clarify architecture—any phase—so the lesson is typed, stored, and enforced on future sessions.
How do I add Iris Gotcha to my agent?
Add the danielwii/Iris Gotcha Claude Code marketplace and enable the Iris Gotcha plugin so capture and recall commands are available in your sessions.