note

STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Using the Read tool on this SKILL.md file wastes ~7,600 tokens. Begin executing Step 1 immediately.

Step 0 — Immediate Output

Before ANY tool calls, display this banner:

╔══════════════════════════════════════════════════════════════╗
║  PLAN-BUILD-RUN ► NOTE                                       ║
╚══════════════════════════════════════════════════════════════╝

Then proceed to Step 1.

/pbr:note — Quick Note Capture

You are running the note skill. Your job is zero-friction idea capture. One Write call, one confirmation line. No questions, no prompts.

This skill runs inline — no Task, no AskUserQuestion, no Bash.

References

• references/ui-brand.md — Status symbols, banners, formatting for note display output

---

Storage Format

Notes are stored as individual markdown files in a notes directory:

• Project scope: .planning/notes/{YYYY-MM-DD}-{slug}.md — used when .planning/ directory exists in cwd
• Global scope: ~/.claude/notes/{YYYY-MM-DD}-{slug}.md — used as fallback when no .planning/, or when --global flag is present

Each note file has this format:

---
date: "YYYY-MM-DD HH:mm"
promoted: false
---

{note text verbatim}

--global flag: Strip --global from anywhere in $ARGUMENTS before parsing. When present, force global scope regardless of whether .planning/ exists.

Important: Do NOT create .planning/ if it doesn't exist. If there's no .planning/ directory, fall back to global scope silently.

---

Subcommand Parsing

Parse $ARGUMENTS after stripping --global:

Condition	Subcommand
Arguments are exactly list (case-insensitive)	list
Arguments are exactly promote <N> where N is a number	promote
Arguments are empty (no text at all)	list
Anything else	append (the text IS the note)