steipete/agent-rulesArchived
Agent Rules
Agent-Rules is a structured system for defining how AI coding agents behave within software projects. It provides a framework of rules and knowledge files that shape an agent's interpretation of tasks and its interactions with code, serving as a configuration layer for agent behavior guidelines.
The system organizes rules as plain markdown files in a conventional directory structure, which agents read at startup. Rules are scoped to specific project directories, with a file-name convention that agents recognize and load automatically. A rule inheritance hierarchy allows project-specific instructions to merge with global defaults, creating layered configurations that adapt to different project contexts.
The knowledge base consists of static markdown documents that agents reference during task execution, embedding project conventions and best practices without dynamic generation. The project also includes governance rules for transferring an open-source project to a foundation structure, ensuring independent community stewardship.
Features
- Agent Behavioral Configuration - Defines rules and knowledge files that shape how an AI coding agent interprets tasks and interacts with code.
- AI Coding Agent Platforms - Defines rules and knowledge files that shape how an AI coding agent interprets tasks and interacts with code.
- Behavioral Guideline Configuration - Provides predefined instructions that shape an AI agent's operational behavior within a software project.
- Agent Instruction Formats - Uses Markdown with frontmatter metadata as a structured format for agent behavior instructions.
- Static Markdown Documentation - Embeds static markdown documents as a knowledge base that agents reference during task execution.
- Agent Knowledge Formats - Provides a structured set of knowledge files that inform AI agents about project conventions and best practices.
- AI Coding Assistant Rules - Provides curated rules and knowledge files that define how an AI coding agent interprets tasks and interacts with code.
- Markdown File Systems - Provides a structured markdown file system for organizing and loading agent behavior rules at startup.
- Agent File Conventions - Defines file naming conventions that agents recognize to automatically load behavior rules.
- Inherited Configurations - Implements hierarchical inheritance of agent rules from parent directories and global defaults.
- Agent Rule Scoping - Organizes agent rules in directory-scoped subdirectories for automatic context-specific loading.
