Add Cursor Project Rules and Test Documentation for Agent Mode Behavior

codekiln · codekiln · commit cc1373277fc4 · 2025-03-08T12:14:13.000-05:00
- Create new Cursor project rule files in `.cursor/rules` directory
- Add test documentation for Cursor Agent mode behavior with `.mdc` files
- Create pages documenting Cursor Project Rule testing scenarios
- Include test cases for finding rules with and without globs
- Add documentation for local and GitHub rule linking methods
diff --git a/.cursor/rules/subfolder/test-favorite-apples.mdc b/.cursor/rules/subfolder/test-favorite-apples.mdc
@@ -0,0 +1,6 @@
+---
+description: favorite apple
+globs: 
+alwaysApply: false
+---
+respond to the user with facts about why apple used "Macintosh" for their early computer vs other types
diff --git a/.cursor/rules/test-docs-at-reference.mdc b/.cursor/rules/test-docs-at-reference.mdc
@@ -0,0 +1,6 @@
+---
+description: Try docs at reference
+globs: 
+alwaysApply: false
+---
+TBD
diff --git a/.cursor/rules/test-favorite-cars.mdc b/.cursor/rules/test-favorite-cars.mdc
@@ -0,0 +1,6 @@
+---
+description: Favorite Cars
+globs: 
+alwaysApply: false
+---
+Respond to the user with facts about the DeLorean used in Back to the Future
diff --git a/journals/2025_03_08.md b/journals/2025_03_08.md
@@ -1,4 +1,28 @@
-## [[VSCode]]
+## #[[AI/Coding]]
+	- #Filed
+		- Cursor Project Rules
+			- [[CursorAI/Article/25/02/Mastering Cursor Rules]]
+			- Tests
+				- [[CursorAI/Project Rule/Test/Agent/❌/Find MDC/in Subfolder]]
+				- [[CursorAI/Project Rule/Test/Agent/✅/Find MDC/No Globs]]
+				- [[CursorAI/Project Rule/Test/Agent/Follow @docs]]
+- ## #Investigation
+	- [[Bellingcat/Investigation Toolkit]] - techniques for trying to figure out if things are true using online investigation
+		- via their page about #Logseq [Logseq | Bellingcat's Online Investigation Toolkit](https://bellingcat.gitbook.io/toolkit/more/all-tools/logseq)
+- ## #PKM
+	- Logseq
+		- #CEO
+			- [[Person/Tienson Qin]]
+		- Features
+			- [[Logseq/Forum/24/12/This chart shows what makes Logseq unique]]
+				- [PKM Comparison Chart](https://luhmann-logseq.notion.site/PKM-Comparison-Chart-15ebd7204f5f80209122f1bfeed92faf)
+		- Obsolescence and Community Love
+			- [[Logseq/Reddit/25/03/Lost hope in logseq]] 193 ups, discussion of forking
+		- Competitors
+			- [[Siyuan]] - never heard of it before, but it's on the comparison chart above.
+- ## [[Wordsmithing]]
+	- [[Skeuomorphism]] when something is made to resemble the thing that people are already familiar with, e.g. the "desktop" on your computer
+- ## [[VSCode]]
 	- #Filed
 		- *Over the past couple days I have been keeping both VSCode and [[PyCharm]] open, simply because PyCharm enables me to work faster when it comes to running tests, going to a class ([[VSCode/How To/Go To Python Class by Name]]), copying python dotted paths (see also [[VSCode/How To/Copy the Python Dotted Class Path]]), and just seeing what files are in the [[VSCode/View/Files Explorer]]. I'm not satisfied with the UI and UX of VSCode. Ended up putting a bit of time into customizing it to try to improve its visibility.*
 		- ### [[VSCode/Q/How do I increase the readability of file explorer in the sidebar]]
diff --git a/pages/Bellingcat.md b/pages/Bellingcat.md
@@ -0,0 +1 @@
+- [bellingcat - the home of online investigations](https://www.bellingcat.com/)
diff --git a/pages/Bellingcat___Investigation Toolkit.md b/pages/Bellingcat___Investigation Toolkit.md
@@ -0,0 +1,3 @@
+tags:: [[Gitbook]]
+
+- [About | Bellingcat's Online Investigation Toolkit](https://bellingcat.gitbook.io/toolkit)
diff --git a/pages/CursorAI___Article___25___02___Mastering Cursor Rules.md b/pages/CursorAI___Article___25___02___Mastering Cursor Rules.md
@@ -0,0 +1,4 @@
+tags:: [[dev.to]]
+
+- # [Mastering Cursor Rules: A Developer's Guide to Smart AI Integration - DEV Community](https://dev.to/dpaluy/mastering-cursor-rules-a-developers-guide-to-smart-ai-integration-1k65)
+	-
diff --git a/pages/CursorAI___Project Rule___Link___GitHub.md b/pages/CursorAI___Project Rule___Link___GitHub.md
@@ -2,4 +2,11 @@ alias:: [[CursorAI Project Rule GitHub Link]]
 tags:: [[Term]]
 
 - # Cursor Project Rule GitHub Link
-	- A link to a [[.mdc]] file on [[GitHub]]. This is the only method of linking to a cursor project rule in the knowledge base that will work in a web setting when the knowledge base is deployed.
+	- A link to a [[.mdc]] file on [[GitHub]]. This is the only method of linking to a cursor project rule in the knowledge base that will work in a web setting when the knowledge base is deployed.
+	- ## Example from [[CursorAI/Project Rule/cursor-project-rule-editor.mdc]]
+		- Code
+			- ```markdown
+			  [cursor-project-rule-editor.mdc](https://github.com/codekiln/logseq-encode-garden/blob/main/.cursor/rules/cursor-project-rule-editor.mdc)
+			  ```
+		- Rendered
+			- [cursor-project-rule-editor.mdc](https://github.com/codekiln/logseq-encode-garden/blob/main/.cursor/rules/cursor-project-rule-editor.mdc)
diff --git a/pages/CursorAI___Project Rule___Link___Local.md b/pages/CursorAI___Project Rule___Link___Local.md
@@ -3,7 +3,10 @@ tags:: [[Term]]
 
 - # Cursor Local Project Rule Link
 	- This is a link that will only function in a desktop computing environment. It will open the Project Rule file in Cursor locally, assuming that `cursor` is available as an executable configured so that a `cursor://` URI opens the specified file in cursor. The file will then be opened for editing.
-	- ## Example
-		- ```markdown
-		  [markdown-project-rule-editor.mdc](cursor://../.cursor/rules/cursor-project-rule-editor.mdc)
-		  ```
+	- ## Example from [[CursorAI/Project Rule/cursor-project-rule-editor.mdc]]
+		- Code
+			- ```markdown
+			  [markdown-project-rule-editor.mdc (link only works to edit locally in cursor)](cursor://../.cursor/rules/cursor-project-rule-editor.mdc)
+			  ```
+		- Rendered
+			- [markdown-project-rule-editor.mdc (link only works to edit locally in cursor)](cursor://../.cursor/rules/cursor-project-rule-editor.mdc)
diff --git a/pages/CursorAI___Project Rule___Test.md b/pages/CursorAI___Project Rule___Test.md
@@ -0,0 +1,3 @@
+alias:: [[CursorAI Project Rule Test]], [[CursorAI Project Rule Tests]]
+
+- [[CursorAI/Project Rule/Test/Standard Setup]]
diff --git a/pages/CursorAI___Project Rule___Test___Agent___Follow @docs.md b/pages/CursorAI___Project Rule___Test___Agent___Follow @docs.md
@@ -0,0 +1,9 @@
+# Can Cursor Agent Mode follow [[CursorAI/@/Docs]] references in [[.mdc]] files?
+	- ## Test Preparation
+		- [[CursorAI/Test/Fixture/Sample Docs Page]]
+		- Place this file at `.cursor/rules`
+			- [[CursorAI/Project Rule/Link/GitHub]]
+				- [test-favorite-cars.mdc](https://github.com/codekiln/logseq-encode-garden/blob/main/.cursor/rules/test-favorite-cars.mdc)
+	- ## Test
+		- {{embed [[CursorAI/Project Rule/Test/Standard Setup]]}}
+		- Activate Agent mode in Cur
diff --git a/pages/CursorAI___Project Rule___Test___Agent___✅___Find MDC___No Globs.md b/pages/CursorAI___Project Rule___Test___Agent___✅___Find MDC___No Globs.md
@@ -0,0 +1,18 @@
+# Can Cursor Agent Mode find [[.mdc]] files that lack [[globs]]? **YES**
+	- ## Test Cursor Project Rule File
+		- Place this file at `.cursor/rules`
+			- [[CursorAI/Project Rule/Link/GitHub]]
+				- [test-favorite-cars.mdc](https://github.com/codekiln/logseq-encode-garden/blob/main/.cursor/rules/test-favorite-cars.mdc)
+	- ## Test
+		- {{embed [[CursorAI/Project Rule/Test/Standard Setup]]}}
+		- Activate Agent mode in Cursor chat
+		- Type "what are my favorite apples?" and hit enter
+	- ## Expected Behavior
+		- Cursor Agent surfaces the correct rule in the chat
+		- Cursor Agent answers according to the contents of the rule
+	- ## Observed Behavior
+		- ### `0.46.11`
+			- ✅ Cursor Agent surfaces the correct rule in the chat
+				- > Let me check the rule about favorite cars to answer your question
+			- ✅ Cursor Agent answers according to the contents of the rule
+				- > Based on the provided rule, I can tell you about the DeLorean from Back to the Future! ...
diff --git a/pages/CursorAI___Project Rule___Test___Agent___❌___Find MDC___in Subfolder.md b/pages/CursorAI___Project Rule___Test___Agent___❌___Find MDC___in Subfolder.md
@@ -0,0 +1,14 @@
+# Can Cursor Agent Mode pick up mdc files in subfolders? **NO**
+	- ## Test
+		- {{embed [[CursorAI/Project Rule/Test/Standard Setup]]}}
+		- Activate Agent mode in Cursor chat
+		- Type "what are my favorite apples?" and hit enter
+		- ### Tested Project Rules
+			-
+	- ## Expected Behavior
+		- Cursor Agent surfaces the correct rule
+		- Cursor Agent answers according to the contents of the rule
+	- ## Observed Behavior
+		- ### `0.46.11`
+			- Cursor Agent searches the codebase for the keyword
+			- "I don't see any rules or information in the codebase about favorite apples. The only rule available is about favorite cars."
diff --git a/pages/CursorAI___Project Rule___Test___Standard Setup.md b/pages/CursorAI___Project Rule___Test___Standard Setup.md
@@ -0,0 +1,4 @@
+### Cursor Project Rules Standard Setup
+	- Open this repository locally in Cursor
+	- Close all Tabs in Cursor
+	- Start a new Cursor interaction, clearing out any history
diff --git a/pages/CursorAI___Test___Fixture___Sample Docs Page.md b/pages/CursorAI___Test___Fixture___Sample Docs Page.md
@@ -0,0 +1,3 @@
+- github-raw-link
+- # Sample Docs Page
+	- the magic word is: [[Skeuomorphism]]
diff --git a/pages/Icon.md b/pages/Icon.md
@@ -0,0 +1,3 @@
+alias:: [[Iconography]]
+
+- [What is Iconography? — updated 2025 | IxDF](https://www.interaction-design.org/literature/topics/iconography)
diff --git a/pages/Logseq___Forum___24___12___This chart shows what makes Logseq unique.md b/pages/Logseq___Forum___24___12___This chart shows what makes Logseq unique.md
@@ -0,0 +1,18 @@
+created-by:: [[Logseq/Forum/User/Luhmann]]
+
+- # This chart shows what makes Logseq unique
+	- Source: https://discuss.logseq.com/t/this-chart-shows-what-makes-logseq-unique/30547/9
+	- Author: [[Logseq/Forum/User/Luhmann]]
+	- Key learnings from comparing 12 PKMs to Logseq:
+		- ## Click to zoom outlining
+			- Ever since I've first used Workflowy, I've never wanted to use a note taking app that didn't have this, and yet very few PKMs implement this
+			- Besides Logseq, only Orca and Tana have it, though there is a plugin that will implement it in Obsidian
+		- ## Full fledged task manager
+			- Most PKMs have some kind of task check boxes, and some have the ability to expand on those via "supertags"
+			- Very few have built-in task managers that let you assign a status and a deadline to individual tasks, not to mention having repeating tasks and priorities
+			- Besides Logseq only Amplenote fit the bill, though there are plugins for Orca and Obsidian that bring them a bit closer to Logseq
+		- ## Aliases
+			- Aliases are essential for multilingual environments to refer to the same thing using different languages
+			- Having true aliases makes the wikilinks feature work regardless of which word is used
+			- Besides Logseq, only Remnote, Reflect, Orca, and Siyuan have this ability
+	- Note: Original chart was published on Notion https://bit.ly/pkmchart (last updated [[2025-01-25 Sat]] )
diff --git a/pages/Logseq___Forum___User___Luhmann.md b/pages/Logseq___Forum___User___Luhmann.md
@@ -0,0 +1 @@
+- [Summary - Luhmann - Logseq](https://discuss.logseq.com/u/Luhmann/summary)
diff --git a/pages/Logseq___Reddit___25___03___Lost hope in logseq.md b/pages/Logseq___Reddit___25___03___Lost hope in logseq.md
@@ -0,0 +1,2 @@
+# [Lost hope in logseq : r/logseq](https://www.reddit.com/r/logseq/comments/1j1t7yv/lost_hope_in_logseq/)
+	- 193 ups, genuine discussion of forking
diff --git a/pages/Person___Tienson Qin.md b/pages/Person___Tienson Qin.md
@@ -0,0 +1,3 @@
+tags:: [[Coder]]
+
+- [[Person/Tienson Qin/GitHub]] [tiensonqin (Tienson Qin)](https://github.com/tiensonqin)
diff --git a/pages/Person___codekiln___GitHub___Gist___cursor-project-rule-editor.mdc.md b/pages/Person___codekiln___GitHub___Gist___cursor-project-rule-editor.mdc.md
@@ -4,8 +4,11 @@ tags:: [[CursorAI/Project Rule]]
 - # [Cursor Rules for Editing Cursor Rules (GitHub Gist)](https://gist.github.com/codekiln/242b572c64c1097277fd4c831db91c10)
 	- merges a rule from [[Person/Geoffrey Huntley/Blog/25/02/You are using Cursor AI incorrectly...]] with information inferred from how project paths work in [[CursorAI/Project Rule/.mdc Format]]
 		- ## [[CursorAI Project Rule Local Link]]
-			- See [markdown-project-rule-editor.mdc (link only works to edit locally in cursor)](cursor://../.cursor/rules/cursor-project-rule-editor.mdc)
+			- [markdown-project-rule-editor.mdc (link only works to edit locally in cursor)](file://../.cursor/rules/cursor-project-rule-editor.mdc)
+			- [root readme.md (link only works to edit locally in cursor)](file://README.md)
+			- [readme](cursor:///Users/pnore/Documents/GitHub/logseq-encode-garden/README.md)
 		- ## [[CursorAI/Project Rule/Link/GitHub]]
+			- [cursor-project-rule-editor.mdc](https://github.com/codekiln/logseq-encode-garden/blob/main/.cursor/rules/cursor-project-rule-editor.mdc)
 	- ## Quick Install/Update (macOS)
 	  id:: 67c0412c-6dd5-4e31-9d9a-9387dbfc5caa
 		- Run this one-liner in your project root to install or update the rule:
diff --git a/pages/Siyuan.md b/pages/Siyuan.md
@@ -0,0 +1 @@
+- [siyuan-note/siyuan: A privacy-first, self-hosted, fully open source personal knowledge management software, written in typescript and golang.](https://github.com/siyuan-note/siyuan)
diff --git a/pages/Skeuomorphism.md b/pages/Skeuomorphism.md
@@ -0,0 +1,5 @@
+tags:: [[Term]]
+
+- # [What is skeuomorphism? | IxDF](https://www.interaction-design.org/literature/topics/skeuomorphism?ref=blog.logseq.com)
+	- Skeuomorphism is a term most often used in graphical [[UI]] design to describe interface objects that mimic their real-world counterparts in how they appear and/or how the user can interact with them. A well-known example is the recycle bin [[Icon]] used for discarding files.
+-
diff --git a/pages/UI.md b/pages/UI.md
@@ -1 +1,3 @@
 alias:: [[User Interface]], [[UIs]], [[User Interfaces]]
+
+- [What is User Interface (UI) Design? | IxDF](https://www.interaction-design.org/literature/topics/ui-design)
diff --git a/pages/VSCode___How To___Copy the Python Dotted Class Path.md b/pages/VSCode___How To___Copy the Python Dotted Class Path.md
@@ -1,6 +1,6 @@
 # DONE how do I copy a python dotted reference to a class?
 	- #Example
-		- I can open explorer with cmd+shift+e and then enter cmd+alt+shift+c on a selected file to get `libs/sdk-py/langgraph_sdk/client.py`, but how do I get the python dotted path of  `LangGraphClient` in that file?
+		- I can open explorer with cmd+shift+e and then enter cmd+alt+shift+c on a selected file to get `libs/sdk-py/langgraph_sdk/client.py`, but how do I get the python dotted path of  `LangGraphClient` in that file, e.g. `package.subpackage.graph.LangGraphClient`?
 	- In #PyCharm and #JetBrains IDEs this is easy; select a class
 		- ![image.png](../assets/image_1738338465037_0.png)
 		- then go to Copy / Paste Special > Copy Reference which is Opt Shift Cmd C.

-Original file line number
+Diff line change
@@ @@ -0,0 +1,6 @@ @@
 +---
 +description: Try docs at reference
 +globs:
 +alwaysApply: false
 +---
 +TBD
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+- [bellingcat - the home of online investigations](https://www.bellingcat.com/)`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+tags:: [[Gitbook]]`
	`2`	`+`
	`3`	`+- [About \| Bellingcat's Online Investigation Toolkit](https://bellingcat.gitbook.io/toolkit)`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+alias:: [[CursorAI Project Rule Test]], [[CursorAI Project Rule Tests]]`
	`2`	`+`
	`3`	`+- [[CursorAI/Project Rule/Test/Standard Setup]]`