Agent Prompts and Rules

A collection of comprehensive prompts and rules designed to make interactions with Claude Code and other coding agents more productive, consistent, and enjoyable.

Overview

This repository contains battle-tested methodologies, guidelines, and rules that establish clear patterns for AI-assisted development. Each rule file is self-contained and focuses on a specific aspect of the development process.

Rule Files

Core Development Rules

• TDD.md - Test-Driven Development methodology following Kent Beck's principles

  • Red → Green → Refactor cycle
  • Tidy First approach separating structural from behavioral changes
  • Commit discipline and code quality standards
  • Originally by Kent Beck's Augmented Coding: Beyond the Vibes

• ERRORS.md - Error handling standards using the Result pattern

  • No try-catch blocks in application logic
  • Comprehensive neverthrow library usage and examples
  • Functional error handling patterns

• DOCUMENTATION.md - Documentation standards and preferences

  • Comprehensive JSDoc for all public methods and files
  • No inline comments - rely on clear naming and readable code
  • Self-documenting code practices

Project Management

• PROJECT.md - Agent operation modes and memory bank system
  • Plan/Act dual-mode workflow with clear transitions
  • Structured memory bank for maintaining project context
  • Documentation hierarchy and update workflows
  • Project intelligence capture through .cursor/rules
  • Originally by Ryosuke Suzuki's Cline Memory Bank Feature

Usage

Each rule file can be:

1. Referenced directly when working with coding agents
2. Used as system prompts for consistent behavior
3. Adapted to specific project needs while maintaining core principles
4. Combined with other rule files for comprehensive development workflows

File Structure

├── README.md              # This overview
├── CLAUDE.md              # Claude Code specific instructions
├── TDD.md                 # Test-Driven Development rules
├── ERRORS.md              # Error handling with Result pattern
├── DOCUMENTATION.md       # Documentation standards
├── PROJECT.md             # Agent workflow and memory bank system
└── LICENSE                # MIT License

Getting Started

1. Choose the relevant rule files for your project type
2. Reference them in your coding agent interactions
3. Follow the established patterns and methodologies
4. Adapt and extend the rules as your project evolves

Contributing

This is a personal collection of development rules and patterns. Feel free to fork and adapt for your own use cases.

License

MIT License - see LICENSE for details.