Build Insights Logger

Build Insights Logger Skill for Claude Code

A Claude Code plugin marketplace providing automatic logging of meaningful insights, discoveries, and decisions during coding sessions.

Overview

This marketplace contains a specialized skill that automatically captures non-trivial learnings about edge cases, design decisions, patterns, and implementation details during development. The skill logs insights to session files in .claude/insights/ and helps transfer valuable learnings to CLAUDE.md for long-term institutional knowledge preservation.

Installation

To add this marketplace to your Claude Code installation:

/plugin marketplace add nathanonn/claude-skill-build-insights-logger

After adding the marketplace, the build-insights-logger skill will be available for installation and will automatically activate when building complex code where institutional knowledge should be preserved.

Available Plugins

build-insights-logger

Type: Project Skill (Managed)

Description: Automatically log meaningful insights, discoveries, and decisions during coding sessions to preserve institutional knowledge and track codebase evolution.

Features:

• Automatic logging of insights during complex implementations
• Captures non-trivial learnings about:
  • Edge cases and unexpected behaviors
  • Design decisions and architectural trade-offs
  • Performance and security considerations
  • API design patterns and state management
  • Testing strategies and error handling approaches
• Session-based logging to .claude/insights/ directory
• Interactive review workflow for selecting insights to preserve
• Transfer valuable learnings to CLAUDE.md
• Archive completed sessions for historical reference

When It Activates:

The skill automatically activates when:

• Working on complex implementations with non-trivial design decisions
• Discovering edge cases or unexpected behaviors
• Making architectural or performance trade-offs
• Implementing security-sensitive features
• Building features where institutional knowledge matters

Usage

Once installed, the skill works in two phases:

1. Automatic Logging

During development, Claude will automatically log insights as they're discovered:

📝 Logged insight about null handling in API responses
📝 Logged insight about performance optimization in data loading
📝 Logged insight about state management pattern selection

Insights are logged to timestamped session files in .claude/insights/session-YYYY-MM-DD-HHMMSS.md

2. Review & Selection

When you're ready to preserve key learnings, ask Claude to review:

• "Review insights" - See all insights from the current session
• "Show me what we learned" - Review and select insights to add to CLAUDE.md
• "Summarize insights" - Get an overview of captured learnings

Claude will present insights grouped by category, and you can select which ones to transfer to CLAUDE.md for permanent reference.

Prerequisites

• Claude Code CLI installed and configured
• No additional dependencies required

Repository Structure

.claude/
└── skills/
    └── build-insights-logger/
        └── SKILL.md              # Skill definition and complete documentation

Development

To test this marketplace locally:

/plugin marketplace add ./path/to/claude-skill-build-insights-logger

Support

For issues, questions, or contributions, please visit:

• Repository: https://github.com/nathanonn/claude-skill-build-insights-logger
• Contact: hello@nathanonn.com

License

MIT License - see LICENSE file for details

About Build Insights Logger

Build Insights Logger helps development teams capture and preserve institutional knowledge that would otherwise be lost. By automatically logging meaningful discoveries and decisions during coding sessions, it creates a living history of why the codebase evolved the way it did - making onboarding easier, preventing repeated mistakes, and preserving valuable context for future developers.