Docs
Reference material, technical notes, and how-tos.
GSC: Generated Semantic Companion
The architecture for content systems that serve humans, agents, and LLMs equally well: pure Markdown, deterministic tools, clear boundaries.
May 8, 2026GSC v2: Markdown Purity + Tool Architecture
A practical architecture for human docs and agentic systems: pure Markdown for meaning, MCP/tools for action.
May 8, 2026GSC v3: Markdown, TSX, MDX, and the Real Boundary
The practical architecture: Markdown for durable meaning, TSX for behavior, MCP/tools for action. MDX is optional and often unnecessary.
May 8, 2026GSC v4: Practical Plan
A practical operating plan for building GSC after clarifying the Markdown, TSX, MDX, and MCP boundaries.
May 8, 2026Boilerplate Setup Wizard: Design Doc
Architecture and UX plan for a standalone CLI tool that scaffolds new projects from the boilerplate via a web UI wizard.
May 7, 2026Universal Metadata + Template Editor for My Content
My next evolution for AI-assisted content operations: generate structured documents with rich metadata, edit them quickly in a dedicated review surface, and publish high-quality artifacts in under a minute.
May 7, 2026Bookmark Launcher: Multi-Tab & Local File Support
Debugging notes on building a bookmark that opens two URLs simultaneously in separate tabs — what Chrome blocks, what works, and why.
May 7, 2026Three Pages With No Title Tag (And Why I'm Leaving Them That Way For Now)
I wired up page title metadata across the whole site — except for three pages that use 'use client'. I know the fix. I don't want to do it yet. Here's everything documented so I can come back to it.
May 7, 2026Content Creation GitHub Copilot Skill
Implementation plan for building a GitHub Copilot skill that enables natural language content creation
May 7, 2026Feature Spec: Dev-Mode WYSIWYG Content Editor
A development-only inline content editor for markdown files that enables quick content updates without manually editing files in an IDE.
May 7, 2026Content Layer: Current System Documentation
Reference doc for the SQLite migration. Captures exactly how the current filesystem-based content system works, where the pain points are, and what each function actually does.
May 7, 2026Github Copilot SDK Explainer
How context awareness, reasoning between tool calls, and adaptive execution make the Copilot SDK fundamentally different from traditional automation
May 7, 2026Debug: All CodeBlock Languages (Markdown)
Test page for every configured CodeBlock language rendered through the markdown pipeline.
May 7, 2026Epic Dev Routes - Your App as Your Tooling Layer
Stop building separate tools - use Next.js /dev/* routes to turn your entire app into a personal productivity layer with hot reload, TypeScript safety, and zero deployment overhead
May 7, 2026AI Life Logger - Product Vision
A frictionless life logging and time tracking system using natural language AI interface for effortless tracking and behavioral insights
May 7, 2026Feature Spec: /live — Personal Microblog Feed
Spec for a /live route — a personal microblog feed powered by a write API and SQLite, postable from anywhere including a phone.
May 7, 2026Intelligent Component Designer API
Design document for an AI-powered component composition system using LLM intelligence with deterministic, type-safe output
May 7, 2026LLM SEO Implementation Roadmap
A practical guide to optimizing your site for AI-powered search and LLM discoverability - actionable strategies for appearing in ChatGPT, Claude, Perplexity, and other LLM-generated responses
May 7, 2026Markdown Table Test
Testing GFM table syntax rendering with primitive table components.
May 7, 2026Content Architecture: TSX-First with MD Fallback
TSX-first content system with markdown fallback: embracing coupled content and logic
May 7, 2026backlog-this Command
A focused workflow for capturing ideas into backlog storage when I intentionally want to stop implementing and preserve context for later.
May 7, 2026Feature Spec: Project Launchpad System
Frictionless system for showcasing development projects - make adding new projects feel as easy as publishing a blog post
May 7, 2026Feature Spec: Full-Text Hybrid Search with SQLite FTS5
Replacing Fuse.js title-only search with server-side full-text search using SQLite FTS5 — paragraph-level results with highlighted snippet previews linking directly to headings.
May 7, 2026Bottom Taskbar with Persistent Search
A taskbar-style bottom navigation pattern that keeps search accessible in the mobile thumb zone and provides app-like ergonomics.
May 7, 2026Feature Spec: Content Thumbnail Metadata System
Add visual thumbnail support to all content types (posts, projects, pages) for improved visual appeal, social sharing, and user engagement
May 7, 2026Time-Blocking App Prompt Injection Security
Security design notes for preventing prompt-injection abuse in a natural-language time-blocking app via AI intent validation.
May 7, 2026TODO: Decide on /docs routing strategy
Figure out whether to create dedicated /docs page or surface all docs on homepage via Navigator
May 7, 2026TODO: Add hideHeader metadata field
Add optional metadata field to hide ContentHeader component for non-standard pages like about-me
May 7, 2026Todo System Organization & Status Tracking
Design patterns and status tracking improvements for managing todos-as-content-pages.
May 7, 2026Update Authorship Metadata Across All Posts
Action plan to standardize authorship metadata and workflow transparency across all posts.
May 7, 2026Content System Vision
A unified content model where every item is a source plus commentary, rendered differently based on type.
April 16, 2026Pool Tracker — Public Read / Private Write Plan
Architecture plan for migrating a pool dashboard from localStorage to Turso with passphrase-protected writes and public reads.
April 12, 2026Stack
The full technology stack behind jaygriff.com — what's used, why it was chosen, and how it all fits together.
April 8, 2026Sidebar Logo Squish Investigation
Why sidebar logos get compressed while icons stay perfect: a CSS selector mismatch between <svg> and <img> elements.
April 7, 2026Backlog
Open and completed tasks for website development and bug fixes
April 7, 2026Canon: A Personal Tracker for Creator Content Consumption
A gamified system for tracking your progress through your favorite creators' complete bodies of work.
April 7, 2026jaygriff-v2 — File Tree
Complete annotated file tree documentation for the jaygriff-v2 project architecture
April 5, 2026Admin UI Plan
Two-phase plan for building a simple admin interface with password auth now and passkey upgrade later.
April 3, 2026Block Model Architecture
Why chunking Markdown into structured blocks unlocks vector search, WYSIWYG editing, and inline search results.
April 3, 2026Projects Architecture
Introducing Projects as a first-class organizing concept to give docs, posts, and demos the context they need.
April 2, 2026Styling Conventions
How styling works in this project — CSS modules, cn(), theme variables, and the rules that keep it consistent.
April 2, 2026Content Pipeline: Technical Deep Dive
Technical reference for the content pipeline covering Turso schema, sync script, AI metadata generator, markdown renderer, and route architecture.
April 2, 2026Admin UI + Passkey Auth Plan
Building a local admin interface with passwordless WebAuthn authentication using Bitwarden's passwordless.dev service.
March 30, 2026Architecture
A filesystem-first content architecture with AI-generated metadata, Turso indexing, and dynamic routing.
March 30, 2026