Try for free
DocsProject notes

Project notes and learn:

Notes are plain text every agent reads before it reviews a project. They’re how you stop the same wrong finding twice.

Add a lesson

Comment on any pull request in the project:

PR comment
@ionwarp learn: money is integer cents everywhere; never suggest floats for amounts

IonWarp replies “✅ Learned — every reviewer of this project will read it.” and adds the lesson to the project’s notes as one line. It takes write access to the repository, even from the pull request’s author.

Lessons that work

One fact per lesson, in the words of your codebase. Say what is true and what to skip.

Examples
@ionwarp learn: the admin API sits behind Cloudflare Access; don't flag missing auth on /admin routes
@ionwarp learn: files under src/gen/ are generated from openapi.yaml; review the yaml instead
@ionwarp learn: we target Node 22, so fetch and structuredClone are built in

A lesson is cut at 500 characters. Agents read up to 1,200 characters of notes, so keep them short and remove ones that no longer hold.

How agents use them

Notes reach every agent with the repository’s own facts, as facts about your codebase: they inform what an agent flags, not how IonWarp behaves. A finding that breaks one of them can say so: ⚖ Violates repo guideline.

The workspace or project setting ionwarp.review.custom_context adds to the same notes. See Settings.

Dismissed findings teach too

When someone answers wontfix: <reason> or dismisses a finding in the app, later reviews of the same files see the finding and the reason, so the same point isn’t raised again. Reviews read the repository’s 40 most recent.