Skip to content

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

Open
Olusammytee wants to merge 1 commit intoKilo-Org:devfrom
Olusammytee:docs/2154-update-custom-instruction-files-docs
Open

docs: update mode-specific custom instruction file guidance#477
Olusammytee wants to merge 1 commit intoKilo-Org:devfrom
Olusammytee:docs/2154-update-custom-instruction-files-docs

Conversation

@Olusammytee
Copy link
Contributor

Summary

  • update the Modes tab icon reference from organization to notebook in custom instructions docs
  • add a dedicated section for file-based mode-specific instructions
  • clarify preferred and fallback path conventions and legacy naming

Why

This aligns the docs with current UI and current mode rules file conventions.

Migrated from Kilo-Org/kilocode#5959 due docs repo migration.

Copilot AI review requested due to automatic review settings February 19, 2026 14:38
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the Custom Instructions documentation to match current Kilo Code UI iconography and to document the current file-based conventions for mode-specific instructions.

Changes:

  • Update the Modes tab icon reference from <Codicon name="organization" /> to <Codicon name="notebook" />.
  • Add a new “Mode-Specific Instructions from Files” section pointing to the preferred/fallback rules file paths and noting legacy naming.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 33 to 37
{% 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
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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contributor documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments