Project Control — claude-obsidian

Continue prompt

{
  "project": "claude-obsidian",
  "mission": "Maintain and evolve the claude-obsidian plugin and active LLM Wiki vault (dv-obsidian-vault), executing ecosystem roadmap items (v1.3.0 quick wins: URL ingestion, auto-commit hook, defuddle integration; v1.4.0 delta tracking manifest) while ensuring the persistent operating manual vault remains synchronized across the agent fleet and Obsidian.",
  "read_first": [
    "/data/vault/wiki/projects/claude-obsidian.md",
    "/data/vault/CLAUDE.md",
    "/data/vault/WIKI.md",
    "/data/vault/skills/wiki/SKILL.md",
    "/data/vault/wiki/concepts/cherry-picks.md",
    "/data/vault/wiki/comparisons/claude-obsidian-ecosystem.md",
    "/data/vault/wiki/patterns/MCP Setup Pattern.md",
    "/data/vault/wiki/meta/claude-obsidian-v1.2.0-release-session.md",
    "/data/vault/wiki/hot.md"
  ],
  "verification_anchor": {
    "command": "git -C /data/vault remote -v && ls -d /data/vault/skills/* /data/vault/wiki /data/vault/.obsidian",
    "expect": "origin remote pointing to ssh://git@192.168.1.201:2222/dimas/dv-obsidian-vault.git and directory listings for skills (autoresearch, canvas, defuddle, obsidian-bases, obsidian-markdown, save, wiki, wiki-ingest, wiki-lint, wiki-query), wiki, and .obsidian"
  },
  "project_context": {
    "what_it_is": "Claude Code plugin and companion Obsidian vault system implementing Andrej Karpathy's LLM Wiki pattern. Serves as the operator's persistent memory and operating manual across all coding sessions and projects, structured into 3 layers: Layer 1 (.raw/ immutable sources), Layer 2 (wiki/ compiled knowledge base), and Layer 3 (CLAUDE.md and skills/ for plugin behavior and automation).",
    "domain_notes": "The repository at /data/vault has a dual identity: it is both the live, operational Obsidian vault (operating manual, project registries, pattern library, and hot cache synced to VM101 Gitea as dimas/dv-obsidian-vault) and the reference implementation / codebase of the claude-obsidian plugin itself. Upstream code originates from AgriciDaniel/claude-obsidian (formerly cosmic-brain v1.2.0). All agent sandboxes mount /data/vault read-write, with background synchronization handled by a systemd timer (vault-sync.timer every 15 min)."
  },
  "tech_stack": {
    "plugin_framework": "Claude Code Agent Skills format (skills/wiki/, skills/canvas/, skills/save/, skills/autoresearch/, skills/defuddle/, skills/obsidian-markdown/, skills/obsidian-bases/) and slash commands (commands/)",
    "vault_format": "Obsidian Flavored Markdown with flat YAML frontmatter, wikilinks ([[Page Name]]), JSON Canvas (.canvas), and CSS snippets (.obsidian/snippets/)",
    "mcp_server": "mcp-obsidian stdio via uvx / Local REST API on port 27124 (requires mcp<2 SDK pinning), or alternative filesystem @bitbonsai/mcpvault via npx",
    "obsidian_runtime": "Obsidian v1.12.7+, bundled community plugins (obsidian-excalidraw-plugin, obsidian-banners, obsidian-calendar-plugin, obsidian-thino), Local REST API plugin",
    "git_synchronization": "Gitea repository dimas/dv-obsidian-vault on VM101 (ssh://git@192.168.1.201:2222/dimas/dv-obsidian-vault.git), systemd vault-sync.timer (every 15 min)"
  },
  "current_state": {
    "summary": "Active developing status in the vault (updated 2026-08-25). Repository dimas/dv-obsidian-vault (6.87 MB) is hosted on VM101 internal Gitea and synced to /data/vault. The vault is actively functioning as the operator's persistent memory across the 5-agent fleet. The plugin is at v1.2.0 polish baseline following the cosmic-brain rename, with the ecosystem research feature backlog mapped in wiki/concepts/cherry-picks.md (Tier 1 quick wins pending: URL ingestion, auto-commit hook, defuddle integration).",
    "source_of_this_status": "census-latest.json (gitea_repos, vault_pages) + /data/vault/wiki/projects/claude-obsidian.md + /data/vault/CLAUDE.md + /data/vault/wiki/meta/claude-obsidian-v1.2.0-release-session.md + /data/vault/wiki/concepts/cherry-picks.md"
  },
  "repo_locations": {
    "gitea_remote": "ssh://git@192.168.1.201:2222/dimas/dv-obsidian-vault.git (or ssh://git@100.111.179.81:2222 / http://localhost:3001/dimas/dv-obsidian-vault; 6872 KB, updated 2026-08-25T00:00:02Z)",
    "vm101_host_path": "/home/ubuntu/agents-switching/docker/data/vault (mounted into all sandbox containers at /data/vault)",
    "sandbox_mount": "/data/vault (live bind-mount across all VM101 agent sandboxes: sbx-claude-max, sbx-claude-2, sbx-agy-suro1, sbx-agy-2, sbx-hermes)",
    "upstream_public_github": "https://github.com/AgriciDaniel/claude-obsidian (public distribution repo)",
    "upstream_private_github": "https://github.com/avalonreset-pro/claude-obsidian (private community repo)"
  },
  "key_files": {
    "/data/vault/CLAUDE.md": "Primary vault entry point defining read order, flush/load/recall command protocols, memory policy, scope guards, and merge rules",
    "/data/vault/WIKI.md": "Full 3-layer architectural reference and schema definition for the LLM Wiki pattern",
    "/data/vault/wiki/projects/claude-obsidian.md": "Project page defining claude-obsidian identity, key paths, focus, and MCP setup steps",
    "/data/vault/skills/wiki/SKILL.md": "Core knowledge architect skill handling vault bootstrapping, scaffolding, hot cache management, and sub-skill routing",
    "/data/vault/skills/wiki-ingest/SKILL.md": "Source ingestion skill extracting facts into sources/, entities/, concepts/, and updating indices",
    "/data/vault/skills/wiki-query/SKILL.md": "Query synthesis skill answering user queries against the compiled wiki knowledge graph",
    "/data/vault/skills/wiki-lint/SKILL.md": "Health verification skill checking for orphaned pages, broken wikilinks, and stale claims",
    "/data/vault/skills/save/SKILL.md": "Conversation capture skill serializing chat sessions into structured wiki notes",
    "/data/vault/skills/canvas/SKILL.md": "Visual diagramming skill creating and updating Obsidian JSON Canvas (.canvas) files",
    "/data/vault/skills/autoresearch/SKILL.md": "Iterative multi-source research loop for autonomous knowledge gathering",
    "/data/vault/wiki/concepts/cherry-picks.md": "Prioritized feature backlog derived from ecosystem research (Tier 1: URL ingest, auto-commit, defuddle; Tier 2: delta tracking, multi-depth query)",
    "/data/vault/wiki/comparisons/claude-obsidian-ecosystem.md": "Competitive feature matrix across 16+ Claude and Obsidian projects",
    "/data/vault/wiki/patterns/MCP Setup Pattern.md": "Setup recipes and known quirks for mcp-obsidian and Local REST API integration",
    "/data/vault/wiki/hot.md": "Hot cache file providing ~500-word executive summary of recent context across all projects and sessions",
    "/data/vault/wiki/index.md": "Master catalog and catalog index of all wiki pages grouped by category"
  },
  "next_steps": [
    "Complete Local REST API plugin setup in Obsidian (install via Obsidian Community Plugins, copy generated API key) and register mcp-obsidian via `claude mcp add-json obsidian-vault ...` with pinned `mcp<2` SDK argument.",
    "Implement Tier 1 roadmap item #1: Add direct URL ingestion to `/wiki-ingest` (`skills/wiki-ingest/SKILL.md`), fetching web content into `.raw/articles/` before indexing.",
    "Implement Tier 1 roadmap item #2: Add PostToolUse auto-commit hook in `hooks.json` targeting Write and Edit tools scoped to `wiki/` to automatically commit knowledge updates.",
    "Implement Tier 1 roadmap item #3: Integrate `defuddle` web cleaning skill (`skills/defuddle/`) into the ingestion pipeline for token-efficient article extraction.",
    "Implement Tier 2 roadmap item #4: Build delta tracking manifest (`.raw/.manifest.json`) using MD5 hashing to skip unchanged files during batch re-ingestion.",
    "Implement Tier 2 roadmap item #5: Add multi-depth query flags (`quick`, `standard`, `deep`) to `skills/wiki-query/SKILL.md`.",
    "Keep the vault memory synchronized with fleet developments across VM101 (executing `flush to vault` / `vault-sync.timer` commits to Gitea `dimas/dv-obsidian-vault`)."
  ],
  "constraints": [
    "Vault Dual Scope: Content in the vault is the Claude operating manual and multi-project knowledge base; do not store individual project code snippets, secrets/API keys, or personal journals unrelated to workflow in the wiki.",
    "Flat Frontmatter Invariant: All wiki pages must maintain flat YAML frontmatter (`type`, `title`, `created`, `updated`, `tags`, `status`, `related`, `sources`); nested YAML objects break the Obsidian Properties UI.",
    "Wikilink Convention: Use `[[Page Name]]` syntax for internal links without directory paths; page names must remain unique across the vault.",
    "Source Immutability: The `.raw/` directory contains immutable raw source documents; never edit, overwrite, or delete source files in `.raw/`.",
    "Append-Only Logs: `wiki/log.md` is strictly append-only with newest entries prepended at the top; never edit historical entries.",
    "File Ownership on VM101: Vault files at `/data/vault` are owned `node:node` on the host/mount; agents editing files in sandboxes must ensure proper file permissions (`sudo chown agent:agent <file>` before edit, `sudo chown node:node <file>` after).",
    "Merge and Sync Protocol: Always pull (`git pull --ff-only origin main`) before writing session flushes. In merge conflicts, never use `git reset --hard` or `git checkout --`; preserve both sides additively unless they strictly contradict.",
    "MCP SDK Pinning: `mcp-obsidian` requires pinned SDK dependency `mcp<2` (`args: [\"--with\", \"mcp<2\", \"mcp-obsidian\"]`); unpinned `mcp` SDK ≥2 breaks with `AttributeError: 'Server' object has no attribute 'list_tools'`.",
    "Trailing Slash Quirk: When calling `mcp-obsidian`'s `list_files_in_dir`, do not include trailing slashes (pass `wiki/entities`, not `wiki/entities/`).",
    "Machine-Local Keys: Each physical or virtual machine requires its own unique Local REST API key generated inside Obsidian; never reuse or hardcode API keys across machines."
  ],
  "known_staleness_warning": "The primary project page (`wiki/projects/claude-obsidian.md`) contains a 'Current Focus' block dated 2026-04-08 referring to initial scaffolding and Obsidian v1.12.7 on Windows winget, whereas the vault has since evolved into an actively synchronized 6.8+ MB knowledge base across VM101 with multi-agent switching context. Additionally, older references in `CLAUDE.md` and `wiki/hot.md` point to dead origin Gitea (`172.24.0.2:8070`), whereas active Gitea is on VM101 (`192.168.1.201:2222` / `localhost:3001`).",
  "handoff_metadata": {
    "created": "2026-08-25",
    "created_by": "project-control automated continue-prompt generator",
    "all_facts_sourced_from": "census-latest.json + /data/vault/wiki/projects/claude-obsidian.md + /data/vault/CLAUDE.md + /data/vault/WIKI.md + /data/vault/skills/wiki/SKILL.md + /data/vault/commands/wiki.md + /data/vault/wiki/concepts/cherry-picks.md + /data/vault/wiki/comparisons/claude-obsidian-ecosystem.md + /data/vault/wiki/patterns/MCP Setup Pattern.md + /data/vault/wiki/meta/claude-obsidian-v1.2.0-release-session.md + /data/vault/wiki/projects/_index.md + /data/vault/wiki/hot.md + /data/vault/wiki/log.md"
  }
}
claude-obsidian

Continue prompt

Detail

Observed Signals

1. What's Left

2. Continue / Drop Suggestion

3. Dynamic Milestone Estimate
