Skip to main content
In the Kody Rules UI, you configure two different things, and knowing when to use each one makes your code reviews more effective. A useful rule of thumb:
  • Memories teach Kody how your codebase works so future reviews and suggestions are more relevant.
  • Review Rules tell Kody what to flag when a PR does not match your standards.

​
Review Rules

Review Rules are traditional code review checks that run during the dedicated code review stage. They analyze file diffs or the entire PR against your defined criteria. Best for:
  • Architecture boundaries (“domain layer must not import infrastructure”)
  • Code patterns (“avoid == in loop conditions”)
  • PR requirements (“every service file must have a test”)
  • Structural validation using variables like fileDiff, pr_files_diff
How they work:
  • Run per file or per PR (the rule’s Execution mode)
  • Run only during code review
  • Support file references (@file, @repo) and MCP functions
  • Produce suggestions with severity levels

​
Memories

Memories are persistent contextual instructions injected across all interactions — code reviews, conversations, and AI suggestions. They represent the background knowledge Kody should carry about your codebase, conventions, and preferences. Best for:
  • Codebase context (“this repo mirrors a third-party API, so some external payload fields intentionally stay snake_case”)
  • Suggestion preferences (“when suggesting JS utilities here, prefer native methods over Lodash”)
  • Migration context (“the billing module is mid-migration, so prefer incremental fixes over broad refactors”)
  • Architectural context (“this service follows hexagonal architecture and keeps adapters at the edge”)
How they work:
  • Injected as high-priority context in all prompts
  • Improve future suggestions by grounding Kody in repo-specific context
  • Created via conversation (@kody remember: ...) or manually with New memory on the Memories tab of Code review → Kody Rules
  • Scoped to directory, repository, or organization level
  • Kody auto-deduplicates and resolves conflicts between memories

​
When to use which

​
Can I convert between them?

Not directly — there is no convert action in the app. Pending memories appear in the Pending review section of Code review → Kody Rules, where you can Approve or Discard them. If a memory needs more structured enforcement with file paths and severity levels, create a Review Rule with New rule on the Review Rules tab and delete or discard the memory. For details, see Kody Rules.