agent-rules

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 59 Open GitHub ↗

Rules and instructions for agentic coding tools like Cursor, Claude CLI, Gemini CLI, Qodo, Cline and more

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center"><h1 align="center">
  agent-rules
  </h1>
</p>

<p align="center">
  Rules and instructions for agentic coding tools like Cursor, GitHub Copilot, Claude CLI and Gemini CLI.
</p>

## Usage

### Interactive Mode

```bash
npx agent-rules
```

This will start an interactive session where you can select the AI app and topics.

#### Supported AI Apps

| AI App | Supported |
|--------|-----------|
| GitHub Copilot | ✅ |
| Cursor | ✅ |
| Claude CLI | ✅ |
| Gemini CLI | ✅ |

### Command Line Interface

You can also use command line flags to skip the interactive prompts:

```bash
# Generate rules for a specific AI app and topic
npx agent-rules --app cursor --topics secure-code

# Generate rules for multiple topics
npx agent-rules --app github-copilot --topics secure-code --topics testing

# Include MCP (Model Context Protocol) configuration
npx agent-rules --app github-copilot --topics testing --mcp

# Include custom commands (prompts)
npx agent-rules --app github-copilot --topics secure-code --commands

# Combine multiple features
npx agent-rules --app github-copilot --topics secure-code --mcp --commands

# Use short flags
npx agent-rules -a claude-code -t security-vulnerabilities -m -c

# Show help
npx agent-rules --help

# Show version
npx agent-rules --version
```

#### Available Options

**Flags:**
- `-a, --app <app>` - AI app to generate rules for
- `-t, --topics <topics>` - Topics to generate rules for (can be specified multiple times)
- `-m, --mcp` - Include MCP (Model Context Protocol) server configuration
- `-c, --commands` - Include custom commands/prompts
- `-h, --help` - Show help message
- `-v, --version` - Show version number

**AI Apps:**
- `github-copilot` - GitHub Copilot
- `cursor` - Cursor
- `claude-code` - Claude Code
- `gemini` - Gemini CLI

**Topics:**
- `secure-code` - Secure coding practices
- `security-vulnerabilities` - Security vulnerability scanning and fixes
- `testing` - Testing strategy and guidelines

## Features

### 📋 Instructions & Rules

Scaffold AI-specific coding instructions and best practices rules into your project:
- Security-focused coding practices
- Vulnerability detection and remediation
- Testing strategies and guidelines

### 🔌 MCP (Model Context Protocol) Configuration

Automatically configure MCP servers for enhanced agentic coding capabilities:
- **GitHub Copilot**: Configures `.vscode/mcp.json`
- **Gemini CLI**: Configures `.gemini/settings.json`
- Non-destructive merging with existing configurations

Learn more in the [MCP Feature Documentation](./docs/FEATURE-MCP.md).

### ⚡ Custom Commands & Prompts

Scaffold reusable commands and prompts for your AI coding assistant:
- **GitHub Copilot**: Deploys to `.github/prompts/` as prompt files
- Pre-built commands for common workflows (e.g., implementing GitHub issues)
- Easily extensible with your own custom commands

Learn more in the [Commands Feature Documentation](./docs/FEATURE-COMMANDS.md).

## Rules

Current category of rules available:

- Secure coding practices, based on Liran Tal's [Node.js Secure Coding](https://www.nodejs-security.com/)
- Security vulnerabilities, based on [Snyk.io](https://snyk.io/)
- Testing strategy and test code guidelines, built from [Yoni Goldberg's JavaScript Testing](https://github.com/goldbergyoni/javascript-testing-best-practices) and Liran Tal's testing strategy

## Documentation

- [Project documentation](./docs/README.md) - development, testing, architecture, and conventions.

## Contributing

Please consult [CONTRIBUTING](./CONTRIBUTING.md) for guidelines on contributing to this project.

## Author

agent-rules

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README