Rabbit Holes

58 documents across 1 project. Specs, blueprints, prompts, and reminders — the living documentation behind everything I build.

Wrap Long String Values in Double Quotes

Reminders

Long YAML string values — descriptions, titles with punctuation, URLs with query strings, ledes — should always be wrapped in double quotes. Cheap insurance against the entire class of YAML-syntax-collision bugs.

Astro Knots
Frontmatter YAML Conventions Property-Conventions Content-Collections

YAML Frontmatter Parsing Must Be Lenient

Reminders

Across every Astro Knots site, content frontmatter parsing must tolerate messy YAML — log a warning and skip the file, never fail the whole build. No strict YAML parsers, ever.

Astro Knots
Frontmatter Content-Collections Build-Tolerance Astro YAML +1

Ideogram Style Prefix for Splash OG Images

Prompts

Reusable Ideogram preamble that conditions generated OpenGraph and share images to match the astro-knots splash — knot-and-thread motif, the splash's three-mode palette, and an editorial typographic sensibility. Paste before your subject line.

Astro Knots
Ideogram OpenGraph Style-prefix Astro-Knots Splash

Generate a Pseudomonorepo Rollup of Changelog and Context

Blueprints

How an Astro splash site for a pseudomonorepo aggregates each child submodule's changelog/ and context-v/ into one feed — with provenance, without runtime dependencies on the GitHub API, and without auth token plumbing in CI. The deliberate-sync model: a human runs `pnpm rollup:sync`, content lands in src/rollup/, gets committed, deploys like any other static asset.

Astro Knots
Astro-Knots Pseudomonorepo Rollup Content-Collections GitHub-API +2

Build a Fundraise Deck Workspace

Blueprints

Step-by-step playbook for standing up a private, gated, two-surface fundraise/teaser deck workspace from scratch. Captures the patterns proven on sites/calmstorm-decks during the week of 2026-04-30 → 2026-05-03, written as instructions for the next site rather than as a retrospective. Use this when initializing a new client deck site under astro-knots/sites/.

Astro Knots
Fundraise-Deck-Workspace Astro-Framework Two-Surface-Architecture Narrative-Driven-Composition Polite-Gate +3

Build a Promotion Surface for Investment Opportunities

Blueprints

Architecture for a hard-gated, multi-opportunity promotion surface inside mpstaton-site. Each opportunity gets a hub page that conditionally surfaces deck and memo materials behind real authentication, optimised for AI-assisted variant iteration in 3-5 minute cycles.

Astro Knots
Promotion-Surface Hard-Gate Scroll-Deck Variant-Iteration Investment-Memo +2

Set up a Splash Page with Changelog and Context-V Rendering

Prompts

Brief prompt for scaffolding a small standalone repo (its own GitHub project, deployed to GitHub Pages) that renders its own changelog and context-v markdown through @lossless-group/lfm.

Astro Knots
LFM JSR GitHub-Pages Splash-Page Changelog +2

Codifying a Comprehensive Extended Markdown Flavor and Shared Package

Specification

A specification for a named, versioned extended markdown flavor that codifies our existing rendering capabilities, incorporates features from GFM, Obsidian, MDX, and directive-based systems, and defines a wish list for future development — all backed by a shared remark/rehype package.

Astro Knots
Markdown Extended-Markdown Remark Rehype Unified +3

Maintain a Branch-Aware LFM Dev Mode

Blueprints

A per-site swap script that lets a development branch consume @lossless-group/lfm from the local workspace while every deployable branch consumes the canonical JSR build — so production deploys can never accidentally ship a workspace link.

Astro Knots
Astro-Knots LFM JSR Workspace Vercel +1

Include Full Search as a Default

Specifications
Astro Knots

Write a Changelog Prior to Meaningful Commits

Reminders

A quick reference for writing a changelog prior to meaningful commits.

Astro Knots
Tech-Stack Astro Svelte Tailwind Preferences

Maintain an Interactive Polling System

Blueprints

Implementation blueprint for embeddable, theme-aware interactive polls on Astro SSG sites — covering data model, storage progression from flat-file to database, real-time mechanics, live-meeting authoring motions, vote integrity, and Svelte + GSAP UI contracts.

Astro Knots
Polling Interactive Live-Meetings Astro-Islands Svelte +4

Maintain an Interactive Polling System

Blueprints

Implementation blueprint for embeddable, theme-aware interactive polls on Astro SSG sites — covering Session/Poll data model, Astro DB on Turso storage, DB→markdown materialization for archive, live-meeting authoring motions, and Svelte + GSAP UI contracts. v0.0.1 ships four templates and one live session.

Astro Knots
Polling Interactive Live-Meetings Astro-Islands Svelte +6

An Internet-Friendly, Responsive UI for Long-Form Writing

Information-Design

A reader UI for publishing book-length content as a sequenced series of chapters on the FullStack VC site. The wrapper provides chapter sequencing, navigation, and reading affordances; all content-level features (callouts, citations, image directives, wikilinks) stay in the Lossless Flavored Markdown plugin where they belong.

Astro Knots
Information-Design Long-Form-Reading Reading-Experience Responsive-UI Mobile-First +15

Quirks of Obsidian Flavored Markdown

Reminders

A quick reference for the quirks of Obsidian Flavored Markdown.

Astro Knots
Tech-Stack Astro Svelte Tailwind Preferences

Maintain an Interactive `Stack` Display

Information-Design

Professionals have a stack of tools and technologies they use to get their work done. This display should show the tools and technologies in a way that is easy to browse and understand, helping others learn about the tools and technologies used in the industry — built on markdown + JSON, no database, in the spirit of AI-friendliness.

Astro Knots
Information-Design Technology-Stacks App-Adoption Interactive-Application Stack-Tracking +6

Maintain Design System and Brand Kit Motions

Blueprints

Conventions for the two reference pages every Astro-Knots site ships — Brand Kit (brand experience essentials) and Design System (component catalog) — including scope split, URL standardization, theme/mode integration contract, and maintenance motions.

Astro Knots
Design-System Brand-Kit Reference-Pages Pattern-Library Theme-Modes +1

Maintain Themes and Modes Across CSS and Tailwind

Blueprints

Implementation blueprint for dual-axis theme and mode control using Tailwind CSS v4 custom properties, with runtime utilities and Vitest verification.

Astro Knots
Themes Dark-Mode Tailwind CSS-Variables Design-Tokens +3

New Site Quickstart Guide

Prompts

Step-by-step guide for scaffolding a new Astro site in the astro-knots monorepo, from empty directory to working markdown rendering.

Astro Knots
Astro-Knots New-Site Quickstart Onboarding LFM

Sequential Steps or Tasks to Workthrough

Recurring-Prompts

You can prompt your AI Assistant via chat, but it's hard to manage a complex series of tasks that way. Even harder to retrace your steps or share your work. Thus, this recurring prompt.

Astro Knots
Astro-Knots Sequential-Steps Workflow-Management Prompt-Engineering Context-Vigilance

Create an Image-Heavy Portfolio Website for Boutique E-Commerce

Specification

A specification for a mobile-first, image-heavy portfolio site with dark and vibrant modes, carousel-driven galleries, tiered pricing cards, WhatsApp CTA, and SEO landing pages — all managed through markdown content and deployable independently from the Astro-Knots pseudomonorepo.

Astro Knots
Portfolio E-Commerce Mobile-First Image-Gallery Carousel +6

Flare: Concentric Wobble Rings

Prompts

Creative brief and technical spec for an interactive concentric-rings animation — imperfect circles radiating from an off-center origin with mouse hover repulsion and click ripple effects. Inspired by greenoaks.com.

Astro Knots
Flare Canvas Animation Interactive Concentric-Circles +2

Design System Pages Per Site

Reminders

Every site should have a design-system route with browsable pages for components, flare, and layouts — built with zero-friction by Code Assistants, not a third-party documentation tool.

Astro Knots
Design-System Site-Convention Components Flare Layouts

Flare Components — Creative Workflow

Reminders

Flare is our naming convention for design-oriented components — images, illustrations, and animations as code. This reminder covers naming, preferred tech, and the creative brief workflow.

Astro Knots
Flare Design-System Creative-Brief SVG D3 +4

Improvising within Design System Color Palettes

Reminders

A reminder to AI code assistants and developers: use named colors and design tokens; when improvising raw hex or rgba values, reintegrate them into the system.

Astro Knots
Design-System Colors Tokens CSS Themes +1

Tags Must Use Train-Case

Reminders

All tags in YAML frontmatter must use Train-Case — capitalize each word, hyphens between words, no spaces, no underscores, no all-lowercase.

Astro Knots
Tags Frontmatter Conventions Obsidian Train-Case

Implement Context-V Fetcher for mpstaton-site

Prompt

Step-by-step implementation guide for adding a build-time GitHub content fetcher to mpstaton-site that pulls context-v documents from multiple repos.

Astro Knots
Context-V GitHub-API mpstaton-site Implementation Build-Time

Context-V GitHub Fetcher for Multi-Repo Content Aggregation

Specification

A build-time content fetcher that pulls context-v documents (Specs, Blueprints, Prompts, Reminders) from multiple GitHub repositories, enabling lossless.group and mpstaton.com to render current project documentation without manual copying or submodules.

Astro Knots
Context-V GitHub-API Content-Fetching Build-Time Multi-Repo +1

Develop a Slides-only Astro Site for a Fundraise Process

Specification

A slides-only Astro site that stays consistnent with relevant Context Vigilance files fed into AI Assistant context.

Astro Knots
Astro-Framework Slides-as-Code Fundraise-Materials

Maintain an Elegant Open Graph System

Blueprints

A scalable, consistent architecture for Open Graph metadata optimized for the messaging-first share economy.

Astro Knots
Open-Graph SEO Metadata Social-Sharing Messaging

Citation System Architecture

Blueprints

A citation and reference management system for Astro sites using hex codes as stable identifiers that convert to sequential integers at render time.

Astro Knots
Citations Markdown Content-Rendering Hex-Codes

Codeblock Syntax Highlighting with Shiki

Blueprints

Blueprint for implementing syntax-highlighted code blocks across astro-knots sites using Shiki with the tokyo-night theme and reusable wrapper components.

Astro Knots
Shiki Syntax-Highlighting Code-Blocks Astro Tokyo-Night

Styles Architecture Blueprint

Blueprints

Architecture blueprint for Dark Matter's CSS and Tailwind v4 theming system, defining named brand colors, derived scales, semantic tokens, and three display modes.

Astro Knots
CSS Tailwind Theming Dark-Matter Design-Tokens

Implement Portfolio with Confidential Access in New Site

Prompts

Step-by-step implementation plan for adding portfolio features with confidential access control to the dark-matter site, based on proven patterns from hypernova-site.

Astro Knots
Portfolio Confidential-Access Dark-Matter Implementation-Plan

Page: Partner with Us

Prompts

Prompt plan for creating a tabbed Partner with Us page showcasing different LP types including corporate investors, family offices, fund of funds, and institutional managers.

Astro Knots
Partner-Page LP-Types Tabs Venture-Capital

Set Up Index and Basic Components Using Brand Theme

Prompts

A prompt plan for evolving index pages and basic components to use the brand theme system instead of hard-coded colors, with step-by-step instructions for Cascade/Windsurf.

Astro Knots
Brand-Theme Index-Page Components Dark-Matter Prompt-Plan

Astro Knots is not a True Monorepo

Reminders

A reminder that Astro-Knots is organized like a monorepo but functions as a collection of independent Astro projects for convenient pattern porting.

Astro Knots
Monorepo Architecture Astro-Knots Patterns

Preferred Stack

Reminders

A quick reference for the preferred technology stack: HTML/CSS first, Astro for SSG, Svelte for interactivity, Tailwind for styling, and no React.

Astro Knots
Tech-Stack Astro Svelte Tailwind Preferences

In The News

Specifications

Specification for a media coverage section with article display components, sidebar layout, and links to relevant press coverage of portfolio companies.

Astro Knots
Media-Coverage Articles Portfolio Press Layout

Maintain an Extended Markdown Render Pipeline for Astro-Knots

Blueprints

A simplified, Astro-Knots-specific blueprint for rendering extended markdown across sites, starting with Hypernova and Dark-Matter as first adopters.

Astro Knots
Astro-Knots Markdown Extended-Markdown Render-Pipeline

Managing Complex Markdown Content at Build Time

Blueprints

Patterns and tradeoffs for managing markdown content that lives outside an Astro project but must be available at build time, with strategies for Vercel deployment.

Astro Knots
Astro-Knots Markdown Content-Architecture Build-Pipeline

Introducing Features and UI Components

Prompts

Prompt for introducing features and UI components to the Hypernova site, including team pages, responsive design patterns, and branded exports.

Astro Knots
Features UI-Components Team-Page Responsive-Design

Removing Unnecessary Code Step-by-Step

Prompts

We have developed a number of great patterns, components, and utilities that we use on a regular basis. To start with a robust set of included functionality, we cloned The Water Foundation site (twf_site), but now need to strip out any code that is not directly related to the Hypernova brand and desired site functionality.

Astro Knots
Refactor Code-Cleanup Hypernova Site-Migration

Dynamic Webpage to Display Portfolio w Authentication

Specifications

Dynamically display portfolio information on a branded webpage, with certain types of information only displayed for certain privileges connected to authentication.

Astro Knots
Content-Automation Digital-Footprint Social-Media API-Integration

Maintain a Multi-Product Changelog with Git Modules

Marketing-Site

Organizations increasingly deliver and maintain multiple products, each necessitating its own changelog. However, as an organization its good to display those changelogs in a unified way, so that users can easily see the changes across all products and the team can feel motivation from organization-wide progress.

Astro Knots
State-Of-The-Art-Practices CI-CD-Pipelines

Maintain a Rigorous Test Suite

Marketing-Site

With AI Code Assistants on the rise, maintaining a rigorous test suite is more important than ever. Maintaining a test suite that catches regressions and ensures the website is performing as expected is a must.

Astro Knots
Acceptance-Testing Test-Driven-Development

Dynamic OpenGraph Images

Marketing-Site

As website content grows more numerous, across different audiences and different contexts, dynamically generated OpenGraph images can amplify shares and referral marketing while not bogging down the team with the need to create and maintain a separate image for each piece of content.

Astro Knots
Marketing-Site Digital-Marketing

Jumbotron Popdown Patterns

UI-Design

Design and implementation patterns for consistent jumbotron popdown menus in the Lossless UI.

Astro Knots
Component-based-Architecture Navigation-Menus UI-Design UX-Design Frontend

Maintain Embeddable Slides

Blueprints
Astro Knots
Slides-as-Code Slide-Decks Deck-Generators

Confidential Content Access Control Blueprint

Blueprints

A tiered pattern for protecting privileged or confidential content across astro-knots sites, from simple passcodes to full OAuth integration.

Astro Knots
Authentication Access-Control Confidential-Content Security Portfolio

GitHub Secure Content Pattern

Blueprints

A pattern enabling Astro sites to fetch confidential content from a private GitHub repository at runtime, keeping sensitive documents out of static assets.

Astro Knots
GitHub Secure-Content SSR Confidential Private-Repos

Slides System for Astro and Markdown

Blueprints

A comprehensive specification for building presentation slide systems in Astro-Knots sites with RevealJS, Three.js, and full theme/mode integration.

Astro Knots
Slides Presentations RevealJS Three.js Markdown

Prompts
Astro Knots

Prompts
Astro Knots

Fetch Brand and Tokens from Client Site

Prompts

Extract colors, fonts, and design tokens from a client's existing website to bootstrap theme.css with brand-aligned values. Uses curl/fetch to grab CSS and design assets.

Astro Knots
Theme Tokens Brand Client Fetch +1

Preference for Shortcuts in Config to Absolute Paths

Reminders
Astro Knots

Reminders
Astro Knots

Specifications
Astro Knots