diff options
Diffstat (limited to '')
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. |