@dyyz1993/pi-rules-engine

Rules engine plugin for pi coding agent. Supports both .claude/rules/ (Claude Code compatibility) and .pi/rules/ (PI native) directories.

Features

• Load rules from Markdown files with YAML frontmatter
• Glob pattern matching for conditional rules
• Three tools: rules_list, rules_reload, rules_check
• Command: /rules
• Auto-match rules when using read/grep/glob tools

Installation

npm install @dyyz1993/pi-rules-engine

Usage

Add to your pi extension config:

import rulesEngine from "@dyyz1993/pi-rules-engine";

export default {
  extensions: [rulesEngine],
};

Rule File Format

---
paths: src/**/*.ts, tests/**/*.ts
description: TypeScript coding standards
---

# TypeScript Rules

- Use explicit types over `any`
- Follow strict mode

API

Exported Functions

• parseFrontmatter(content) - Parse YAML frontmatter from markdown
• matchGlob(filePath, pattern) - Match file path against glob pattern
• parseRuleFile(filePath, content) - Parse a rule file
• loadRules(rulesDir) - Load all rules from a directory

Types

• RuleFrontmatter - Frontmatter interface
• ParsedRule - Parsed rule interface
• RuleCache - Rule cache interface