chore(ai): initialize project notes and Claude tooling surfaces

Replace the seed notes.org with project-specific context (layout, install modes, task tracker location, recent inflection point). Bring in the synced template surfaces (protocols, workflows, scripts, references, retrospectives, someday-maybe) as tracked content for this content/documentation project.

1 files changed, 75 insertions, 0 deletions

diff --git a/.ai/notes.org b/.ai/notes.org
new file mode 100644
index 0000000..735e256
--- /dev/null
+++ b/.ai/notes.org
@@ -0,0 +1,75 @@
+#+TITLE: Claude Code Notes - Rulesets
+#+AUTHOR: Craig Jennings & Claude
+#+DATE: 2026-05-06
+
+* About This File
+
+This file contains project-specific information for this project.
+
+**When to read this:**
+- At the start of EVERY session (after reading protocols.org)
+- When needing project context or history
+- When checking reminders or pending decisions
+
+**What's in this file:**
+- Project-specific context and goals
+- Pending decisions
+- Active reminders
+
+**Session history is NOT in this file.** Each session's record lives in =.ai/sessions/YYYY-MM-DD-HH-MM-description.org= — one file per session. Catch-up reads the Summary sections of the most recent 5.
+
+**For protocols and conventions, see:** [[file:protocols.org][protocols.org]]
+
+* Project-Specific Context
+
+** What this project is
+
+Craig's personal Claude Code configuration: skills, rules, hooks, and per-language bundles installed into =~/.claude/= machine-wide or copied into individual projects.
+
+See [[file:../README.org][README.org]] for the full layout, install modes, and language-bundle structure.
+
+** Layout (high level)
+
+- =claude-rules/= — generic rules (=commits.md=, =testing.md=, =verification.md=, =subagents.md=) symlinked into =~/.claude/rules/= and applied to every Claude Code session on the machine.
+- Top-level skill directories (=add-tests/=, =debug/=, =five-whys/=, =frontend-design/=, =humanizer/=, =pairwise-tests/=, =playwright-js/=, =playwright-py/=, =root-cause-trace/=) — each a Claude Code skill, symlinked into =~/.claude/skills/= by =make install=.
+- =languages/= — per-language bundles (rules + hooks + settings) copied into target projects via =make install-lang LANG=<name> PROJECT=<path>=. Both =LANG= and =PROJECT= are optional — fzf picks them interactively when omitted. Bundles currently shipping: =elisp=, =python=.
+- =.claude/= — repo-local Claude Code config: =settings.json= and =commands/=.
+- =hooks/=, =scripts/= — install helpers and PostToolUse validators that ride along with bundles.
+- =Makefile= — install / uninstall / list entry points.
+
+** Task tracker
+
+=todo.org= at the project root holds the active task list. The file is large (~73 KB) — search rather than scan when looking for specific items.
+
+** Current state
+
+Recent inflection point: 16 user-invoked skills were converted to commands (commit =aa69245=, =refactor(skills): convert 16 user-invoked skills to commands=). The skill / command split is the current mental model — user-triggered entry points are commands, model-triggered behaviors stay as skills.
+
+** Remote
+
+=git@cjennings.net:rulesets.git=. No GitHub remote — PRs and reviews don't apply here.
+
+* PENDING DECISIONS
+
+This section tracks decisions that need Craig's input before work can proceed.
+
+** Current Pending Decisions
+
+(None currently — will be added as they arise)
+
+* Active Reminders
+
+** Current Reminders
+
+(None currently — will be added as needed)
+
+** Instructions for This Section
+
+When Craig says "remind me" about something:
+1. Add it here with timestamp and description
+2. If it's a TODO, also add to =/home/cjennings/sync/org/roam/inbox.org= scheduled for today
+3. Check this section at start of every session
+4. Remove reminders once addressed
+
+Format:
+- =[YYYY-MM-DD]= Description of what to remind Craig about