second-brain

* Requires API Key: Request one at https://ensue-network.ai?utm_source=clawdbot *

# Second Brain

A personal knowledge base for **building understanding that compounds over time**. Not a note dump - a structured system for capturing knowledge you can actually retrieve and use.

## Philosophy

Your second brain should:
- **Capture understanding, not just facts** - Write for your future self who forgot the context
- **Be retrievable** - Structured so you can find things when you need them
- **Stay evergreen** - No private details, credentials, or time-sensitive data
- **Reflect real experience** - Only save what you've actually learned or used

Before saving: *Will future-me thank me for this?*

## Namespace Structure

```
public/                           --> Shareable knowledge
  concepts/                       --> How things work
    [domain]/                     --> Organize by topic
      [concept-name]              --> Individual concepts
  toolbox/                        --> Tools and technologies
    _index                        --> Master index of tools
    [category]/                   --> Group by type
      [tool-name]                 --> Individual tools
  patterns/                       --> Reusable solutions
    [domain]/                     --> Design patterns, workflows
  references/                     --> Quick-reference material
    [topic]/                      --> Cheatsheets, syntax, APIs

private/                          --> Personal only
  notes/                          --> Scratchpad, drafts
  journal/                        --> Dated reflections
```

**Example domains:** `programming`, `devops`, `design`, `business`, `data`, `security`, `productivity`

## Content Formats

### Concepts

For understanding how something works:

```
CONCEPT NAME
============

What it is:
[One-line definition]

Why it matters:
[What problem it solves, when you'd need it]

How it works:
[Explanation with examples]
[ASCII diagrams for architecture/flows where h...