Create Note
Capture knowledge, ideas, and thoughts with tagging support.
Prerequisites
Verify Notes entity is enabled:
- Check for
.claude/data/notes/meta.yaml(sharded) or.claude/data/notes/records.yaml(legacy) - If not found, suggest enabling notes via
secondbrain-initorsecondbrain-entity
Workflow
Step 1: Gather Information
Collect from user or conversation context:
- Title — Brief, descriptive title
- Content — Main content (can be from conversation)
- Tags (optional) — Categorization tags
Step 2: Generate Note ID
Date-based ID format: YYYY-MM-DD-<title-slug>
Example: 2026-01-15-kubernetes-deployment-patterns
Step 3: Create Note Document
Filename: docs/notes/YYYY-MM-DD-<slug>.md
Frontmatter:
---
id: 2026-01-15-my-note
title: My Note Title
created: 2026-01-15
tags: [tag1, tag2]
status: active
---Content:
# My Note Title
## Summary
Brief overview...
## Content
Main content here...
## References
- Links to related resources
## Related
- Links to related notes, ADRs, etc.Step 4: Update Records
Add entry to the current month's shard .claude/data/notes/YYYY-MM.yaml:
- id: "2026-01-15-my-note"
title: "My Note Title"
created: 2026-01-15
file: docs/notes/2026-01-15-my-note.md
tags: [tag1, tag2]
status: activeEnsure the current month is registered in .claude/data/notes/meta.yaml shards list.
Step 5: Sidebar Note
DO NOT manually add notes to VitePress sidebar.
Notes are automatically listed via the EntityTable component on docs/notes/index.md, which reads from .claude/data/notes/ shard files. No sidebar modification needed.
Step 6: Confirm Creation
## Note Created
**ID:** 2026-01-15-kubernetes-deployment-patterns
**Title:** Kubernetes Deployment Patterns
**Tags:** kubernetes, deployment, devops
**File:** docs/notes/2026-01-15-kubernetes-deployment-patterns.md
The note has been created and is ready for editing.Tags
Tags help organize notes for discovery. Common patterns:
| Category | Example Tags |
|---|---|
| Technology | kubernetes, react, python |
| Domain | architecture, security, performance |
| Type | howto, reference, research |
| Project | project-x, migration, refactor |
Status Values
active— Current, relevant notearchived— No longer current but preserved
Additional Resources
references/note-formats.md— Detailed note templates and formatting patterns
Tips
- Be specific — Titles should indicate content at a glance
- Add context — Include why this is important, not just what
- Link liberally — Connect to related notes and external resources
- Tag consistently — Use established tags when possible
- Review periodically — Archive notes that are no longer relevant