What does the Build Insights Logger do?

It monitors your coding session for non-trivial decisions or discoveries and logs them into organized markdown files to preserve institutional knowledge.

Does it automatically update my CLAUDE.md file?

No, it uses a review process where it presents captured insights to you, allowing you to selectively choose which ones to promote to your CLAUDE.md file.

Does it log every small code change?

No, the skill is designed to ignore trivial changes like syntax fixes or boilerplate and focus on meaningful architectural, security, or performance decisions.

Can I manually trigger an insight log?

Yes, you can explicitly tell Claude to 'log this insight' or 'capture this learning' at any point during your conversation.

Where are the insights stored?

Insights are stored locally in your project under the `.claude/insights/` directory, with older sessions moved to an archive folder.

Build Insights Logger

Name: Build Insights Logger
Author: nathanonn

bynathanonn

•

Learning & Documentation

Captures and organizes architectural decisions, edge cases, and technical discoveries into a structured knowledge base during coding sessions.

Build Insights Logger is a specialized Claude Code skill designed to preserve institutional knowledge by systematically tracking the evolution of a codebase. It monitors development sessions for non-trivial discoveries—such as complex edge cases, design trade-offs, and security considerations—and logs them into organized session files within your repository. By facilitating a guided review process that selectively promotes key learnings to your CLAUDE.md file, it ensures that critical context and the rationale behind technical decisions are preserved for future development, making it an essential tool for long-term project maintenance and team collaboration.

Key Features

01Selective knowledge transfer to CLAUDE.md via user review

024 GitHub stars

03Contextual tagging for performance, security, and architecture

04Categorized tracking of design decisions and edge cases

05Automated session-based logging of technical discoveries

06Structured session archiving in .claude/insights/

Use Cases

01Building a project-specific knowledge base to improve team onboarding

02Tracking and explaining edge cases discovered during feature implementation

03Documenting complex architectural trade-offs during a major refactor

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nathanonn/claude-skill-build-insights-logger build-insights-logger

For use in Claude.ai and ChatGPT

Download Skill