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/workflows/INDEX.org b/.ai/workflows/INDEX.org
new file mode 100644
index 0000000..3750e91
--- /dev/null
+++ b/.ai/workflows/INDEX.org
@@ -0,0 +1,75 @@
+#+TITLE: Workflow Index
+#+AUTHOR: Craig Jennings & Claude
+#+DATE: 2026-04-25
+
+* Purpose
+
+Single-source catalog of every workflow in this directory, with the trigger phrases that should invoke it. Read this file before =ls=-ing the workflows directory — it tells you which file handles which phrase, so you don't have to read each workflow's "When to Use" section to route correctly.
+
+* Drift Check
+
+This index must list every =.org= file in =.ai/workflows/= except this one. Startup verifies the index matches the directory and flags drift (missing entries or stale entries pointing at deleted files).
+
+* Catalog
+
+** Session lifecycle
+
+- =startup.org= — runs automatically at session start. No manual trigger.
+- =first-session.org= — initialize =.ai/= for a brand-new project.
+  - Triggers: "this is a new project", "let's set this project up". Auto-runs if =.ai/sessions/= is empty.
+- =wrap-it-up.org= — end-of-session: write summary, archive, commit, push.
+  - Triggers: "wrap it up", "that's a wrap", "let's call it a wrap"
+- =retrospective.org= — post-mortem after a tough session.
+  - Triggers: "let's do a retrospective", "retrospective time"
+
+** Tasks and planning
+
+- =task-review.org= — list all open tasks (list mode) or pick the next task (next mode).
+  - Triggers: "what's next", "what should I work on", "list open tasks", "show me all tasks", "what's on my plate", "task review", "show me my tasks", "I need a recommendation"
+- =daily-prep.org= — prep brief for the next workday. Two modes: full-prep (default) or standup-only.
+  - Full-prep triggers: "let's prep for tomorrow", "daily prep"
+  - Standup-only triggers: "what's my standup report", "let's do the daily standup report", "give me the standup brief"
+- =journal-entry.org= — capture a daily journal entry.
+  - Triggers: "let's do a journal entry", "create a journal entry"
+
+** Calendar
+
+- =add-calendar-event.org= — create a calendar event.
+  - Triggers: "create an event", "add appointment", "schedule a meeting", "add to my calendar", "calendar event for..."
+- =read-calendar-events.org= — read / summarize calendar.
+  - Triggers: "what's on my calendar", "show me appointments", "summarize my schedule", "what do I have today", "calendar for this week", "any meetings tomorrow"
+- =edit-calendar-event.org= — modify an existing event.
+  - Triggers: "edit the meeting", "change my appointment", "reschedule", "update the event", "move my appointment"
+- =delete-calendar-event.org= — cancel / remove an event.
+  - Triggers: "delete the meeting", "cancel my appointment", "remove the event", "clear my calendar for..."
+
+** Email
+
+- =sync-email.org= — pull and index new mail.
+  - Triggers: "sync email", "sync mail", "pull new mail", "check for new email"
+- =find-email.org= — search local maildir for emails.
+  - Triggers: "find email about [topic]", "search for emails from [person]", "do I have an email about [subject]?", "look for [shipping/receipt/confirmation] email"
+- =summarize-emails.org= — filter noise, summarize what matters.
+  - Triggers: "summarize my emails", "what emails do I have", "anything important in my inbox", "email summary", "any unread emails", "any starred emails", "emails from [person]", "emails also sent to [person]"
+- =extract-email.org= — extract content / attachments from an inbox EML.
+  - Triggers: "extract the email", "get the attachment from [email]", "pull the info from [email]", "process the email in inbox"
+- =send-email.org= — compose and send an email.
+  - Triggers: "send an email", "email workflow", "email [person] about [topic]", "send [file] to [person]"
+- =email-assembly.org= — gather documents into an email package.
+  - Triggers: "assemble an email", "email assembly workflow", "gather documents for an email", "I need to send [person] some documents"
+
+** Tools and meta
+
+- =process-meeting-transcript.org= — record → transcript → labeled archive.
+  - Triggers: "process the transcript", "process the recording". Auto: new files in =~/sync/recordings/=.
+- =page-me.org= — set a timed notification.
+  - Triggers: anything containing the word "page" used as a verb ("page me", "page me in 10 minutes", "page me at 3pm")
+- =status-check.org= — proactive long-running-job updates.
+  - Triggers: "keep me posted on this", "provide status checks on this job", "let me know when it's done", "monitor this for me". Auto: any job estimated 10+ min.
+- =create-workflow.org= — define a new workflow.
+  - Triggers: "let's create/define/design a workflow for [activity]", or unmatched workflow request after this index returns no hit.
+- =cross-agent-comms.org= — protocol for cross-project agent coordination via =inbox/from-agents/= (file-based IPC, GPG-signed, supports cross-machine over Tailscale). Auto: when =cross-agent-watch= detects a new inbound message, or when an agent decides to initiate a cross-project conversation. Operational scripts (=cross-agent-send=, =-recv=, =-watch=, =-status=, =-discover=, =-halt=, =-resume=) and their READMEs live at =.ai/scripts/cross-agent-comms/=.
+
+* Living Document
+
+Add a row when a new workflow lands in =.ai/workflows/=. Remove the row when a workflow is deleted. Update triggers when a workflow's "When to Use" section changes. The startup drift check is the safety net — it catches forgotten updates but doesn't substitute for keeping this file current.