Pending: Replace “Claude” with “AI” or “the assistant” or something else?
User Tasks
Summary
Remove Claude-specific language from vault docs and templates so the system reads as model-agnostic.
Problem / Motivation
The LLM Portability principle in CLAUDE.md says vault content should be plain Markdown with no model-specific markup. Currently, many docs and templates reference “Claude” or “Claude Code” by name where they mean “the AI assistant.” This couples the vault’s documentation to a specific provider.
Proposed Solution
Audit and rewrite references in three tiers:
Templates (quick) — generic wording in reusable templates
System docs (medium) — architecture, glossary, workflow rewritten to describe a generic agent runtime, noting Claude Code as current implementation
Dashboards & logs (minor) — scattered references in descriptions
Personal knowledge files (thoughts.md, learning-topics.md) and external docs (external/) are excluded — those describe real experiences with Claude Code and stay as-is.
Open Questions
1. Replacement terminology
Question: What should “Claude” become in generic contexts?
Option
Description
A) “the assistant”
Natural, clear, model-agnostic
B) “the AI”
Shorter but slightly cold
C) “Opus”
The system’s own name — but Opus is the system, not the LLM
Recommendation: Option A for prose (“the assistant creates proposals”), keep “Opus” for the system itself.
Decision:
Phase Overview
Phase
Description
Status
Phase 1
Templates & quick-notes
—
Phase 2
System docs (architecture, glossary, workflow)
—
Phase 3
Dashboards & logs (minor cleanup)
—
Phase 1: Templates & quick-notes —
Goal: Make reusable templates vendor-neutral.
File
What to change
Owner
Status
vault/_templates/proposal.md:3
source: claude-code → source: ai-assistant
opus
—
vault/_templates/dashboard.md:15
”Updated by Claude after relevant changes.” → generic
opus
—
vault/90_inbox/quick-notes.md:8
”Claude picks this up each session.” → generic
opus
—
Phase 2: System docs —
Goal: Rewrite core docs to describe a generic agent runtime with Claude Code as current implementation.
File
What to change
Owner
Status
vault/00_system/docs/architecture.md
”Claude Code CLI as its runtime” → generic runtime description, note current impl