Home

Vellum Wiki

Historical archive: GitHub Issues are sole executable backlog and status ledger. Agents must not select work from wiki phase pages. Work only open issue labeled status:ready; issue body defines scope, dependencies, acceptance, and verification.

Vellum — Kritarth's local-first Electron workspace for reviewing, understanding, annotating, and analyzing papers during his Computer Science Ph.D. Inspired by anara.com, it runs on his existing Claude/Codex plans through ACP. No extra AI subscription, no raw API key.

This wiki preserves earlier architecture notes and task-card history. Current work lives in repository GitHub Issues.

Pages

• Architecture — locked decisions + system map (source of truth)
• ACP-Integration — the on-plan boundary + how to spawn adapters
• Phase-1-MVP — implemented baseline; stabilize real user journey
• Phase-2-Backlog — current research-workflow backlog
• Phase-3-Deferred — depth features
• Task-Template — the format every card follows
• Getting-Started — repo setup for contributors/agents

Current agent workflow

1. Open repository GitHub Issues and filter status:ready.
2. Never start issue labeled status:blocked.
3. Read issue scope · dependencies · acceptance · live verification.
4. Build test-first (tdd skill). Design with codebase-design / domain-modeling; research APIs with research; de-risk with prototype.
5. Run tests, typecheck, build, and actual Electron user flow. A merged component or mocked test does not prove feature works.
6. Open a PR against master with Closes #<issue>. Self-review with code-review before requesting review.
7. Operate in caveman full for prose; write code/commits/PRs normally.

Non-negotiable guardrails

• ACP, first-party only. Spawn claude-code-acp / codex-acp. Never bridge subscription OAuth into a third-party harness (banned by Anthropic, Feb 2026; actively blocked).
• No raw API key path. Auth from the signed-in CLIs.
• No Python. Pure Node/TS. No custom RAG (agent-native file tools).
• SQLite for state, files for content. Start empty (old CLI corpus lives on the archive/cli-prototype branch).