Skip to main content
Rules provide project-level or global instructions for Kombai. With rules, you can control Kombai’s behavior across your projects. For example, you can enforce specific coding standards, architectural patterns, and output formats.

​
Project rules

Project rules are stored in .kombai/rules. Monorepos can include separate ./kombai/rules directories for each project. Project rules allow you to enforce crucial project-specific instructions like naming conventions, folder structure, and internationalization. Examples of project rules:
  1. Generate new UI components only inside src/ui/components/ and route files only inside src/app/routes/.
  2. All visible text must be sourced from a translation system, not hard-coded strings.

​
User rules

User rules are global instructions defined in your system’s home directory (~/.kombai/rules/). They allow you to enforce instructions you want to apply across all your projects. Examples of user rules:
  1. Always respond in Turkish. Write all the texts and alt-texts used in the code in Turkish.
    Only the LLM responses will be in the specified language. The rest of the tool’s interface will remain in English.
  2. Use a default dark theme on all new components and pages.

​
Nesting in rules

Rules can be nested in the ./kombai/rules directory. This lets you organize the rules across multiple files and folders within the ./kombai/rules.

​
AGENTS.md

AGENTS.md is a rule file for AI agents. Use it as an alternative to .kombai/rules. It can be global or local to a project. Kombai automatically picks up the AGENTS.md file stored in the project. For global instructions, create an AGENTS.md file in your system’s home directory (~/AGENTS.md) and enter the path via Manage rules.

​
Manage rules

Rules can be managed through the Manage rules modal. Kombai automatically picks up any rule file stored in the project. You can also create or delete rules through Manage rules or add a path to your existing AGENTS.md file.

​
Create a rule

Manage rules supports the creation of Project rules or User rules. To create a rule:
  1. Launch Kombai extension in your IDE.
  2. Click the icon below the chat input box.
  3. Under Project Rules or User Rules, enter the name of the file you want to create.
  4. Click the icon.
  5. Click the Close button.

​
Delete a rule

Manage rules supports the deletion of Project rules or User rules. To delete a project rule:
  1. Launch Kombai extension in your IDE.
  2. Click below the input box.
  3. Under Project Rules, enter the name of the file you want to delete.
  4. Click the icon.
  5. Click the Close button.

​
Modify a rule

Manage rules supports the modification of all rule files. To modify a rule:
  1. Launch Kombai extension in your IDE.
  2. Click below the input box.
  3. Click besides the rule file that you want to modify.
  4. Edit the newly opened rule file.
  5. Save the file.

​
Add rule path

Rule path can be added for AGENTS.md or other rule files. Add the path to your global rule file stored in your system’s home directory. To add path to your rule file:
  1. Launch Kombai extension in your IDE.
  2. Click below the input box.
  3. Click Add your AGENTS.md or other rules.
  4. Enter the path to your rule file.
  5. Click the icon.
  6. Click the Close button.

​
Team rules

Team rules let you share and discover rules across your team. Publish your local rules for team members to use, or use rules shared by others.
You need to be part of the Team plan to use team rules.

​
Publish a rule

You can publish any local rule from your repo to your team. To publish a rule:
  1. Launch Kombai extension in your IDE.
  2. Click the icon below the chat input box.
  3. Go to the Team Rules tab.
  4. Under Publish Your Rules, select the local rule you want to publish from the dropdown.
  5. Click the Publish button.
The rule will now be available to all members of your team.
You must have local rules added in the Rules tab before you can publish them.

​
Discover and use team rules

The Team Rules section lists all rules published by members of your team. You can search for rules by name or author using the search bar at the top of the list.