Rulesmith — Development skill for Claude Code
A minimal agent framework with ReAct loop, tool registry, sliding-window memory, human approval gate, and execution trace — built from scratch with Claude Code.
How to install Rulesmith
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open Atteraver/rulesmith and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Rulesmith does
A minimal agent framework with ReAct loop, tool registry, sliding-window memory, human approval gate, and execution trace — built from scratch with Claude Code. Includes RuleSmith: an example agent that finds gaps in IEP alert rulesets and proposes new rules.
Alternatives in Development
- Root Cause Tracing — Use when errors occur deep in execution and you need to trace back to find the original trigger 102.5k ★
- Claude Code Examples — Official example projects and patterns from Anthropic 35.6k ★
- Example Plugin — Reference implementation for plugin developers 14k ★
README
Agent Framework
A lightweight, reusable framework for building LLM agents: tool use, memory, and human-in-the-loop, with no orchestration library dependencies.
Problem Statement
IEP (Intelligent Event Processing) systems route events to automated actions via rules. Rules age badly: new event types may emerge, operational patterns shift, and some events may fall through, operators silently by handling unmatched events by hand: raising alerts, restarting services. Those interventions never turning into rules.
Finding these gaps requires three things happening together: knowing which event types consistently go unmatched, understanding how the ops team has historically responded to those events, and translating that pattern into a correctly-scoped rule. If done manually, this is a multi-step investigation across different data sources. Done wrong, it produces rules that are too broad (false positives) or too narrow (miss real incidents).
**RuleSmith solves this by acting as an analyst agent.** It is given a goal — *find events with no matching rule in the last 24 hours and suggest rules for them* — and it autonomously gathers the evidence, reasons over it, proposes a rule with a data-backed rationale, and then waits for human approval before writing anything to the system. The operator reviews one clearly-reasoned proposal rather than doing the investigation themselves.
Demo
[Watch the 5-minute demo](https://sap-my.sharepoint.com/:v:/p/ahad_abbas_rizvi/IQCYaZ7F7j2ES6L49rC8baS6AdALNKT5Q85jFHibmo0YPjg?e=9SMrVC)
What it does
The framework gives you a **free ReAct loop**: the LLM decides which tools to call, how many times, and in what order. You define tools with a decorator, hand them to an `Agent`, and call `agent.run(goal)`.
5 Capabilities
| Capability | Where | |
|---|---|---|
| 1 | Tool Registry — @registry.tool decorator turns any Python function into a callable tool with an auto-generated OpenAI schema |
Related Skills
Mini Agent Framework
A small, reusable, single-agent framework built from scratch in Python. It uses a bounded ReAct execution loop
Ix Debug
Root cause analysis — trace execution path to a failure, narrow candidates, read minimal source only at suspec
Notary
A black-box recorder and approval gate for any Claude skill. Tamper-evident, human-approved execution receipts
React Native Movie App
Get hands-on with React Native and Expo in this crash course! Build a mobile movie app from scratch, and learn
React Native Restate
Build a full-stack Real Estate app from scratch with Google Authentication, dynamic routing, and more. Master
Taste Blocks
Verified, source-backed React component registry for Taste Skill V2
Related Agents
Feature Build
Use when building a new feature from scratch. Chains search → plan → code → review → verify → learn in sequenc
Image Compositor
Produces images and videos for social posts with human-in-the-loop approval at every creative stage.
Approval Gate
HumanLayer-inspired approval gate. Enforces human-in-the-loop for HIGH-stakes operations. Classifies actions b