Skip to content
This repository was archived by the owner on Feb 25, 2026. It is now read-only.

docs: update mode-specific custom instruction file guidance #477

Merged
olearycrew merged 2 commits into from
Feb 21, 2026
Merged

docs: update mode-specific custom instruction file guidance #477

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
db43f2b
docs: update mode-specific custom instruction file guidance
Olusammytee Feb 19, 2026
eef24bb
Merge branch 'dev' into docs/2154-update-custom-instruction-files-docs
olearycrew Feb 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions packages/kilo-docs/pages/customize/custom-instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Custom Instructions are IDE-wide and are applied across all workspaces and maint

{% image src="/docs/img/custom-instructions/custom-instructions.png" alt="Kilo Code Modes tab showing global custom instructions interface" width="600" caption="Kilo Code Modes tab showing global custom instructions interface" /%}

1. **Open Modes Tab:** Click the <Codicon name="organization" /> icon in the Kilo Code top menu bar
1. **Open Modes Tab:** Click the <Codicon name="notebook" /> icon in the Kilo Code top menu bar
2. **Find Section:** Find the "Custom Instructions for All Modes" section
3. **Enter Instructions:** Enter your instructions in the text area
4. **Save Changes:** Click "Done" to save your changes
Expand All @@ -31,7 +31,7 @@ Custom Instructions are IDE-wide and are applied across all workspaces and maint
Mode-specific instructions can be set using the Modes Tab

{% image src="/docs/img/custom-instructions/custom-instructions-3.png" alt="Kilo Code Modes tab showing mode-specific custom instructions interface" width="600" caption="Kilo Code Modes tab showing mode-specific custom instructions interface" /%}
* **Open Tab:** Click the <Codicon name="organization" /> icon in the Kilo Code top menu bar
* **Open Tab:** Click the <Codicon name="notebook" /> icon in the Kilo Code top menu bar
* **Select Mode:** Under the Modes heading, click the button for the mode you want to customize
* **Enter Instructions:** Enter your instructions in the text area under "Mode-specific Custom Instructions (optional)"
* **Save Changes:** Click "Done" to save your changes
Comment on lines 33 to 37
Copy link

Copilot AI Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The mode-specific instructions UI steps are indented by 4 spaces, which in CommonMark/Docusaurus Markdown renders as an indented code block. That will likely cause the {% image ... %} and the * bullet list to display as code rather than as an image + list. Consider removing the leading indentation (or nesting it under an actual list item) so the content renders correctly.

Copilot uses AI. Check for mistakes.
Expand All @@ -40,6 +40,17 @@ Mode-specific instructions can be set using the Modes Tab
If the mode itself is global (not workspace-specific), any custom instructions you set for it will also apply globally for that mode across all workspaces.
{% /callout %}

## Mode-Specific Instructions from Files

For version-controlled mode instructions, use the mode rules file paths documented in [Custom Modes](/docs/customize/custom-modes#mode-specific-instructions-via-filesdirectories):

- Preferred: `.kilo/rules-{mode-slug}/` (directory)
- Fallback: `.kilorules-{mode-slug}` (single file)

{% callout type="info" title="Legacy Naming Note" %}
Older naming like `.clinerules-{mode-slug}` is not the recommended path for current Kilo mode-specific instructions.
{% /callout %}

## Related Features

- [Custom Modes](/docs/customize/custom-modes)
Expand Down
Loading