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, 2026
GSC v2: Markdown Purity + Tool Architecture
A practical architecture for human docs and agentic systems: pure Markdown for meaning, MCP/tools for action.
May 8, 2026
GSC 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, 2026
GSC v4: Practical Plan
A practical operating plan for building GSC after clarifying the Markdown, TSX, MDX, and MCP boundaries.
May 8, 2026
Boilerplate 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, 2026
Universal 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, 2026
Bookmark 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, 2026
Three 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, 2026
Content Creation GitHub Copilot Skill
Implementation plan for building a GitHub Copilot skill that enables natural language content creation
May 7, 2026
Feature 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, 2026
Content 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, 2026
Github Copilot SDK Explainer
How context awareness, reasoning between tool calls, and adaptive execution make the Copilot SDK fundamentally different from traditional automation
May 7, 2026
Debug: All CodeBlock Languages (Markdown)
Test page for every configured CodeBlock language rendered through the markdown pipeline.
May 7, 2026
Epic 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, 2026
AI 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, 2026
Feature 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, 2026
Intelligent Component Designer API
Design document for an AI-powered component composition system using LLM intelligence with deterministic, type-safe output
May 7, 2026
LLM 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, 2026
Markdown Table Test
Testing GFM table syntax rendering with primitive table components.
May 7, 2026
Content Architecture: TSX-First with MD Fallback
TSX-first content system with markdown fallback: embracing coupled content and logic
May 7, 2026
backlog-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, 2026
Feature Spec: Project Launchpad System
Frictionless system for showcasing development projects - make adding new projects feel as easy as publishing a blog post
May 7, 2026
Feature 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, 2026
Bottom 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, 2026
Feature 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, 2026
Time-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, 2026
TODO: Decide on /docs routing strategy
Figure out whether to create dedicated /docs page or surface all docs on homepage via Navigator
May 7, 2026
TODO: Add hideHeader metadata field
Add optional metadata field to hide ContentHeader component for non-standard pages like about-me
May 7, 2026
Todo System Organization & Status Tracking
Design patterns and status tracking improvements for managing todos-as-content-pages.
May 7, 2026
Update Authorship Metadata Across All Posts
Action plan to standardize authorship metadata and workflow transparency across all posts.
May 7, 2026
Content System Vision
A unified content model where every item is a source plus commentary, rendered differently based on type.
April 16, 2026
Pool 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, 2026
Stack
The full technology stack behind jaygriff.com — what's used, why it was chosen, and how it all fits together.
April 8, 2026
Sidebar Logo Squish Investigation
Why sidebar logos get compressed while icons stay perfect: a CSS selector mismatch between <svg> and <img> elements.
April 7, 2026
Backlog
Open and completed tasks for website development and bug fixes
April 7, 2026
Canon: A Personal Tracker for Creator Content Consumption
A gamified system for tracking your progress through your favorite creators' complete bodies of work.
April 7, 2026
jaygriff-v2 — File Tree
Complete annotated file tree documentation for the jaygriff-v2 project architecture
April 5, 2026
Admin UI Plan
Two-phase plan for building a simple admin interface with password auth now and passkey upgrade later.
April 3, 2026
Block Model Architecture
Why chunking Markdown into structured blocks unlocks vector search, WYSIWYG editing, and inline search results.
April 3, 2026
Projects Architecture
Introducing Projects as a first-class organizing concept to give docs, posts, and demos the context they need.
April 2, 2026
Styling Conventions
How styling works in this project — CSS modules, cn(), theme variables, and the rules that keep it consistent.
April 2, 2026
Content 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, 2026
Admin UI + Passkey Auth Plan
Building a local admin interface with passwordless WebAuthn authentication using Bitwarden's passwordless.dev service.
March 30, 2026
Architecture
A filesystem-first content architecture with AI-generated metadata, Turso indexing, and dynamic routing.
March 30, 2026