astro-knots
astro-knots/context-v/
95 files here · 56 in 6 sub-projects
Sub-projects
specs/22
Dynamic Portfolio Page Specification and Implementation Plan
Three clickable levels — logo grid, expanding card, detail page — with a passcode gate that reveals placeholders, not real data.
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.
Include Full Search as a Default
Search ships from the first build via `astro-pagefind`, not at some size threshold. Seven surfaces have it; fifteen do not.
Aggregate Changelog Streams Across the Lossless Tree via the GitHub API
One hand-maintained collection becomes a live aggregation over 38 changelog streams, each pulled from its own repo at its own branch.
Extract the Lossless Brand Layer from lossless-site
The brand is worth keeping; its token system isn't — 14 Google fonts loaded to use none. Extract it into two-tier tokens, dark by decision.
A Two-Perspective How-To Engine — Use-Cases ✕ Tool-Uses, Built on LFM (Not Starlight)
VCs arrive two ways: 'I need to automate dealflow' (a use-case) and 'I've heard I need Hermes Agent' (a tool). The same how-to should be reachable from both doors. This spec defines a docs engine on top of @lossless-group/lfm that renders one body of how-to content through two parallel navigation perspectives — with left-nav, right-hand TOC, prev/next pagination, wikilinks, callouts, citations, and video/GIF embeds — and deliberately does NOT adopt Astro Starlight.
Services Section as a Tiered, Categorized Card Catalog
A Sveltia-driven Services surface shaped Category → Card → Tier, where optional tags tick the price up before the order goes to WhatsApp.
Image Catalog and ImageKit Hosting for Arthouse
The repo stays public because it holds metadata only; ImageKit holds the bytes, and a privacy tier keeps NSFW originals out of the output.
Polish Pass for Arthouse Site
Takes arthouse-site from scaffold-complete to client-presentable, with an AI photo-to-illustration pipeline for sensitive source material.
Codifying a Comprehensive Extended Markdown Flavor and Shared Package
A named, versioned markdown flavor that codifies what we already render, backed by one shared remark/rehype package.
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.
Create an Image-Heavy Portfolio Website for Boutique E-Commerce
A mobile-first, image-heavy portfolio site: carousel galleries, tiered pricing cards, WhatsApp CTA, all managed through markdown.
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.
Context-V GitHub Fetcher for Multi-Repo Content Aggregation
A build-time fetcher that pulls context-v documents from ~20 repos, so lossless.group can render them without copying or submodules.
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.
Master Dark Matter Site Specification
The whole front end in one document — theming, mode switching, layout hierarchy, and a porting checklist specific enough that another Astro Knots site can adopt the same system by working down the list.
arthouse-site/specs
astro-knots/specs
dark-matter/specs
fullstack-vc/specs
lossless-changelog/specs
twf_site/specs
plans/6
Maintain an Authors List that Enables Naming Aliases
One person, many spellings: Michael Staton, Michael P. Staton, mpstaton. An authors list with aliases makes every byline resolve to one person.
Implement the Standard Table of Contents on mpstaton-site
The parent blueprint says every collection rendering markdown gets the same reading-position ToC. This site has five such surfaces, a hand-rolled slugify that has to go, and — as of today — the LFM version that makes it possible.
Wikilink Resolution System for LFM
LFM parses `[[Obsidian-style]]` links; each site supplies the config resolving them to local or external URLs and styling the destination.
astro-knots/plans
lossless-changelog/plans
mpstaton-site/plans
prompts/11
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.
Discuss How to Publish Long Form Like eBook
Starlight, mdBook, and Quartz all lose to hand-rolling with LFM — because the 1,751-line handbook forces LFM's wishlist forward.
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.
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.
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.
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.
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.
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.
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.
astro-knots/prompts
blueprints/25
Maintain an Elegant Open Graph System
A scalable, consistent architecture for Open Graph metadata optimized for the messaging-first share economy.
Maintain Base Engagement Analytics
Page views say someone arrived. Time on page, scroll depth and downloads say whether they read it. One definition of each, for every site.
Maintain Privacy Gates in Three Modes
One gate, three doors: a shared passcode, a verified email on the firm's list, or a link minted for one person. Each opens only what it names.
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.
Build an Upgrade Ladder Cart from Superset Tiers
Make every tier a strict superset of the one below and the cart can show you the delta instead of swapping in a whole new cart.
Continuous Integration for Astro Knots Sites
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.
Guarantee Text Wrapping and No Horizontal Bleed at Any Width
One Tailwind class caused it: `mx-auto` on a flex item disables stretch, so `<main>` sized to its content instead of its parent.
A Standard Table of Contents for Every Markdown Collection
One reading-position ToC everywhere, built on LFM's heading outline — the only source that tells a heading from a `#` inside a code fence.
Maintain Confidential Access with Persistent Sessions and Auth Telemetry
Signed pre-authed links for named stakeholders, passcodes for everyone else, and telemetry so every silent auth failure leaves a row.
Generate a Pseudomonorepo Rollup of Changelog and Context
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.
Build a Fundraise Deck Workspace
Step-by-step playbook for standing up a private, gated, two-surface fundraise deck workspace, as proven on `sites/calmstorm-decks`.
Build a Promotion Surface for Investment Opportunities
A hard-gated `/promote` hub per opportunity, surfacing deck and memo behind real auth, built for 3–5 minute variant iteration cycles.
Maintain an Interactive Polling System
Embeddable theme-aware polls on Astro SSG: data model, flat-file→database storage progression, vote integrity, Svelte + GSAP contracts.
Maintain an Interactive Polling System
Embeddable theme-aware polls on Astro SSG: the Session/Poll model, Astro DB on Turso, DB→markdown archive, Svelte + GSAP UI contracts.
Maintain Design System and Brand Kit Motions
Every Astro-Knots site ships `/brand-kit` for stakeholders and `/design-system` for developers — this is the scope split and the upkeep.
Jumbotron Popdown Patterns
Navigation dropdowns that are big enough to preview real content, and consistent enough that adding a new one is a props change rather than a new component.
Using Heartbeat Patterns to Save Session Data
`beforeunload` lies — especially on mobile — so you never really know when a reader stopped reading. Periodic still-here pings turn session duration into something you can actually measure, with no dependencies.
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.
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.
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.
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.
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.
astro-knots/blueprints
dark-matter/blueprints
reminders/14
Orient Before You Introduce a Term of Art
A reader who does not yet know what the thing is cannot learn its name. Plain question first, clinical title second — enforce it in the schema.
Preference for Shortcuts in Config to Absolute Paths
`../../../components/basics/DeckHeader.astro` breaks the moment you move the importer; `@components/…` reads the same from anywhere.
Rule to Assure Collection Schema is Flexible
A lenient Zod schema doesn't remove the failure, it moves it — the build goes green and the date renders blank instead.
Astro Frontmatter: Avoid Inline Block Comments and Risky Regex Literals
In `.astro` frontmatter, a `/* */` comment after a statement lexes as a regex literal — the error reports a column past EOF. Use `//`.
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.
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.
Write a Changelog Prior to Meaningful Commits
A quick reference for writing a changelog prior to meaningful commits.
Quirks of Obsidian Flavored Markdown
A quick reference for the quirks of Obsidian Flavored Markdown.
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.
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.
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.
astro-knots/reminders
agent-skills/2
astro-knots/agent-skills/dependency-upgrade-loop/skill
Fan out across all active Astro Knots sites, upgrade dependencies in safe → risky order (patch/minor first, then major bumps like Astro and TypeScript), fix breaking changes, verify builds with `pnpm build` + `pnpm exec astro check`, write changelog entries, and push submodules. Loops until every site is current. Invoke via `/loop` to self-pace across all sites, or pass a specific site name to target one.
astro-knots/agent-skills/generate-site-design-variants/skill
Redesign a site as N complete, genuinely different design directions built in parallel against one shared content layer — working code, two-tier theming, three-mode contract, themed image assets, consistent stack — so a stakeholder can compare them like-for-like and retiring the losers is a delete rather than a refactor. Use whenever a prospective or existing client needs a redesign pitch, whenever the user says "three directions", "design variants", "show them some options", "redesign this site", "build a spike", "competing designs", or asks to generate multiple looks for one site; also when scaffolding the chooser/brand-kit/design-system surfaces those variants need. Encodes the spine-before-pixels ordering, the one-content-layer rule, per-direction Tier 2 theme files, the single-family themed-imagery pattern, constraint-in-code, and the no-cross-imports isolation that makes variants disposable.
explorations/11
AI Photo-to-Illustration Transform for Arthouse
Exploring how to take a real client photograph — sometimes NSFW-sensitive — and return an obviously AI-generated illustrative version (anime, painterly, or stylized) that is safe to publish on the public arthouse-site portfolio.
Rethinking Confidential Access with Persistent Sessions and Auth Telemetry
The calmstorm-decks lockout — busy client, no telemetry — exposed the passcode pattern's limit: you can't tell a failed cookie from a typo.
Converge on an Animations Playbook
Lottie the format is open; every tool that produces one is proprietary SaaS. A tiered motion playbook for Astro Knots given that lock-in.
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.
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.
Web Research Agents for Content Augmentation
Point an agent at a URL and have it fill out a tool's YAML frontmatter — and why most agent-framework hype is the wrong tool for that job.
Choosing an Image Generator for Text-on-Background Banners
An April 2026 snapshot of image generators judged on one job: release-banner images with legible title text and a consistent brand feel.
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.
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.
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.
astro-knots/explorations
issues/18
Build Time Too Long
A push takes about two minutes to deploy, but Astro compiles the site in six seconds. The rest is probably refetching content from scratch.
Verifying the Wikilink Resolver Migration on mpstaton-site
The migration is written, pushed, and provably identical to the rules it replaces — but nobody has watched it resolve a single real link, because the content it needs is behind two API tokens that only exist on another machine.
Astro Check Type Errors on mpstaton-site
`pnpm build` passes while `astro check` reports 8 errors — five root causes, only one of which lossless-site shares.
Documentation Gaps Blocking New Site Onboarding
The canonical markdown package has no package.json, and the reference site uses the `workspace:*` pin CLAUDE.md forbids.
Hot Reload for Raw-Filesystem Content (across astro-knots sites)
`readFileSync` content never hot-reloads — it sits outside Astro's content layer. Needs a Vite watcher AND a dev cache bypass, not either.
Nine hand-rolled frontmatter parsers, all functionally identical
One YAML bug had to be fixed nine times. The nine copies turn out to be byte-different and behaviourally identical — the drift is brace style, nothing more.
Resolving Mode Switching Across Multiple Components
Astro scopes your `[data-mode]` selector to the component, but the attribute lives on `<html>` — it never matches. `:global()` is the fix.
Scripting Across Multiple Tables in NocoDB
Links emailAccess rows to Organizations by email domain, minting orgs as needed — via the `[linkField.id]: [{id}]` update syntax.
SSH Key Passphrase Prompts - macOS Keychain Integration
The passphrase prompt returned because `~/.ssh/config` had `UseKeychain` only under `Host gitlab.com` — a `Host *` block fixes the rest.
Images in LFM render without intrinsic dimensions
Both image paths in the LFM renderer emit an <img> with no width or height, so every image will shift the page as it loads. Latent today because no changelog has images — about to stop being latent.
Sveltia CMS — Constraints That Shape Architecture
Sveltia is not Decap: the extension points it dropped — above all the custom media library API — become silent no-ops, not errors.
Troubleshooting SSG Authentication and the Port to SSR with a 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.
arthouse-site/issues
astro-knots/issues
fullstack-vc/issues
mpstaton-site/issues
twf_site/issues
loops/3
Propagate an LFM Release Across Sites
A published @lossless-group/lfm version is not shipped until every consuming site is on it and still renders. This is the per-site cadence — bump, build, drive, changelog, commit, push submodule — run one site at a time so a bad release is caught on the first, not the fourth.
Dependency Upgrade Loop
Fan out across all active Astro Knots sites, upgrade dependencies, fix breaking changes, verify builds, write changelogs, and push — looping until all sites are clean.
astro-knots/loops
narratives/19
What the room has told us
Cover
What this is
Format
Create your account
The LPs as Co-Investors Conundrum
From Yes to Win
Cortado Demo — Claude Teams for Firm Impact
Toby Demo — OpenClaw + Obsidian for Pipeline
Track 1 · Internal Conviction → IC
Track 2 · Syndicate to VCs
Track 3 · Offer to LPs
How the breakouts run
Are you willing AND able?
Close
Narratives — 2026-05-27 Monthly All-Hands deck
fullstack-vc/narratives
mpstaton-site/narratives
mpstaton-site/narratives/lossless-palmer-ai
floaters/8
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.
arthouse-site
astro-knots
dark-matter
fullstack-vc
lossless-changelog
mpstaton-site
twf_site
sitemap/6
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.
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.
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.
astro-knots/sitemap
fullstack-vc/sitemap
tasks/4
Migrate Participant Stacks from Markdown to Turso with DB→Markdown Materialization
Stacks (current / aspirational / abandoned) live today in src/content/participants/<handle>.md and persist via GitHub App commits on every save — the same pattern the polling blueprint v2 §8.1 explicitly retired for time-sensitive data because of commit-history pollution, PEM brittleness, and concurrent-edit fragility. This task moves stacks to Astro DB on Turso as the authoritative store, with a periodic snapshot back to markdown so the build-in-public visibility stays intact. Generalizes the same materialization motion polling already uses (v2 §9), bringing two surfaces under one principled pattern.
Redesign Stack Builder with Toggleable Multi-Column Layout and Cross-Column Drag-Drop
Today's StackBuilder is a single-column 'Current stack' editor — aspirational and abandoned entries are only reachable by scrolling far below and editing the markdown frontmatter by hand. Redesign as a wider three-bucket canvas with pill toggles for which buckets are visible, two-up side-by-side view when two are active, and drag-and-drop to move tools across buckets. Cross-column moves reshape data (notes ↔ intent ↔ reason) with inline prompts so nothing is silently lost. Mobile gracefully degrades to a tap-to-move modal.
Wire Google Workspace OAuth as a Third Identity Provider
Env scaffolding for Google OAuth was added (uncommitted .env.example diff + real credentials in .env), but the code wiring was never written. This task implements the routes, session-payload union widening, header tooltip row, login button, and roster matching to bring Google to parity with the GitHub + LinkedIn providers — highest-leverage move before the May 27 All-Hands since most VC attendees convert better on Workspace than on either existing provider.
fullstack-vc/tasks