Skill

brewcode:rules

Syncs KNOWLEDGE.jsonl or session learnings to project .claude/rules/ as best-practice.md and avoid.md. Use for updating rules, extracting learnings, organizing anti-patterns.

Bash

code-quality

automation

Install

npx claudepluginhub kochetkov-ma/claude-brewcode --plugin brewcode

Tool Access

This skill is limited to using the following tools:

ReadBashTask

Preview

> **TARGET:** Project `.claude/rules/` only. NEVER `~/.claude/rules/`

Supporting Assets

LICENSEREADME.mdscripts/rules.sh

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Parent Repo Stars17

Parent Repo Forks2

Last CommitMar 5, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

Input

Mode

list

List mode

<path> <text>

Prompt mode

<path-to-file>

File mode

(empty)

Session mode

Mode

Preparation

file

Read KNOWLEDGE.jsonl; parse t:"❌" → avoid, t:"✅" → practice

prompt

Extract <path> (first arg), <prompt> (rest)

session

Extract 5 most impactful findings: errors, fixes, patterns. Format as ❌ or ✅

Update PROJECT .claude/rules/ — NEVER ~/.claude/rules/ Plugin templates: $BC_PLUGIN_ROOT/templates/rules/ Validation: bash "$BC_PLUGIN_ROOT/skills/rules/scripts/rules.sh" validate Create missing: bash "$BC_PLUGIN_ROOT/skills/rules/scripts/rules.sh" create Targets: avoid.md, best-practice.md, {prefix}-avoid.md, {prefix}-best-practice.md MODE: {detected mode} KNOWLEDGE: {prepared from table above} DEDUP: 3-Check Protocol: 1. Within-file similarity (>70% skip, 40-70% merge) 2. Cross-file antonym (avoid↔best-practice — keep avoid only) 3. CLAUDE.md duplicate (skip if in CLAUDE.md; "CLAUDE.md" forbidden as Source)

Condition

Action

Agent unavailable

Error + install instructions

No knowledge found

"No new rules extracted"

Plugin not found

STOP + install instructions

TARGET: Project .claude/rules/ only. NEVER ~/.claude/rules/

Mode Detection

Arguments: $ARGUMENTS

Input	Mode
`list`	List mode
`<path> <text>`	Prompt mode
`<path-to-file>`	File mode
(empty)	Session mode

List Mode

EXECUTE and STOP:

bash "${CLAUDE_SKILL_DIR}/scripts/rules.sh" list

File / Prompt / Session Mode

Spawn bc-rules-organizer agent via Task tool.

Prepare Knowledge by Mode

Mode	Preparation
file	Read KNOWLEDGE.jsonl; parse `t:"❌"` → avoid, `t:"✅"` → practice
prompt	Extract `<path>` (first arg), `<prompt>` (rest)
session	Extract 5 most impactful findings: errors, fixes, patterns. Format as `❌` or `✅`

Agent Prompt Template

Update PROJECT .claude/rules/ — NEVER ~/.claude/rules/

Plugin templates: $BC_PLUGIN_ROOT/templates/rules/
Validation: bash "$BC_PLUGIN_ROOT/skills/rules/scripts/rules.sh" validate
Create missing: bash "$BC_PLUGIN_ROOT/skills/rules/scripts/rules.sh" create

Targets: avoid.md, best-practice.md, {prefix}-avoid.md, {prefix}-best-practice.md

MODE: {detected mode}
KNOWLEDGE: {prepared from table above}
DEDUP: 3-Check Protocol:
  1. Within-file similarity (>70% skip, 40-70% merge)
  2. Cross-file antonym (avoid↔best-practice — keep avoid only)
  3. CLAUDE.md duplicate (skip if in CLAUDE.md; "CLAUDE.md" forbidden as Source)

BC_PLUGIN_ROOT injected by pre-task.mjs hook.

Fallback

Agent unavailable → error: bc-rules-organizer not available — install brewcode plugin

Output

Forward agent report to user as-is.

Error Handling

Condition	Action
Agent unavailable	Error + install instructions
No knowledge found	"No new rules extracted"
Plugin not found	STOP + install instructions