The thinking
Notes
Specs, plans, blueprints, chores. Living documentation that underwrites the code, kept in
the repo's context-v/ and rendered here when marked publishable.
Specs
- cite-wide
Modal-for-Pasting-LLM-Native-Content
-
Create an Audio Transcriber, with extra layers of value
-
Github Splash Page for Content Farm
An in-repo Astro site that turns the content-farm pseudomonorepo into a public landing page — hero, plugin gallery, changelog and context-v rendering — deployed for free off GitHub Pages while we wait for a real marketing surface.
-
Per-Directory Profile Templates — v0.1 Spike
- perplexed
Using-Files-as-Prompt-Outlines
-
Stenographer: an Obsidian Plugin that Transcribes Audio Content
Drop a YouTube, SoundCloud, or other listenable link into Obsidian and Stenographer turns it into a fully-frontmattered note with a streaming, AI-generated transcript — sources become searchable knowledge in one move.
Blueprints
- image-gin
Blueprint — Add a New Image-Generation Provider (case study: Ideogram)
- cite-wide
Citation Acquisition Pipeline — Agent Architecture, Phases, Output Contract
The HOW for filling the Lossless Citation schema. Decouples the capture moment (a URL pasted into a doc) from the canonicalization moment (the source promoted into the knowledge base). Specifies the agent that does the work: where it runs, what tools it has, what phases it executes, what it emits, how it fails gracefully, and how multiple clients (Obsidian plugin, CLI, Investment Memo Orchestrator) share the same agent.
- cite-wide
Citation Field Acquisition Guide — Per-Field Reference for Filling the Lossless Schema
The operational reference for the citation acquisition agent. For each field in the Lossless Citation schema: where the value comes from, the cheap path the agent should try first, the expensive path it falls back to, the validation rule, the failure behavior, and the publisher_types that warrant filling it. Designed to be loaded as prompt context for the agent and as a checklist for human reviewers.
- cite-wide
Maximize-Data-Collection-on-Cannonical-Sources
- cite-wide
Parse-Common-Citation-Formats
- cite-wide
Lossless Citation Standards — Schema, Audiences, Portability Thesis
The schema layer of the Lossless citation system: what fields exist, why each exists, which audiences and source types each serves, and how the schema is designed to outlive any one rendering target. This is the WHAT and WHY. For HOW the schema gets filled, see Citation-Acquisition-Pipeline.md and Citation-Field-Acquisition-Guide.md.
Plans
-
A Component Inserter
An Obsidian command that scaffolds the right block — HTML, codefence, callout, embed — at the cursor, with frontmatter-driven defaults. Makes Lossless Flavored Markdown extension blocks feel like first-class citizens of the editor instead of patterns you have to remember.
-
Auto-Hyperlink Feature Names in Generated Tables
-
Cite-Wide — dedupe inline repetition of identical hex citations
-
Create a Study of the Best Obsidian Plugins
Before we ship more plugins of our own, take a deliberate read of what's working in the Obsidian community. Catalog the plugins doing the most interesting work, what they get right, what we'd do differently, and which ideas are worth borrowing.
-
Image Drop Confirmation Gate
An Obsidian plugin that intercepts every image drag-drop and paste, then asks — before anything touches the disk or the network — where this image should go. The default is the vault. The point is to make the decision deliberate, because some of the imagery we work with is private and a chart on imgur is a phone call we don't want to make.
- image-gin
Plan — Bring Image Gin up to Obsidian Community-Plugin Publishing Standards
- perplexed
Plan — Bring Perplexed up to Obsidian Community-Plugin Publishing Standards
- perplexed
Plan — Submission Blockers Punch List (from docs.obsidian.md re-read)
Prompts
Chores
-
Renaming a Repo and managing Downstream Effects
It's not as simple as renaming the github path.
-
Tidy Naming — Repo Mentions of 'Obsidian' and 'Plugin'
Obsidian's community-plugin guidelines forbid using 'Obsidian' or 'Plugin' in the brand name (repo, manifest, README, description). Several of our repos still do. A punch list of what to rename, where, and why we held off until now.
Reminders
- cite-wide
Lossless-Citation-Spec
-
Obsidian Marketplace Compliance — Rules the Review Bot Enforces
Source-of-truth for the patterns that get a Lossless plugin past `ObsidianReviewBot` on a community-marketplace submission PR. Read before opening any re-submission, and ideally before writing the code that will be submitted. Companion to cite-wide's `Obsidian-Type-Safety.md` (which covers the `any`-rule). Distilled from the review bot's verbatim feedback on perplexed PR #12513.
- cite-wide
Obsidian Plugin Type Safety — Rules, Patterns, and Cite-Wide Conventions
Reference document for everyone (human or AI) working in the cite-wide codebase. Captures the actual rejection criteria from Obsidian's community plugin review, the patterns we use to satisfy them, and the YAML-frontmatter coercion strategy that keeps content-creator drift from breaking the type system.
- perplexed
Ideal-and-Overkill-Schema-for-Max-Flexibility
- cite-wide
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- file-transporter
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- filestarter
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- grab-reference
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- image-gin
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- lmstud-yo
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- perplexed
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
- plunk-it
This Is an Obsidian Plugin — Read the Obsidian API Docs
Reminder for any human or AI working in this codebase: this is an Obsidian plugin. The Obsidian API at https://github.com/obsidianmd/obsidian-api is the source of truth. Consult it before guessing API shapes, and re-read it whenever the community plugin review bot flags something.
Explorations
-
Citation Resolution and the Canonical Source
Three problems that look separate — link-rot recovery, smart cite-wide save with lookup-before-create, and content preservation as a future RAG corpus — are actually three operations on one underlying entity. This doc names that entity, sketches the data model, and proposes a v1 scope.
-
Enabling Obsidian Plugins to Access Homegrown API Helpers
Architecture patterns for bridging Obsidian's JavaScript environment to powerful, non-JS backend logic (Python, Rust, CLI tools) via lightweight cloud proxies.
-
Moving Beyond Simple API Calls — LLM Orchestration Options for Our Plugins
-
Using APIs to Ingest More Data
Beyond OpenGraph.io — what Jina.ai already gives us (we pay for it), what other fetching services do, and a rough sketch of how a portfolio-company site crawler would actually work.
Issues
-
Nudging AI search to return contextually appropriate images
-
Obsidian Review Bot Feedback on Perplexed Submission
- perplexed
Getting-Claude-to-Respond-With-Research
- perplexed
Updating-Naming-to-Reflect-Provider-Rebrand
-
Widening (and Re-Sizing) Obsidian Plugin Modals via CSS
- perplexed
Widening (and Re-Sizing) Obsidian Plugin Modals via CSS
General
- image-gin
Chore-to-Update-All-Dependencies
-
Migrating When an API Provider Rebrands
A vendor rebrands mid-integration — different name, different domain, sometimes different auth surface. What do you fix today, what do you leave alone, and what's the safe order? A short runbook from the day Freepik turned into Magnific.