Skip to content

Commit 7259623

Browse files
committed
chore(claude): sync rules and project settings from rulesync
Made-with: Cursor
1 parent 9bdc4f4 commit 7259623

5 files changed

Lines changed: 33 additions & 73 deletions

File tree

.claude/rules/logseq-forum-post.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Formatting Forum Posts in Logseq
22

3-
This rule defines the standard format for importing and structuring forum posts in Logseq, including posts from Cursor, Reddit, Stack Overflow, and other forums. This rule works in conjunction with the logseq-person rule for handling person references.
3+
This rule defines the standard format for importing and structuring forum posts in Logseq, including posts from Cursor, Reddit, Stack Overflow, and other forums. For person hubs, use the **logseq-person** router and `[[Logseq/Entity/person]]` (see **logseq-entity** skill).
44

55
### ⚠️ CRITICAL: DO NOT MODIFY FRONTMATTER TAGS ⚠️
66

@@ -55,7 +55,7 @@ When referencing users in forum posts:
5555
- They have a substantial online presence
5656

5757
2. **Person References**
58-
- Follow the logseq-person rule for creating/updating person references
58+
- Follow `[[Logseq/Entity/person]]` and the **logseq-person** router for creating/updating person hub references
5959
- Only create new person pages for significant contributors
6060
- Update existing person pages if found
6161
- Include:

.claude/rules/logseq-naming-conventions.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ This is an extension to the logseq-flavored-markdown rule for maintaining consis
2020
- Use singular form: `[[Project]]` not `[[Projects]]`
2121

2222
2. **Aliases**
23-
- Add plural form as an alias in the page's frontmatter
23+
- Add a plural or contextual form as an alias in the page's frontmatter when you want that link text to resolve to the singular canonical page.
2424
- Example:
2525
```markdown
2626
---
@@ -29,8 +29,8 @@ This is an extension to the logseq-flavored-markdown rule for maintaining consis
2929
```
3030

3131
3. **References**
32-
- Use plural form in references: `[[Related Posts]]`
33-
- The alias will resolve to the singular page name
32+
- Use the alias link text in references when you want the plural or contextual surface form: `[[Related Posts]]`
33+
- The alias resolves to the singular page name
3434
- This maintains consistency while allowing for sub-namespaces
3535

3636
### Benefits
@@ -42,16 +42,15 @@ This is an extension to the logseq-flavored-markdown rule for maintaining consis
4242
### Examples
4343

4444
<CORRECT_✅>
45-
- [[Person/John Smith]] (singular page name)
46-
- alias:: [[People/John Smith]]
45+
- [[Person/John Smith]] (singular person hub; see `[[Logseq/Entity/person]]` — do not use a parallel `[[People/...]]` alias)
4746
- [[Project/Cursor]] (singular page name)
4847
- alias:: [[Projects/Cursor]]
4948
- [[Related/Post]] (singular page name)
5049
- alias:: [[Related Posts]]
5150
</CORRECT_✅>
5251

5352
<INCORRECT_❌>
54-
- [[People/John Smith]] (plural in page name)
53+
- [[People/John Smith]] (plural in page name — not used for persons in this garden)
5554
- [[Projects/Cursor]] (plural in page name)
5655
- [[Related Topics]] (plural in page name)
5756
</INCORRECT_❌>

.claude/rules/logseq-person.md

Lines changed: 8 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -2,65 +2,11 @@
22
paths:
33
- '{journals,pages}/*.md'
44
---
5-
# How a Person is tracked in this Logseq knowledge garden
6-
This is an extension to the logseq-flavored-markdown rule for recording information about a person.
7-
8-
A person entry is a logseq page where the page title matches one of the following patterns:
9-
- [[People/Full Name]] (corresponds to `pages/People___Full Name.md`)
10-
- [[Person/Full Name]] (corresponds to `pages/Person___Full Name.md`)
11-
- [[<AnyNamespace>/People/Full Name]] (e.g., `pages/HU___People___Full Name.md`)
12-
- [[<AnyNamespace>/Person/Full Name]] (e.g., `pages/AI___Person___Full Name.md`)
13-
14-
### When to Create a Person Page
15-
16-
Person pages should only be created for individuals who meet one or more of these criteria:
17-
- Known across multiple platforms (e.g., GitHub, Twitter, Stack Overflow)
18-
- Have a confirmed real identity
19-
- Are significant contributors or maintainers
20-
- Have a substantial online presence
21-
- Are key figures in their field
22-
23-
For other users, use site-specific namespaces:
24-
- `[[CursorAI/Forum/User/Username]]` for Cursor Forum users
25-
- `[[Reddit/User/Username]]` for Reddit users
26-
- `[[StackOverflow/User/Username]]` for Stack Overflow users
27-
- `[[ForumName/User/Username]]` for other forum users
28-
29-
### Creating a Person Page
30-
31-
If you are asked to make an entry for a person, you should:
32-
33-
1. **Search First - CRITICAL for Deduplication**
34-
- **Before creating or referencing a person page, you MUST search thoroughly:**
35-
- Search in `pages/People___*.md`, `pages/Person___*.md`, and in any file matching `pages/**___People___*.md` or `pages/**___Person___*.md`
36-
- Search by full name, partial name, username/handle, and common variations
37-
- Check aliases in existing person pages (read the `alias::` frontmatter)
38-
- Look for name variations (e.g., "Shawn Wang" vs "Shawn @swyx Wang" vs "@swyx")
39-
- **If a person page already exists:**
40-
- **DO NOT create a new page** - update the existing entry instead
41-
- **When referencing the person, use the canonical page name** (the actual filename), NOT aliases
42-
- Example: If page is `Person___Shawn @swyx Wang.md` with alias `[[Person/Shawn Wang]]`, reference it as `[[Person/Shawn @swyx Wang]]`, not `[[Person/Shawn Wang]]`
43-
- **A single person should NEVER have more than one person page** - this is a critical deduplication rule
44-
45-
2. **Verify Significance**
46-
- Confirm the person meets the criteria for a person page
47-
- If not, use the appropriate site-specific namespace instead
48-
49-
3. **Create/Update Page**
50-
- If a new person page is needed, create it under `[[Person/Full Name]]` by default
51-
- If the person is referenced in other contexts/namespaces (e.g., `[[People/Full Name]]`, `[[HU/Person/Full Name]]`), add aliases in the frontmatter to those contexts using `alias::` (not `aliases::`)
52-
- Look up the person on the internet
53-
- Create a person page for them if they meet the criteria
54-
- Link the person and a bit of their bio in their page
55-
- If possible add an image link
56-
- Include relevant external links (GitHub, LinkedIn, etc.)
57-
58-
4. **Referencing Existing Person Pages**
59-
- **Always use the canonical page name** when creating references in content
60-
- The canonical name is the actual page filename (e.g., `Person___Shawn @swyx Wang.md``[[Person/Shawn @swyx Wang]]`)
61-
- **Do NOT use aliases** when referencing - aliases are for backward compatibility, not for new references
62-
- If unsure of the canonical name, search for the person page first and use the exact page title
63-
64-
5. **Journal Entry**
65-
- If the person page is new, make an entry in today's journal page that links to that person
66-
- Use the canonical page name in the journal entry
5+
# Person entities (router)
6+
7+
- **Authoritative SOP:** `[[Logseq/Entity/person]]` — how we recognize person **hub** pages (`[[Person/Full Name]]` only), namespace vs entity type, `logseq-entity::`, aliases, dedup, and SCM child pages.
8+
- **Workflow:** Use the **logseq-entity** skill: read `[[Logseq/Entity]]` and the person type page, dedupe before creating, then create or update pages per that SOP (fallback: `.rulesync/config/logseq-entity.md` section **person**).
9+
- **This rule file** stays short; do not reintroduce legacy `[[People/...]]` title or alias patterns here or in new pages.
10+
- **Search before create:** `rg` / glob on `pages/Person___*.md`, name variants, and `alias::` lines; one hub per human; canonical link text must match the real page title.
11+
- **Tags:** Never modify, add, or remove **`tags::`** on existing pages unless a separate human instruction explicitly overrides garden tagging rules.
12+
- **Journal:** When filing a new person hub from a session, follow `logseq-journal-updates` (link under `[[Filed]]`, etc.).

.claude/rules/logseq-scm-project-link-style.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,11 @@ Do not introduce or keep generic SCM path styles such as:
3333

3434
1. When adding or editing GitHub/GitLab project references, rewrite them to the canonical person-first namespace.
3535
2. If the person page exists, use that exact canonical person name in links.
36-
3. If the person page does not exist and the task requires creating references, create/update the person page first using existing person-page conventions.
36+
3. If the person page does not exist and the task requires creating references, create/update the person **hub** first per `[[Logseq/Entity/person]]` (and the **logseq-entity** skill).
3737
4. For legacy content updates, normalize existing non-canonical SCM links to this style.
3838

3939
## Related
4040

4141
- command: `logseq-normalize-scm-project-links` - Normalize GitHub/GitLab project links in a file or across changed files
42-
- rule: `logseq-person` - Person page deduplication and canonical person naming
42+
- rule: `logseq-person` (router) — see `[[Logseq/Entity/person]]` for person hub dedup and naming
4343
- rule: `logseq-page-naming-reference` - Namespace/file naming rules

.claude/settings.json

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,20 @@
11
{
22
"permissions": {
3-
"deny": []
3+
"deny": [
4+
"Read(credentials/)"
5+
]
6+
},
7+
"hooks": {
8+
"PostToolUse": [
9+
{
10+
"matcher": "Write|Edit",
11+
"hooks": [
12+
{
13+
"type": "command",
14+
"command": "$CLAUDE_PROJECT_DIR/.rulesync/hooks/format.sh"
15+
}
16+
]
17+
}
18+
]
419
}
520
}

0 commit comments

Comments
 (0)