import live www.sillylaird.ca webrootHEADmain

3 files changed, 126 insertions, 0 deletions

diff --git a/.agents/skills/obsidian-literature-workflow/references/CANVAS-WORKFLOW.md b/.agents/skills/obsidian-literature-workflow/references/CANVAS-WORKFLOW.md
new file mode 100644
index 0000000..b8ee180
--- /dev/null
+++ b/.agents/skills/obsidian-literature-workflow/references/CANVAS-WORKFLOW.md
@@ -0,0 +1,42 @@
+# Literature Canvas Workflow
+
+## Default output
+
+- `Maps/literature.canvas`
+
+## Purpose
+
+Provide a default Obsidian literature graph that:
+- keeps `Papers/` as the canonical paper-note surface,
+- keeps `Knowledge/` as the canonical synthesis surface,
+- visualizes paper-to-paper and paper-to-knowledge relationships,
+- stays lightweight enough to refresh after each major Zotero ingestion.
+
+## Default behavior
+
+- Use paper-note frontmatter and wikilinks as the primary graph source.
+- Use `Papers/*.md` and relevant `Knowledge/*.md` as file nodes.
+- Create `.canvas` by default for literature ingestion and review workflows.
+- Treat Mermaid or markdown graph notes as optional legacy companions, not the default graph artifact.
+- Prefer argument-map structure with `paper`, `claim`, `method`, and `gap` nodes over raw all-to-all paper linking.
+- Thin edges aggressively; keep only the main reasoning chain and a small number of explicit semantic paper-to-paper relations.
+- Hide or down-rank side branches when they clutter the display graph.
+
+## Refresh triggers
+
+Refresh the literature canvas when:
+- new Zotero-sourced paper notes are added,
+- paper notes gain new `linked_knowledge` edges or meaningful wikilinks,
+- knowledge synthesis notes are updated after a literature pass,
+- a batch Zotero review or note-ingestion pass finishes,
+- a full-collection normalization pass changes many paper-note relationships.
+
+## Recommended command
+
+```bash
+python3 "${CLAUDE_PLUGIN_ROOT}/skills/obsidian-literature-workflow/scripts/build_literature_canvas.py" --cwd "$PWD"
+```
+
+## Display rule
+
+- If a second lightweight showcase graph is useful, maintain `Maps/literature-main.canvas` as a filtered presentation copy rather than bloating the default working canvas.
diff --git a/.agents/skills/obsidian-literature-workflow/references/GRAPH-WORKFLOW.md b/.agents/skills/obsidian-literature-workflow/references/GRAPH-WORKFLOW.md
new file mode 100644
index 0000000..8d01f56
--- /dev/null
+++ b/.agents/skills/obsidian-literature-workflow/references/GRAPH-WORKFLOW.md
@@ -0,0 +1,26 @@
+# Legacy Literature Map Workflow
+
+This reference is kept for backwards compatibility only.
+
+## Legacy output
+
+- `Knowledge/Literature-Map.md`
+
+## Current default
+
+- Use `CANVAS-WORKFLOW.md` for the current default literature graph artifact.
+- The default graph is now `Maps/literature.canvas`, not a Mermaid note.
+- Keep this markdown workflow only when a note-based map is specifically requested or needed for compatibility.
+
+## Refresh triggers
+
+Refresh the markdown map only when:
+- new Zotero-sourced paper notes are added,
+- paper-note links or metadata materially change,
+- a batch literature review finishes.
+
+## Recommended command
+
+```bash
+python3 "${CLAUDE_PLUGIN_ROOT}/skills/obsidian-literature-workflow/scripts/build_literature_graph.py" --cwd "$PWD"
+```
diff --git a/.agents/skills/obsidian-literature-workflow/references/PAPER-NOTE-SCHEMA.md b/.agents/skills/obsidian-literature-workflow/references/PAPER-NOTE-SCHEMA.md
new file mode 100644
index 0000000..777ab4a
--- /dev/null
+++ b/.agents/skills/obsidian-literature-workflow/references/PAPER-NOTE-SCHEMA.md
@@ -0,0 +1,58 @@
+# Paper Note Schema
+
+Use this schema when normalizing or creating durable paper notes in `Papers/`.
+
+## Required frontmatter
+
+```yaml
+---
+type: paper
+title: "Paper Title"
+project: project-slug
+authors:
+  - Author A
+year: 2026
+venue: "Venue"
+doi: "10.xxxx/xxxxx"
+url: "https://..."
+citekey: "author2026paper"
+status: read
+updated: 2026-03-16T00:00:00Z
+---
+```
+
+## Recommended frontmatter for knowledge mapping
+
+```yaml
+keywords:
+  - decoding
+concepts:
+  - shared geometry
+methods:
+  - contrastive learning
+related_papers:
+  - "Papers/Neighbor-Paper"
+linked_knowledge:
+  - "Knowledge/Literature-Overview"
+  - "Knowledge/Method-Families"
+```
+
+## Recommended sections
+
+- `## Claim`
+- `## Research question`
+- `## Method`
+- `## Evidence`
+- `## Strengths`
+- `## Limitation`
+- `## Direct relevance to repo`
+- `## Relation to other papers`
+- `## Knowledge links`
+- `## Optional downstream hooks`
+
+## Working rules from real collection passes
+
+- Prefer one canonical note per paper and keep the schema aligned across the whole covered set.
+- When the user asks to check **all** papers, perform a coverage pass rather than stopping at a representative subset.
+- Use `zotero_key` as the durable join key between Zotero items and Obsidian notes.
+- Keep `Direct relevance to repo` concrete enough to drive experiments, writing, or review prioritization.