joelhooks pi-notes
Use this skill when creating, serving, reviewing, or debugging pi-notes review documents.
Principles
- Treat product namespace as required.
- Prefer local
portlessURLs for stable access. - Review docs should batch precise feedback and send it back to the spawning Pi session.
- Preserve source-grounded content law when reviewing source-derived docs.
- Keep UI hyper-readable, restrained, and keyboard-first.
- For diagrams, prefer the local
excalidraw-dagskill: clean left-to-right DAGs, few boxes, legible labels, linked from Brain entries.
References
- Extension source:
extensions/pi-notes/index.ts - Domain glossary:
.brain/areas/concepts.svx(rendered through the pi-notes Document Host) - Architecture/area notes:
.brain/areas/*.svxand.brain/resources/*.svx; legacydocs/project/context.mdis migration evidence only if present - Architecture decision:
docs/adr/0001-pi-extension-local-review-sites.md - Diagram guidance:
skills/excalidraw-dag/SKILL.md - Diagram Brain entry:
.brain/resources/excalidraw-diagrams.svx(http://127.0.0.1:4188/notes/resources/excalidraw-diagrams) - Pi source/docs:
repos/pi-mono/ - Effect source:
repos/effect/ - Keystrok inspiration/license:
repos/keystrok/