aboutsummaryrefslogtreecommitdiff
path: root/docs/agent-knowledge-base-spec.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-10 18:23:16 -0500
committerCraig Jennings <c@cjennings.net>2026-06-10 18:23:16 -0500
commit97a7d630c0e027bcd3717048e3d09831c4f12f21 (patch)
treea0521483e51e119041fee1f8df9f5e77134bb690 /docs/agent-knowledge-base-spec.org
parentb0140951ebe0f0c2d33a868a2d1cda2eafd29044 (diff)
downloadrulesets-97a7d630c0e027bcd3717048e3d09831c4f12f21.tar.gz
rulesets-97a7d630c0e027bcd3717048e3d09831c4f12f21.zip
docs(spec): record agent KB v1 implementation, close phase tasks
All five phases shipped today. The spec status flips to implemented with a history entry carrying the commit trail; the phase tasks become dated completion entries under the parent, which moves to DOING until the manual-testing checklist and the other machines' clone + timer setup land.
Diffstat (limited to 'docs/agent-knowledge-base-spec.org')
-rw-r--r--docs/agent-knowledge-base-spec.org9
1 files changed, 7 insertions, 2 deletions
diff --git a/docs/agent-knowledge-base-spec.org b/docs/agent-knowledge-base-spec.org
index cf69c35..78ff9bd 100644
--- a/docs/agent-knowledge-base-spec.org
+++ b/docs/agent-knowledge-base-spec.org
@@ -3,7 +3,7 @@
#+DATE: 2026-06-10
* Metadata
-| Status | ready — Codex review incorporated; D7 keep, denylist =~/projects/work= only, D8 transport = git all ratified (Craig, 2026-06-10); implementation awaiting Craig's go |
+| Status | implemented — v1 (Phases 0-4) shipped 2026-06-10 on Craig's go; manual validation + other-machine clones outstanding (todo.org) |
| Owner | Craig Jennings |
| Reviewer | Craig Jennings; Codex (2026-06-10) |
| Related | [[file:../todo.org][todo.org — "Check that memories are sync'd across machines via git"]] |
@@ -177,7 +177,7 @@ A new =claude-rules/knowledge-base.md= rule (auto-installs via the Makefile RULE
* Implementation phases
-Not started — Craig has explicitly held implementation pending his go-ahead.
+All five phases shipped 2026-06-10 (Craig's go, no-approvals batch). Completion details per phase live under the parent task in todo.org; what remains is the manual-testing child and the other personal machines' one-time clone + timer setup.
** Phase 0 — Transport migration (D8)
Resolve or delete the 63 =*.sync-conflict-*= files, move the directory out of the =~/sync/org= share to the new path, =git init= + =.gitignore= + initial commit + push to the cjennings.net remote, clone on the other personal machines (not the work machine), and set up the auto-sync timer. Update =roam-dir= in =org-roam-config.el= (handoff to the =.emacs.d= project) and sweep references to the old path (the =protocols.org= task-list pointer at =~/sync/org/roam/inbox.org=, among others) per the keep-links-current rule; a transition symlink at the old location covers stragglers. Verify: Syncthing no longer tracks the tree, org-roam indexes the new location, and an edit round-trips between two machines via the timer.
@@ -300,6 +300,11 @@ Modified recommendations from the 2026-06-10 Codex review, with reasons. Everyth
- Why: the original verification proved mechanism but not success; migration and maintenance were unspecified; and Syncthing's no-history / no-gate / conflict-fork costs were the design's weakest accepted risks — git removes them for the price of a one-time migration. The phone constraint that might have blocked Shape A dissolved: Craig's mobile pattern is on-demand doc drops, not whole-roam sync.
- Artifacts: this file; todo.org phase tasks updated (Phase 0, 1.5, and 4 added). Implementation remains held pending Craig's go.
+** 2026-06-10 Wed @ 18:21:33 -0500 — Claude (rulesets, no-approvals batch) — v1 implemented
+- What: all five phases shipped on Craig's go. Phase 0: roam migrated to =~/org/roam= as a git repo (roam.git on cjennings.net), 63 conflict files resolved by deletion (tarball backup kept), transition symlink at the old path, Emacs constants updated live, roam-sync timer running, old-path references swept. Phase 1: =knowledge-base.md= written and linked machine-wide. Phase 1.5: rulesets memories swept (3 promoted, 2 rule-encoded kept local, 1 de-staled); sweep handoff broadcast to the 10 other memory-bearing personal projects. Phase 2: the seed/doc node written and verified indexed (420 nodes). Phase 3: wrap-up promotion check + the =KB:= receipt line. Phase 4: =kb-hygiene.sh= + monthly timer, live-run verified.
+- Why: spec status was ready with all decisions ratified; Craig authorized the full batch.
+- Artifacts: rulesets commits fcf554a, d071f1f, 242b95e, b014095 (+ todo.org/spec bookkeeping); roam.git initial history; handoffs to .emacs.d, archsetup, and the 10 sweep targets. Outstanding: the manual-testing checklist and other-machine clones.
+
** 2026-06-10 Wed @ 17:31:10 -0500 — Codex — reviewer
- What changed or was recommended: re-ran the spec-review workflow after the caveat resolution. Rubric: ready. No new blocking or medium-priority findings; no review file written. Confirmed the implementation phases and test-surface tasks are already represented under the existing parent task in todo.org.
- Why: the prior blockers are dispositioned, the work-root denylist is confirmed, the pointer-rule install path matches the current Makefile RULES glob, and v1's manual/agent-runnable verification surface is explicit.