mirror of
https://github.com/cursor/plugins.git
synced 2026-09-14 20:00:00 +08:00
lauren
4483dcd246
<!-- CURSOR_AGENT_PR_BODY_BEGIN --> ## Summary - add a maintained Notes feature-map index with baseline, driving, proof, and entry-contract guidance - add complete browser and CLI recipes for note creation and search - point `create-verification-skill` at the reference and bump pstack to 0.11.14 ## Testing - `npm install --no-save ajv ajv-formats && node scripts/validate-plugins.mjs` - `git diff --check origin/main...HEAD` - verified both feature files have the four required H2s in order and start their driving sections with `Preconditions:` - verified the reference contains no internal names or em dashes <!-- CURSOR_AGENT_PR_BODY_END --> <div><a href="https://cursor.com/agents/bc-16f55275-7fb3-4f64-a1d9-b115f1ad4b5a"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a> <a href="https://cursor.com/background-agent?bcId=bc-16f55275-7fb3-4f64-a1d9-b115f1ad4b5a"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a> </div>
Notes verification map
This directory is the maintained source for verifying the user-facing behavior of Notes. Read the index before driving the app, then use the matching feature file as the recipe.
Baseline preconditions
- Launch Notes at
http://127.0.0.1:4173with a disposable data directory. - Set
NOTES_DATA_DIR=/tmp/notes-verify-$RUN_IDso concurrent runs do not share state. - Seed notes titled
Quarterly planandGrocery list. - Put
control-notesand thenotesCLI onPATH. - Run
control-notes doctorand require the expected URL, data directory, and build revision. - Never drive an instance that was not started by this verification run.
Driving conventions
- Start every recipe from the baseline state unless its preconditions say otherwise.
- Prefer ARIA roles and accessible names over CSS selectors or DOM position.
- Treat every command as literal. Keep quoted names and flags unchanged.
- Run browser actions through
control-notes browser. - Run terminal actions through
control-notes cli -- <command>. - Restore seeded data after a mutation. Do not remove proof artifacts during cleanup.
Proof and skip reporting
- Capture the user action and the resulting state, not only the final screen.
- UI proof includes an ARIA snapshot and a screenshot with the app identity visible.
- CLI proof includes the command, stdout, stderr, and exit code.
- Mutation proof includes a read-only second view of the stored value.
- Record the feature ID and entry point used with every artifact.
- Report an unreachable path with the attempted command and the unmet precondition.
- Do not report a skipped entry point as verified through a different path.
Feature entry contract
Each feature file starts with an H1 title and one paragraph describing the user-visible behavior. It then uses exactly four H2 sections in this order.
Sub-featureslists short IDs with one line for each behavior.How to get to it (user POV)lists every user entry point.Driving it with <harness>starts withPreconditions:and uses labeled bullets that pair each user action with an exact command and observable result.Gotchaslists traps that can waste or invalidate a verification run.
Keep implementation details out of the map. Name only user paths, stable handles, required state, commands, and observable proof.
Features
- Create a note covers browser and CLI creation, cancellation, persistence, and cleanup.
- Search notes covers toolbar, keyboard, and CLI search with matching, empty, and clear states.