secondbrain-note

# Create Note

Capture knowledge, ideas, and thoughts with tagging support.

## Prerequisites

Verify Notes entity is enabled:
1. Check for `.claude/data/notes/records.yaml`
2. If not found, suggest enabling notes via `secondbrain-init` or `secondbrain-entity`

## Workflow

### Step 1: Gather Information

Collect from user or conversation context:

1. **Title** — Brief, descriptive title
2. **Content** — Main content (can be from conversation)
3. **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:**
```yaml
---
id: 2026-01-15-my-note
title: My Note Title
created: 2026-01-15
tags: [tag1, tag2]
status: active
---
```

**Content:**
```markdown
# 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 `.claude/data/notes/records.yaml`:

```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: active
```

### 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/records.yaml`. 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 | `kuber