To use Repository Rules, you must have Rules File Detection enabled in your settings. The same sync mechanism that detects IDE rule files also processes repository-based rules.

​
How to Use

You can create custom Kody Rules directly in your repository by placing structured markdown files in specific directories. This allows you to version control your rules alongside your code and share them across your team.

​
Synchronization

  • Automatic Detection: Repository rules are automatically detected and synchronized when enabled
  • Web Application: Synchronized rules appear in your Kodus web application dashboard
  • Real-time Updates: Changes to rule files are synced when Pull Requests are closed

​
File Location

Place your rule files in one of these directories:
  • .kody/rules/**/*.md
  • rules/**/*.md

​
Rule Template

Each rule file must follow this exact template structure: 
---
title: "<rule name>"
scope: "file"            # "file" or "pull_request"
path: []                 # list of globs. example: ["**/*.ts", "apps/web/**"]
severity_min: "high"     # "low", "medium", "high", "critical"
languages: []            # optional. ex: ["jsts", "go", "php", "ruby", "java", "csharp", "dart", "kotlin", "rust"]
buckets: []              # optional. ex: ["style-conventions", "error-handling", "security"]
uuid: ""                 # optional. use for stable rule ID
enabled: true            # optional
---

## Instructions
Describe what to review and how to decide. Be direct and objective.
- Focus on security, performance and public contract impacts.
- Give team preferences or patterns when applicable.
- If it's a PR rule, explain what to consider in the changeset.

## Examples

### Bad example
\`\`\`lang
// paste here a short counter-example that violates the rule
\`\`\`

### Good example  
\`\`\`lang
// paste here a short example that follows the rule
\`\`\`

​
Template Fields

​
Required Fields

FieldDescriptionValues
titleRule name displayed in the interfaceAny descriptive string
scopeRule analysis scope"file" or "pull_request"
pathFile paths where rule appliesArray of glob patterns
severity_minMinimum severity level"low", "medium", "high", "critical"

​
Example Rules

​
File-Level Rule Example

---
title: "Avoid console.log in production code"
scope: "file"
path: ["src/**/*.ts", "src/**/*.tsx"]
severity_min: "medium"
languages: ["jsts"]
buckets: ["style-conventions"]
enabled: true
---

## Instructions
Check for console.log statements in production TypeScript/JavaScript files.
- Console logs should not appear in production code
- Use proper logging libraries instead
- Allow console.log only in development utilities

## Examples

### Bad example
\`\`\`typescript
function processUser(user: User) {
  console.log('Processing user:', user.id);
  return user.process();
}
\`\`\`

### Good example
\`\`\`typescript
import { logger } from './logger';

function processUser(user: User) {
  logger.info('Processing user:', user.id);
  return user.process();
}
\`\`\`

​
Pull Request-Level Rule Example

---
title: "New API endpoints must have tests"
scope: "pull_request"
path: ["**/*"]
severity_min: "high"
buckets: ["testing"]
enabled: true
---

## Instructions
When new API endpoints are added, ensure corresponding tests are included in the PR.
- Check for new route definitions in controllers
- Verify test files exist for new endpoints
- Ensure both positive and negative test cases

## Examples

### Bad example
Added new endpoint `/api/users/profile` but no test file included in the PR.

### Good example
Added new endpoint `/api/users/profile` with corresponding test file `tests/api/users/profile.test.ts` that covers success and error cases.

​
Setup Requirements

To use Repository Rules, you need to:
  1. Enable Rules File Detection: Go to your settings and toggle “Auto-sync rules from repo”
  2. Create rule files: Place .md files in .kody/rules/** or rules/** directories
  3. Commit changes: Repository rules are detected when Pull Requests are closed
Repository Rules use the same synchronization mechanism as Rules File Detection. Once enabled, both IDE tool rules and repository rules will be automatically synced.