Notes

Dynamic-Portfolio-Page-Specification-and-Implementation-Plan

Codifying a Comprehensive Extended Markdown Flavor and Shared Package

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.

Context-V GitHub Fetcher for Multi-Repo Content Aggregation

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.

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

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.

Master__Dark-Matter-Site-Specification

Team-Page-Living-Spec

Develop a Slides-only Astro Site for a Fundraise Process

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

Dynamic Webpage to Display Portfolio w Authentication

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

In The News

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

Include Full Search as a Default

Portfolio-Wide Job Aggregator

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.

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

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.

Versatile Component Library for Video Players

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.

Build a Fundraise Deck Workspace

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/.

Build a Promotion Surface for Investment Opportunities

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.

Citation System Architecture

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

Codeblock Syntax Highlighting with Shiki

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

Confidential Content Access Control Blueprint

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

Jumbotron-Popdown-Patterns

Using-Heartbeat-Patterns-to-Save-Session-Data

Generate a Pseudomonorepo Rollup of Changelog and Context

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.

GitHub Secure Content Pattern

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

Jumbotron Popdown Patterns

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

Maintain an Elegant Open Graph System

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

Maintain an Interactive Polling System

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.

Maintain an Interactive Polling System

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.

Maintain Confidential Access with Persistent Sessions and Auth Telemetry

A server-gated, DB-backed access pattern for client-content workspaces: signed pre-authed links for direct stakeholders, two-role passcodes for everyone else, durable telemetry on every attempt, and a downstream-sharing attribution hack — designed so a busy client clicks once and stays in, and so every silent failure leaves a row we can investigate.

Maintain Design System and Brand Kit Motions

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.

Maintain Embeddable Slides

Maintain Themes and Modes Across CSS and Tailwind

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

Slides System for Astro and Markdown

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

Styles Architecture Blueprint

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

Wikilink Path Audit — mpstaton-site

Every Obsidian-style wikilink in mpstaton-site's content, grouped by top-level prefix. Edit each entry to set `path_resolved: true` and fill in `resolved_url`; the collected mappings become the EXTERNAL_DESTINATIONS config for the site's wikilink resolver.

Wikilink Resolution System for LFM

A two-layer wikilink rendering system: LFM provides the abstract MDAST plugin that parses [[Obsidian-style]] backlinks; each Astro Knots site provides a config that resolves those wikilinks to local-or-external URLs and gives them visual treatment that signals the destination.

Author-a-Specification-Markdown-File-in-Context-V

Discuss-how-to-Publish-Long-Form-like-eBook

Fetch Brand and Tokens from Client Site

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.

Flare: Concentric Wobble Rings

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.

Ideogram Style Prefix for Splash OG Images

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.

Implement Context-V Fetcher for mpstaton-site

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

Implement Portfolio with Confidential Access in New Site

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.

Introducing Features and UI Components

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

New Site Quickstart Guide

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

Page: Partner with Us

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.

Removing Unnecessary Code Step-by-Step

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.

Sequential Steps or Tasks to Workthrough

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.

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

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.

Set Up Index and Basic Components Using Brand Theme

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 is not a True Monorepo

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

Rule-to-Assure-Collection-Schema-is-Flexible

Design System Pages Per Site

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.

Flare Components — Creative Workflow

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.

Improvising within Design System Color Palettes

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.

Preference for Shortcuts in Config to Absolute Paths

Preferred Stack

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

Quirks of Obsidian Flavored Markdown

A quick reference for the quirks of Obsidian Flavored Markdown.

Tags Must Use Train-Case

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

Wrap Long String Values in Double Quotes

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.

Write a Changelog Prior to Meaningful Commits

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

YAML Frontmatter Parsing Must Be Lenient

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.

Choosing-the-Right-DataStores

Choosing an Image Generator for Text-on-Background Banners

A snapshot of the AI image-generation landscape as of April 2026, focused on the specific job of producing release-banner-style images with legible title text and brand-consistent visual style — the kind of asset Anthropic, Windsurf, Linear, and Vercel attach to changelog entries and release announcements.

Converge on an Animations Playbook

A short, well-made motion loop can do work that a paragraph and a screenshot can't — but the tooling that produces Lottie files is concentrated in a few mostly proprietary places. This is a tour of the format, the production tools, the honest lock-in, and a tiered playbook for the Astro Knots family.

Exploring GitHub Actions for Package Publishing

A practical walkthrough of what GitHub Actions are, how they work, and how to use them to publish packages to JSR and GitHub Packages with provenance — written for someone who has never set up CI/CD before.

Gate Sensitive Information with a Simple Code

Implementing Full-Text Search by Default

Every Astro Knots site should ship with full-text search out of the box. This is a tour of what that costs, why Pagefind (a Rust-powered static indexer) is the strong default, and what the runner-up libraries are for the cases where it isn't.

New Homebrew Formulae Worth Knowing About

A quick-hit survey of six new Homebrew formulae — dispenso, jsongrep, opentimestamps-client, proxelar, qtcanvaspainter, and qttasktree — with an honest assessment of what each does and whether our dev team should care.

Practices to Sense-Make Context Vigilance at Scale

An exploration of lightweight conventions, indices, templates, and tooling that keep a context-v library legible as it grows from dozens to hundreds of documents — without introducing a new system to maintain.

Rethinking Confidential Access with Persistent Sessions and Auth Telemetry

The hypernova/dark-matter passcode pattern got us shipping, but the calmstorm-decks lockout — busy client, no telemetry, can't tell whether the cookie failed or the passcode was mistyped — exposes its limits. This exploration scopes the decisions for a v2 confidential-access shape: persistent (FB-style) sessions, durable auth telemetry, and a topology that keeps Astro SSG for content while letting a thin server tier own auth and identity.

Understanding the JavaScript Runtime and Package Manager Landscape

A ground-up exploration of what Node, Deno, Bun, npm, pnpm, Yarn, Vite, tsup, and esbuild actually are, why they exist, how they relate to each other, and when to use which — because the JavaScript ecosystem never explains itself.

Web Research Agents for Content Augmentation

When a community member adds a tool we haven't authored content for, we want to point an agent at a URL or company name and have it fill out the YAML frontmatter. Here's what shipping that actually looks like in 2026 — and why most of the "agent framework" hype is the wrong tool for the job we have today.

Exploring Publishing Component Library for VC Firms

Strategic exploration of publishing @knots packages as a component library for venture capital firms, evaluating approaches from Web Components to shadcn-style CLI distribution.

Component__Message-Hierachy-Bare-Component

Component__Rapid-Slide-Search-&-Nav

dojo_index

Section__Areas-of-Venture

Callout System (LFM)

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.

Section__Areas-of-Venture

Page Spec — projects/index.astro & projects/[slug].astro

A specification for the FullStack VC Projects page (gallery + detail), the supporting content collection, the Hero and Project Gallery section components, and the Jumbo Popdown that surfaces projects from the site header.

Reach Education Hub — `/` Index Page Brainstorm

Working doc on what the hub homepage communicates, who it serves, and the order of the scroll. Brainstorm, not a spec.

Team Pages Specification

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

Team Spans Page Spec

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

Perspectives & Practice (Voodoo Handbook) Class 20 Living Draft

Context-V — Context Vigilance for AI-Native Software Teams

A working library of the documents we feed to Claude Code so we can build sites, apps, and design systems at remarkable speed — and a directory schema that keeps that library legible as it grows.

Papermark Self-Hosted Dataroom Deployment

Complete deployment specification for self-hosting Papermark as an open-source virtual data room for sharing investment memos, pitch decks, and due diligence documents.

Updates-for-April-2026

Astro-Check-Type-Errors-on-mpstaton-site

Documentation-Gaps-Blocking-New-Site-Onboarding

Hot-Reload-for-Raw-Filesystem-Content

Issue-of-Saving-Stack-Edits

Resolving-Mode-Switching-Across-Multiple-Components

Scripting-across-Multiple-Tables-in-NocoDB

SSH-Key-Passphrase-Prompts

Workspace-vs-JSR-for-LFM-Consumers

Troubleshooting-SSG-Authentication-and-Port-to-SSR-w-Database

Optimize for Localized OpenGraph Metadata and Banner Image with Overlay

We want WhatsApp / iMessage / Twitter shares of any project page to surface a banner image that's visibly *about that project* — title baked in, not just a generic site-wide image. Today we have project-specific title and description in the OG meta tags but a shared placeholder image. Documents the four paths to a fix and the trigger that should reopen this work.

01-disclaimer-confidential

02-vision-mission

03-venture-team

04-identity-pillars

05-problem-intro

06-opportunity-intro

07-market-momentum

08-european-landscape

09-firm-positioning

10-track-record

11-investment-team-LPAC

12-competitive-advantage

13-community-portfolio-service

14-success-in-numbers

15-portfolio-snapshot

16-portfolio-construction-product-offering

17-fund-terms