Cursor

Use this guide after Get started. Windsurf notes are at the end.

---

1. Trust the workspace

When Cursor asks to trust the folder, accept trust for this project.
Project automation only runs in trusted workspaces.

Confirm install created Cursor project files under .cursor/ (you do not need to edit them by hand).

2. Daily use

Open Agent chat and type a normal request:

add a coupon field to the cart

What should happen:

1. Naro prepares a short work file for this request.
2. The agent reads that file first (project rule).
3. You see a board or checklist of open work — not only the default branch status.
4. Implementation stays inside the summary’s scope.

Optional skills (if present in the / menu): start, board, ship.

3. Skip Naro for a quick question

Prefix with ~:

~ what does this helper do

4. Board vs status

You run / ask for	You get
Board	Every open and cleared work item you care about
Status alone	Only the default record for the current branch

If something looks “missing,” ask for the board — not status alone.

5. Models

Cursor chooses the model. Naro does not lock it.
If chat claims “I switched the model,” treat that as advisory — confirm in Cursor’s own model UI.

6. When work is finished

Follow Prove & send. Cursor will block send commands while named items are still open.

7. Windsurf

If Windsurf does not load AGENTS.md automatically:

ln -s AGENTS.md .windsurfrules

Then type normally, same expectations as Cursor for rules and the send gate.

8. If nothing happens

1. Confirm workspace trust.
2. Confirm .cursor/ was installed.
3. Point the agent at the work file under .naro/ if it skipped the read.
4. See Troubleshooting.