Project Control — dv-obsidian-vault

Continue prompt

{
  "project": "dv-obsidian-vault",
  "mission": "Maintain, curate, and synchronize the operator's persistent LLM Wiki and operating manual vault (dv-obsidian-vault), ensuring continuous documentation updates across the VM101 agent fleet, refreshing outdated project statuses in projects/_index.md, maintaining the hot cache and operation logs, and preserving synchronization between sandbox mounts at /data/vault and the Gitea remote.",
  "read_first": [
    "/data/vault/CLAUDE.md",
    "/data/vault/WIKI.md",
    "/data/vault/wiki/hot.md",
    "/data/vault/wiki/index.md",
    "/data/vault/wiki/projects/_index.md",
    "/data/vault/wiki/projects/claude-obsidian.md",
    "/data/vault/wiki/meta/project-lifecycle.md",
    "/data/vault/wiki/patterns/Dispatch Decision Ledger.md",
    "/data/vault/wiki/log.md"
  ],
  "verification_anchor": {
    "command": "git -C /data/vault remote -v && git -C /data/vault status --short && ls -la /data/vault/wiki/",
    "expect": "Remote origin pointing to ssh://git@192.168.1.201:2222/dimas/dv-obsidian-vault.git on branch main, showing active working tree files (including hot.md, log.md, index.md, projects/), and directory listing of /data/vault/wiki/ containing concepts, entities, meta, patterns, preferences, projects, questions, and sources."
  },
  "project_context": {
    "what_it_is": "The central, persistent knowledge repository and operator operating manual implementing Andrej Karpathy's LLM Wiki pattern. It serves as shared long-term memory across all coding sessions and all 5 agent sandboxes on VM101, structured into 3 distinct layers: Layer 1 (.raw/ for immutable source documents), Layer 2 (wiki/ for LLM-compiled cross-referenced knowledge), and Layer 3 (CLAUDE.md, WIKI.md, and skills/ for plugin behavior and automation).",
    "domain_notes": "Hosted on VM101 internal Gitea as dimas/dv-obsidian-vault (6.87 MB). It is bind-mounted read-write into all sandbox containers at /data/vault (backed by host path /home/ubuntu/agents-switching/docker/data/vault). Background synchronization is managed by a systemd timer (vault-sync.timer running every 15 minutes to commit and push changes to Gitea). Contains live project documentation, decision ledgers (Dispatch Decision Ledger, Project Lifecycle Ledger), workflow preferences, operator profile, and architecture patterns for the entire SMS infrastructure and agent fleet."
  },
  "tech_stack": {
    "vault_format": "Obsidian Flavored Markdown with flat YAML frontmatter (type, title, created, updated, tags, status, related, sources), wikilinks ([[Page Name]]), JSON Canvas (.canvas), and CSS snippets (.obsidian/snippets/)",
    "knowledge_architecture": "3-Layer LLM Wiki Pattern (Layer 1: .raw/ immutable sources; Layer 2: wiki/ compiled knowledge graph; Layer 3: CLAUDE.md, WIKI.md, and skills/ execution engine)",
    "agent_skills_and_commands": "Claude Code Agent Skills in skills/ (wiki, wiki-ingest, wiki-query, wiki-lint, save, canvas, autoresearch, defuddle, obsidian-bases, obsidian-markdown) and custom commands in commands/ (wiki.md, save.md, canvas.md, autoresearch.md)",
    "mcp_and_api_integration": "mcp-obsidian stdio via uvx or @bitbonsai/mcpvault via npx, integrating with Obsidian Local REST API on port 27124 (requires pinned mcp<2 Python SDK)",
    "synchronization_and_storage": "Gitea git repository dimas/dv-obsidian-vault (ssh://git@192.168.1.201:2222/dimas/dv-obsidian-vault.git), systemd timer vault-sync.timer (every 15 min), and bind-mount across all VM101 sandbox containers"
  },
  "current_state": {
    "summary": "Active developing / evergreen knowledge base (6,872 KB on Gitea) with 21 documentation files across the fleet and hundreds of indexed notes. Updated daily (last commit f6aa742 on 2026-08-25T00:00:01Z; uncommitted edits currently present in hot.md, log.md, index.md, and project pages). Vault sync runs automatically every 15 minutes via systemd. Active documentation efforts include logging Project Controller M0-M5 milestones, Tailscale Funnel sidecar deployments, fleet memory caps, and project lifecycle decisions.",
    "source_of_this_status": "output/census-latest.json (gitea_repos, vault_pages) + output/judgment-2026-08-25.md (§1.8) + git status/log in /data/vault + /data/vault/wiki/hot.md + /data/vault/wiki/log.md (§2026-08-25)"
  },
  "repo_locations": {
    "sandbox_mount": "/data/vault (live bind-mount accessible inside all VM101 agent sandboxes: sbx-claude-max, sbx-claude-2, sbx-agy-suro1, sbx-agy-2, sbx-hermes)",
    "vm101_host_shared_path": "/home/ubuntu/agents-switching/docker/data/vault (underlying host filesystem location mounted to /data/vault; note: host-root /data/vault is different if unmounted)",
    "gitea_ssh_tailscale": "ssh://git@100.111.179.81:2222/dimas/dv-obsidian-vault.git",
    "gitea_ssh_lan": "ssh://git@192.168.1.201:2222/dimas/dv-obsidian-vault.git",
    "gitea_http_local": "http://localhost:3001/dimas/dv-obsidian-vault"
  },
  "key_files": {
    "/data/vault/CLAUDE.md": "Primary vault operating manual defining read order, memory policy, conventions, and flush/load/recall command protocols",
    "/data/vault/WIKI.md": "Comprehensive 3-layer architecture reference, bootstrap procedures, and schema specification for the LLM Wiki pattern",
    "/data/vault/wiki/hot.md": "Hot cache maintaining ~500-word rolling executive summary of recent fleet context, active deployments, and gotchas",
    "/data/vault/wiki/index.md": "Master catalog and categorical index of all wiki pages across concepts, entities, sources, preferences, patterns, and projects",
    "/data/vault/wiki/log.md": "Append-only chronological operation log recording all significant sessions, milestones, migrations, and fleet decisions",
    "/data/vault/wiki/overview.md": "Executive overview of vault purpose, seeded concepts/entities, key themes, and Obsidian graph integration",
    "/data/vault/wiki/getting-started.md": "Onboarding guide outlining the 3-step ingest/query workflow, hot cache mechanics, and core slash commands",
    "/data/vault/wiki/projects/_index.md": "Master project registry organizing fleet projects into Active, Ideas/Backlog, Archived, and Reference with sibling-file conventions",
    "/data/vault/wiki/meta/project-lifecycle.md": "Ledger tracking proposal, review, archival, and deletion states for fleet projects flagged by the controller",
    "/data/vault/wiki/patterns/Dispatch Decision Ledger.md": "Evidence-based score formula and log tracking accuracy and efficiency of multi-agent task dispatch",
    "/data/vault/wiki/preferences/Workflow Preferences.md": "Operator preferences, agent trust tiers (Highest/Medium/Bulk), verification standards, and never-delegate rules",
    "/data/vault/wiki/preferences/Operator Profile.md": "Agent-neutral briefing on operator profile, communication style, dialogue protocols, and system context",
    "/data/vault/skills/wiki/SKILL.md": "Core knowledge architect skill orchestrating ingestion, querying, linting, and sub-skill routing"
  },
  "next_steps": [
    "Execute continuous synchronization of documentation notes across all projects, ensuring session learnings are regularly flushed to the vault via 'flush to vault' or automated sync.",
    "Update /data/vault/wiki/projects/_index.md to refresh outdated project statuses and reflect current fleet topology (e.g. promoting Proxmox, updating agents-switching to v0.8.11, and noting sms-finance Phase 2 completion).",
    "Reconcile uncommitted working tree changes in /data/vault (hot.md, log.md, index.md, project-lifecycle.md, Proxmox.md) and commit/push them to Gitea main branch.",
    "Perform periodic wiki linting passes ('lint the wiki' / skills/wiki-lint/) to detect and fix broken wikilinks, orphaned pages, missing frontmatter fields, or contradictory claims across project notes.",
    "Maintain the Project Lifecycle Ledger (/data/vault/wiki/meta/project-lifecycle.md) as daily project-control census runs flag new drop or archive candidates."
  ],
  "constraints": [
    "Flat Frontmatter Invariant: All wiki pages must maintain flat YAML frontmatter (type, title, created, updated, tags, status, related, sources); nested YAML objects break Obsidian Properties UI.",
    "Wikilink Convention: Use [[Page Name]] syntax without file paths or file extensions for internal links; page titles/filenames 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 Operation Log: wiki/log.md is strictly append-only with newest entries prepended at the top; never edit or delete historical log entries.",
    "Vault Scope Guard: Vault content is the operator operating manual and multi-project knowledge base; never store individual project code snippets, API keys/passwords, or personal journals unrelated to workflow in the wiki.",
    "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/).",
    "Read Order Discipline: At session start, follow the prescribed read order (wiki/hot.md -> wiki/index.md -> domain _index.md -> 3-5 specific pages); do NOT read the entire wiki."
  ],
  "known_staleness_warning": "The Projects Index (/data/vault/wiki/projects/_index.md) has frontmatter updated: 2026-07-14 and still references older states (agents-switching v0.8.4, sms-finance as planning), whereas individual project pages and hot.md have been updated through 2026-08-25. Additionally, the concept note claude-obsidian.md contains a 'Current Focus' block dated 2026-04-08 referring to initial scaffolding on Windows winget, and older references in CLAUDE.md and wiki/hot.md cite a retired Gitea IP (172.24.0.2:8070) instead of active VM101 Gitea (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/CLAUDE.md + /data/vault/WIKI.md + /data/vault/wiki/hot.md + /data/vault/wiki/log.md + /data/vault/wiki/index.md + /data/vault/wiki/overview.md + /data/vault/wiki/getting-started.md + /data/vault/wiki/projects/_index.md + /data/vault/wiki/projects/claude-obsidian.md + /data/vault/wiki/meta/project-lifecycle.md + /data/vault/wiki/patterns/Dispatch Decision Ledger.md + output/judgment-2026-08-25.md"
  }
}
dv-obsidian-vault

Continue prompt

Detail

Observed Signals

1. What's Left

2. Continue / Drop Suggestion

3. Dynamic Milestone Estimate
