How does it prevent duplicate or conflicting rules?

It employs a 3-Check Protocol: it skips or merges items with high similarity, checks for cross-file antonyms between avoid and best-practice files, and ensures no data is duplicated from CLAUDE.md.

Where does the Brewcode Rules skill save project documentation?

The skill targets the local PROJECT .claude/rules/ directory exclusively. It specifically avoids modifying global user rules to ensure project-specific context remains isolated.

Can I use this to extract rules from my current terminal session?

Yes, by invoking the skill without arguments (Session Mode), it extracts the 5 most impactful findings from your current activity, including errors and fixes, and formats them into rules.

What file formats does it support for knowledge extraction?

It primarily parses KNOWLEDGE.jsonl files, identifying specific tags like '❌' for patterns to avoid and '✅' for practices to follow.

Brewcode Rules Manager

Name: Brewcode Rules Manager
Author: kochetkov-ma

bykochetkov-ma

•

Productivity & Workflow

Automates the synchronization and organization of project-specific rules, best practices, and anti-patterns within Claude Code.

Brewcode Rules is a sophisticated management system for project-specific instructions that ensures developer knowledge persists across sessions. It intelligently extracts learnings from active sessions, parses KNOWLEDGE.jsonl files, and organizes them into structured 'avoid' and 'best-practice' documents within the .claude/rules/ directory. By implementing a 3-check deduplication protocol that merges similar entries and flags antonyms, it maintains high-quality project documentation without redundancy, helping developers maintain consistent code quality and prevent the recurrence of solved bugs.

Key Features

01Automatic extraction of session learnings including errors, fixes, and patterns

02Automated organization of anti-patterns (avoid.md) and best practices (best-practice.md)

0316 GitHub stars

04Intelligent 3-check deduplication with similarity merging and cross-file validation

05Support for prefix-specific rule organization for complex project architectures

06Bidirectional sync between KNOWLEDGE.jsonl entries and project rules

Use Cases

01Cleaning up and deduplicating existing project rule files for better AI context

02Converting a team's shared knowledge base into actionable project rules

03Permanently capturing session-based bug fixes to prevent regression

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kochetkov-ma/claude-brewcode rules

For use in Claude.ai and ChatGPT

Download Skill