From 898b52edcb47bcb3e9d6106e74ca73e74ea01e70 Mon Sep 17 00:00:00 2001 From: sillylaird Date: Thu, 3 Sep 2026 00:33:59 +0000 Subject: import live www.sillylaird.ca webroot --- .../references/SCRIPT-VS-AGENT.md | 49 ++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 .agents/skills/obsidian-project-memory/references/SCRIPT-VS-AGENT.md (limited to '.agents/skills/obsidian-project-memory/references/SCRIPT-VS-AGENT.md') diff --git a/.agents/skills/obsidian-project-memory/references/SCRIPT-VS-AGENT.md b/.agents/skills/obsidian-project-memory/references/SCRIPT-VS-AGENT.md new file mode 100644 index 0000000..b066064 --- /dev/null +++ b/.agents/skills/obsidian-project-memory/references/SCRIPT-VS-AGENT.md @@ -0,0 +1,49 @@ +# Script vs Agent Boundary + +Use this guide to decide whether a task belongs in `project_kb.py` or must remain agent-driven. + +## Good fit for the script + +These tasks are low-freedom, deterministic, and should behave the same every time: + +- detect whether a repo is bound to a project vault +- bootstrap the standard vault structure +- sync repo-driven state into daily, hub, plan, memory, and auto-sync notes +- list or suggest the canonical notes to read for a question shape +- archive, purge, or rename a single note with direct-link repair in explicit index notes +- maintain source inventory and codebase overview + +Current script-facing commands: +- `detect` +- `bootstrap` +- `sync` +- `lifecycle` +- `query-context` +- `find-canonical-note` +- `note-lifecycle` + +## Must stay with the agent + +These tasks require semantic judgment and should not be hard-coded into the script: + +- deciding whether a new Markdown file is durable knowledge or raw material +- deciding whether to promote, merge, or stage a new Markdown file +- deciding which existing note is the canonical note when multiple semantic candidates exist +- synthesizing background from many project documents +- interpreting experimental meaning or result significance +- deciding whether a note should be split or merged based on conceptual overlap +- deciding whether a result is stable enough for `Results/` + +## Practical rule + +If the task can be framed as: + +- “find”, “move”, “rename”, “archive”, “sync”, or “suggest reads” + +it is probably script-suitable. + +If the task can be framed as: + +- “understand”, “interpret”, “decide meaning”, “summarize”, “merge concepts”, or “promote to durable knowledge” + +it should remain agent-driven. -- cgit v1.2.3