1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
#+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/=, =pairwise-tests/=, =playwright-js/=, =playwright-py/=, =root-cause-trace/=, =voice/=) — 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/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
* Workflow State
Markers maintained by workflows to record when they last ran. Read by other workflows that gate their behavior on freshness.
:LAST_AUDIT: 2026-05-28
:LAST_INBOX_PROCESS: 2026-06-13 (midday: two .emacs.d handoffs — validate-el -L fix applied to elisp bundle canonical; inbox-zero single-destination workflow built + wired into startup/wrap-up)
Format: one =:MARKER: YYYY-MM-DD= line per workflow. Workflows overwrite their own marker on completion.
|
