Rabbit Holes

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

Dates are UTC at rest, viewer-local at render

Reminders
Astro Knots

Versatile Component Library for Video Players

Specification

Videos links can come from various sources, and include metadata, playlists, and other information that handled to maximize the value of video content, all from simple markdown triggers.

Astro Knots
MarkdownVideo EmbedsYouTubeVimeoLoom+10

Continuous Integration for Astro Knots Sites

Blueprints

Every Astro Knots site has a deploy workflow and none has a test. That is defensible right up until a site imports package source, ships a broken link, or renders raw `[[wikilinks]]` to production — none of which a successful build notices.

Astro Knots
Continuous IntegrationGitHub ActionsAstro KnotsTestingDeployment

Guarantee Text Wrapping and No Horizontal Bleed at Any Width

Blueprints

One Tailwind class caused it: `mx-auto` on a flex item disables stretch, so `<main>` sized to its content instead of its parent.

Astro Knots
Responsive DesignCSSFlexboxLayoutDebugging+2

A Standard Table of Contents for Every Markdown Collection

Blueprints

One reading-position ToC everywhere, built on LFM's heading outline — the only source that tells a heading from a `#` inside a code fence.

Astro Knots
Table Of ContentsLFMMarkdown RenderingContent CollectionsInformation Design+3

Preference for Shortcuts in Config to Absolute Paths

Reminders

`../../../components/basics/DeckHeader.astro` breaks the moment you move the importer; `@components/…` reads the same from anywhere.

Astro Knots
ReminderTypeScriptAstroConfigImport Aliases+1

Rule to Assure Collection Schema is Flexible

Reminders

A lenient Zod schema doesn't remove the failure, it moves it — the build goes green and the date renders blank instead.

Astro Knots
FrontmatterContent CollectionsBuild ToleranceAstroZod+1

Include Full Search as a Default

Specification

Search ships from the first build via `astro-pagefind`, not at some size threshold. Seven surfaces have it; fifteen do not.

Astro Knots
SpecSearchPagefindAstroAstro Knots+1

A Reading-Position Table of Contents for LFM Articles

Information Design

LFM already hands every renderer a build-time outline; nothing renders it. One component, three viewport-driven states — left rail, hamburger overlay, mobile header — and a scrollspy that always knows which heading you're in.

Astro Knots
Information DesignLong Form ReadingLFMNavigationResponsive Design+1

Image Catalog and ImageKit Hosting for Arthouse

Specification

The repo stays public because it holds metadata only; ImageKit holds the bytes, and a privacy tier keeps NSFW originals out of the output.

Astro Knots
Arthouse SiteContent ModelImageKitImage PrivacyAstro Content Collections+1

Polish Pass for Arthouse Site

Specification

Takes arthouse-site from scaffold-complete to client-presentable, with an AI photo-to-illustration pipeline for sensitive source material.

Astro Knots
Arthouse SitePolish PassPortfolioTypographyImage Privacy+1

Astro Frontmatter: Avoid Inline Block Comments and Risky Regex Literals

Reminders

In `.astro` frontmatter, a `/* */` comment after a statement lexes as a regex literal — the error reports a column past EOF. Use `//`.

Astro Knots
AstroAstro FrontmatterEsbuildParser QuirkComments+2

Maintain Confidential Access with Persistent Sessions and Auth Telemetry

Blueprints

Signed pre-authed links for named stakeholders, passcodes for everyone else, and telemetry so every silent auth failure leaves a row.

Astro Knots
BlueprintConfidential AccessAuthenticationPersistent SessionsSigned Link Tokens+6

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
FrontmatterYAMLConventionsProperty ConventionsContent 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
FrontmatterContent CollectionsBuild ToleranceAstroYAML+1

Callout System (LFM)

Components

Three-file split for rendering Lossless Flavored Markdown callouts — structure, type registry, and mode-aware styles. Every type obeys the light/dark/vibrant mode switcher.

Astro Knots
LFMCalloutsMarkdown RenderingComponent SystemMode Aware+1

Component — Rapid Slide Search & Nav

Sitemap

Shorthand notes for a slide navigator: hover pops out the title list, and feedback runs -3 to +3 with zero deliberately omitted.

Astro Knots
Sitemap

Dynamic Portfolio Page Specification and Implementation Plan

Specifications

Three clickable levels — logo grid, expanding card, detail page — with a passcode gate that reveals placeholders, not real data.

Astro Knots
Spec

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
IdeogramOpenGraphStyle prefixAstro KnotsSplash

Generate a Pseudomonorepo Rollup of Changelog and Context

Blueprints

Deliberate sync: a human runs `pnpm rollup:sync`, each child's changelog and context-v lands in `src/rollup/`, and the build stays file IO.

Astro Knots
Astro KnotsPseudomonorepoRollupContent CollectionsGitHub API+2

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
ThemeTokensBrandClientFetch+1

Build a Fundraise Deck Workspace

Blueprints

Step-by-step playbook for standing up a private, gated, two-surface fundraise deck workspace, as proven on `sites/calmstorm-decks`.

Astro Knots
Fundraise Deck WorkspaceAstro FrameworkTwo Surface ArchitectureNarrative Driven CompositionPolite Gate+3

Build a Promotion Surface for Investment Opportunities

Blueprints

A hard-gated `/promote` hub per opportunity, surfacing deck and memo behind real auth, built for 3–5 minute variant iteration cycles.

Astro Knots
Promotion SurfaceHard GateScroll DeckVariant IterationInvestment 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
LFMJSRGitHub PagesSplash PageChangelog+2

Codifying a Comprehensive Extended Markdown Flavor and Shared Package

Specification

A named, versioned markdown flavor that codifies what we already render, backed by one shared remark/rehype package.

Astro Knots
MarkdownExtended MarkdownRemarkRehypeUnified+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 KnotsLFMJSRWorkspaceVercel+1

Author a Specification Markdown File in Context V

Prompts

The verbatim prompt behind fullstack-vc's projects page spec — and the first time the team specced a page, not a flow or feature.

Astro Knots
Prompt

Component — Message Hierachy Bare Component

Sitemap

Default copy for the FullStack VC projects hero — contextSetter through supportingTxt, plus the Propose-a-project CTA.

Astro Knots
Sitemap

Write a Changelog Prior to Meaningful Commits

Reminders

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

Astro Knots
Tech StackAstroSvelteTailwindPreferences

Maintain an Interactive Polling System

Blueprints

Embeddable theme-aware polls on Astro SSG: data model, flat-file→database storage progression, vote integrity, Svelte + GSAP contracts.

Astro Knots
PollingInteractiveLive MeetingsAstro IslandsSvelte+4

Maintain an Interactive Polling System

Blueprints

Embeddable theme-aware polls on Astro SSG: the Session/Poll model, Astro DB on Turso, DB→markdown archive, Svelte + GSAP UI contracts.

Astro Knots
PollingInteractiveLive MeetingsAstro IslandsSvelte+6

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

Information Design

A chapter-sequencing reader UI for book-length content — the wrapper owns navigation; LFM keeps every content-level feature.

Astro Knots
Information DesignLong Form ReadingReading ExperienceResponsive UIMobile First+15

Discuss How to Publish Long Form Like eBook

Prompts

Starlight, mdBook, and Quartz all lose to hand-rolling with LFM — because the 1,751-line handbook forces LFM's wishlist forward.

Astro Knots
Prompt

Quirks of Obsidian Flavored Markdown

Reminders

A quick reference for the quirks of Obsidian Flavored Markdown.

Astro Knots
Tech StackAstroSvelteTailwindPreferences

Dojo Index

Sitemap

Prompt for the dojo landing page: a 2/3 hero core-message column beside a 1/3 read-our-content CTA, system tokens only, all three modes.

Astro Knots
Sitemap

Areas of Venture | A Section with a Grid Layout

Sitemap

Build the grid section by lifting the 9-11 areas-of-venture headings straight out of the old Voodoo Handbook draft in `context-v/extra/`.

Astro Knots
Sitemap

Maintain an Interactive `Stack` Display

Information Design

A browsable display of the tools a professional uses to work — markdown plus JSON, no database, in the spirit of AI-friendliness.

Astro Knots
Information DesignTechnology StacksApp AdoptionInteractive ApplicationStack Tracking+6

Maintain Design System and Brand Kit Motions

Blueprints

Every Astro-Knots site ships `/brand-kit` for stakeholders and `/design-system` for developers — this is the scope split and the upkeep.

Astro Knots
Design SystemBrand KitReference PagesPattern LibraryTheme 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
ThemesDark ModeTailwindCSS VariablesDesign 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 KnotsNew SiteQuickstartOnboardingLFM

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 KnotsSequential StepsWorkflow ManagementPrompt EngineeringContext Vigilance

Remark-Citations: A Unified Plugin for Hex-Code Footnote Management

Specification

A standalone remark plugin that transforms footnote identifiers (hex codes, numeric, or mixed) into sequentially-numbered citations with structured metadata parsing, designed for the unified/remark ecosystem and bundled into @lossless-group/lfm.

Astro Knots
CitationsRemarkUnifiedFootnotesHex Codes+2

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

Specification

A mobile-first, image-heavy portfolio site: carousel galleries, tiered pricing cards, WhatsApp CTA, all managed through markdown.

Astro Knots
PortfolioE CommerceMobile FirstImage GalleryCarousel+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
FlareCanvasAnimationInteractiveConcentric 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 SystemSite ConventionComponentsFlareLayouts

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
FlareDesign SystemCreative BriefSVGD3+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 SystemColorsTokensCSSThemes+1

Portfolio-Wide Job Aggregator

Specification

A specification for scraping, aggregating, and displaying job openings across a venture capital firm's portfolio companies — built as a reusable pattern for any VC client site.

Astro Knots
Job AggregatorPortfolioScrapingAstroBuild Pipeline+2

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
TagsFrontmatterConventionsObsidianTrain 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 VGitHub APImpstaton siteImplementationBuild Time

Context-V GitHub Fetcher for Multi-Repo Content Aggregation

Specification

A build-time fetcher that pulls context-v documents from ~20 repos, so lossless.group can render them without copying or submodules.

Astro Knots
Context VGitHub APIContent FetchingBuild TimeMulti 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 FrameworkSlides as CodeFundraise 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 GraphSEOMetadataSocial SharingMessaging

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
CitationsMarkdownContent RenderingHex 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
ShikiSyntax HighlightingCode BlocksAstroTokyo 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
CSSTailwindThemingDark MatterDesign 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
PortfolioConfidential AccessDark MatterImplementation 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 PageLP TypesTabsVenture 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 ThemeIndex PageComponentsDark MatterPrompt 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
MonorepoArchitectureAstro KnotsPatterns

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 StackAstroSvelteTailwindPreferences

Team Pages Specification

Specifications

Agency-wide specification defining how astro-knots sites should implement data-driven team pages with role-based grouping, shared data models, and brand theming.

Astro Knots
Team PagesComponentsData ModelResponsive Design

Team Spans Page Spec

Specifications

Specification for a responsive grid layout displaying team members grouped by roles in contiguous spans with CSS Grid and consistent card styling.

Astro Knots
Team PagesCSS GridResponsive LayoutComponents

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 CoverageArticlesPortfolioPressLayout

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 KnotsMarkdownExtended MarkdownRender 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 KnotsMarkdownContent ArchitectureBuild 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
FeaturesUI ComponentsTeam PageResponsive Design

Removing Unnecessary Code Step-by-Step

Prompts

Hypernova was cloned from the Water Foundation site (`twf_site`); this is the step-by-step strip-out of everything not related to its brand.

Astro Knots
RefactorCode CleanupHypernovaSite 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 AutomationDigital FootprintSocial MediaAPI Integration

Maintain a Multi-Product Changelog with Git Modules

Marketing Site

Each product keeps its own changelog in its own submodule; the org renders them as one feed so progress reads as organization-wide.

Astro Knots
State Of The Art PracticesCI 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 TestingTest Driven Development

Dynamic OpenGraph Images

Marketing Site

Generate an OpenGraph image per page from content and variables, so shares stay on-brand without hand-making an image for every post.

Astro Knots
Marketing SiteDigital Marketing

Jumbotron Popdown Patterns

UI Design

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

Astro Knots
Component based ArchitectureNavigation MenusUI DesignUX DesignFrontend

Maintain Embeddable Slides

Blueprints

Markdown slide decks already embed via a `:::slides` directive; Astro-component decks do not — the embed route only reads `.md` files.

Astro Knots
Slides as CodeSlide DecksDeck 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
AuthenticationAccess ControlConfidential ContentSecurityPortfolio

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
GitHubSecure ContentSSRConfidentialPrivate 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
SlidesPresentationsRevealJSThree.jsMarkdown