Lost in Public
content/lost-in-public/context-v/
180 files here
prompts/90
Integrate a Sources content collection.
Enhance our content through a new collection of sources, including books, people, events, lectures, media, meetings, reports, source extracts, ugc communities, and more.
Be Creative with this Marketing Copy
Here's some messaging we want some creative thinking around. Expand on the messages and create a UI with good information design.
Repurpose Functionality from React to Astro
When you've built functionality several times it can feel like a slog to rewrite. Let AI Code Generators do it Step by Step.
YAML Frontmatter Corruption Correction
Automated tool for identifying and repairing corrupted YAML frontmatter across the content library
Create Storytelling Patterns through sequences of Markdown Files
Using an ordered list of markdown files, create a UI that tells a story of moving from one file to the next through the series.
Remark Plugin Implementation Plan for Astro Content
Create a custom remark plugin to enhance markdown processing in Astro with extended syntax features
Move functionality and style of Concepts and Vocabulary into specific components
We should use astro components as best we can, and try to keep styles managably within their own components
Fetch Open Graph Data from API
Create a Node.js script to process Markdown files and fetch OpenGraph metadata and screenshots from external APIs
Fetch Open Graph Data from API
Create a Node.js script to process Markdown files and fetch OpenGraph metadata and screenshots from external APIs
Add a Site Preview to ToolKit Tool Card
Make your site more useful by adding a site preview using HTML iFrames and OpenGraph.io
Ask a Model API to Perform a Task via API
Guidelines for making API calls to LLM services like Claude, GPT-4, and Groq
Ask Generative AI Model to Generate a Style
Generate a custom style object for image requests using a Generative AI model. This prompt is for scripting and API integration workflows.
Introduce a New Feature to the Observer System
Enhance the observer system by introducing new functionality.
Ask a Model API to Perform a Task via API
Guidelines for making API calls to LLM services like Claude, GPT-4, and Groq
Frontmatter consistency through filesystem observer
Leverage the file system libraries to observe directories for new files, insert frontmatter templates.
Create a Basic Changelog
Guidelines for creating and maintaining a structured changelog
Repurpose Functionality Found Elsewhere into an Obsidian Plugin
When you've built functionality several times it can feel like a slog to rewrite. Let AI Code Generators do it Step by Step.
Technical Specification - Custom Code Block Rendering in Astro
Enhance markdown rendering with specialized components for custom code languages, ensuring graceful fallbacks and maintainable styling
Implement a Comprehensive Code Block Rendering System in Astro
Brief description of the prompt functionality and purpose
Create a Canvas UI of our Content and Data Models
Visualize content and data models using JSON Canvas
Create a Changelog UI
Design and implement a modern, user-friendly changelog interface that handles both code and content changes
Reintroduce something that worked.
Speed up time to solution by asking an AI Code Assistant to draw from old code.
Integrate citations format and unique Hex into filesystem observer
Leverage Node.js filesystem APIs to monitor content directories, automatically transform citations into unique Hex values and create or update Footnotes section.
Implement a specific task described in this Prompt as part of larger specification
Specifications are too large to use as prompts. Prompts are missing the larger context. Resolve the two by using both a Prompt and a Specification.
Create a New Layout for an Existing Content Collection
Use existing logic and content, already working, to create and implement a new layout design.
Integrate a new content collection to our content rendering system.
Enhance our content base with a new collection of content.
Fire up the Observer
Ready to automate? Learn how to launch the Observer system for seamless citation and frontmatter processing across your content library.
Ask Local LLM to be a Copywriter and generate content and metadata.
Use a local LLM to generate content and metadata for Markdown files in a content directory. This prompt is for scripting and content automation workflows.
Enhanced Filesystem Observer with Prompts and Specifications Support
Extend the filesystem observer to monitor prompts and specifications directories, validating frontmatter against templates and preparing for publication
Comprehensive AST Transformation Pipeline
A robust approach to AST transformations inspired by astro-big-doc and content-structure patterns
Rendering Extended Markdown through AST
An alternative approach to rendering callouts and citations by working directly with the AST nodes
Consolidate Multiple Documentation Sources into One Source
Consolidate multiple documentation sources into a single, cohesive source.
Implement a Comprehensive Mermaid Chart Rendering System in Astro
Brief description of the prompt functionality and purpose
Suggest a Non-Destructive Refactor
Provide recommendations for improving code organization and structure while preserving functionality and maintaining existing patterns
Suggest a Non-Destructive Refactor
Provide recommendations for improving code organization and structure while preserving functionality and maintaining existing patterns
Integrate new content thread by creating a template
Use Astro Collections, audit frontmatter, and create template that can be used in Scripts, Observers, and Watchers
Write a Comprehensive Git Squash-Merge
A step-by-step, human-readable workflow for safely squash-merging development into master in a multi-contributor project.
Create a permanent memory for project YAML conventions
Eliminate frustration by observing guidelines, working within hard rules and constraints, and learning to detect YAML irregularties that could cause bugs and failures
Manageable User Options
Configure and manage user options for build scripts and content processing
Move styles from Tailwind to CSS using our styles
We use Tailwind for speed and compact readability, but as we move to Astro, we should use CSS and try to maintain our CSS architecture
Streamline Interaction Design in CSS States
Create consistent, maintainable, and extensible patterns for CSS animations and transitions across components
Citation Processing for FileSystem Observer
In the tangled web of academic references, a robust citation processing system transforms chaotic footnotes into a harmonized knowledge registry, ensuring every intellectual debt is properly acknowledged and seamlessly tracked.
Known YAML Errors and Fixes Registry
Automated detection and correction system for common YAML frontmatter errors in Markdown content
Pull YAML properties from a diverged content collection, and merge them.
When content libraries diverge, and both libraries have important data and content, write a script that merges the matching files based on most recent or robust frontmatter and content.
Frontmatter consistency through filesystem observer
Leverage Node.js filesystem APIs to monitor content directories, automatically validate and update frontmatter based on templates
Writing Correction Functions
Create functions to fix known YAML errors in content files
Our Extended Markdown Requirements as a Micromark Extension
Implement our proprietary extended markdown flavor as a micromark extension—bypassing remark, rehype, and all unified abstractions.
Dynamic Information Page Rendering in Astro
Empower developers to focus on layout and let MDX do the content and interaction
Create a Dynamic Footer
Design and implement a modern, user-friendly dynamic footer interface that handles both code and content changes
Use Magazine Style Layout for new Specs Collection
Use a magazine-style layout for the new Specs Collection, reusing as many components and render pipeline as possible.
Create a Simple Message Grid
Build a maintainable component pipeline for rendering simple messages dynamically generated from JSON data.
Create a Simple Question Answers Section
Build a maintainable component pipeline for rendering simple questions and answers dynamically generated from JSON data.
Report on YAML Idiosyncracies
Write or run a script that iterates through content libraries and reports on YAML idiosyncracies.
Configure Yamllint based on our patterns.
Use a smart library, Yamllint, to audit and fix our YAML frontmatter based on our specified patterns.
Create a Content Registry Script
Build a registry system for tracking and managing Markdown files
Create or Update Open Graph Data
Build a script to fetch and update Open Graph metadata for content files using a simple build orchestrator
Fix one YAML Issue at a Time
Create a focused script to identify and fix individual YAML issues in frontmatter without causing cascading problems
Fix one YAML Issue at a Time
Systematic approach to cleaning URL properties in YAML frontmatter
Integrate OpenGraph fetch into filesystem observer
Leverage Node.js filesystem APIs to monitor content directories, automatically fetch OpenGraph metadata and update frontmatter
Return only files with valid Frontmatter
Filter and validate markdown files based on frontmatter content
Conditional Logic for Content
Implement conditional rendering based on content status and user roles
Integrate the Concepts series into the "more-about" routing
Enhance the "more-about" path with Concepts as well as Vocabulary
Create a Variant of an Existing Component
The component we have is great, but we need a variant of it.
Create Fallbacks, Error, and Waiting Components
Ideal, immediate renders are not always possible. We need to create components that handle these situations gracefully. They should be clever and on-brand.
Handle Citations in Markdown Content
Handle citations in markdown content by extracting them and rendering them in a structured format
Handle iFrames in Markdown Content
Handle iFrames in markdown content by pulling them out before other content processing, then adding them back to the AST before rendering.
Integrate the Concepts series into the "more-about" routing
Enhance the "more-about" path with Concepts as well as Vocabulary
Rendering Callout Blocks with Classes
Several forms of extended markdown make heavy use of callout blocks, which can be rendered with combinations of Astro Components, Semantic HTML, and CSS classes
Rendering Extended Markdown like Astro-Big-Doc
A simplified approach to rendering callout blocks by following astro-big-doc pattern of component-based AST handling
Add Sort by Functionality to Tag Column
Make the tag column more powerful by allowing different kinds of sort patterns
Create a Hero Component
Design and implement a modern, user-friendly hero component with gradient effects, responsive design, customizable content, and smooth scroll-based animations.
Create a Price Card
Design and implement a responsive pricing card component with modern styling
Create a Reusable Content Collections UI Structure
Build a maintainable component pipeline for rendering content collections with separated structure and presentation
Create a Vocabulary Collection render pipeline
Build a render pipeline for vocabulary using the component pipeline for rendering content collections with separated structure and presentation
Get UI Inspiration From URL
Analyze and extract design patterns and UI components from external websites for inspiration
Render Site Flavored Markdown
Render site flavored Markdown in layers with Marked Extensions
Repurpose a UI Template in our Codebase
Adapt and reuse existing UI components and templates for new features
Cleaning Build Scripts
Improve build scripts by following strict naming conventions and error handling patterns
Create a Content Generation Engine
Build a RAG-based content generation system with multi-model API integration
Ask the AI Code Assistant to Improve your Prompts
Takes one to know one. Ask the AI Code Assistant to improve your prompt before you ask it to execute it.
Resolving Local SVG Image Rendering Issues in Astro
Troubleshooting and fixing SVG images not rendering from the public directory
Use an LLM Gateway to Augment Content
Create the content of a thousand content marketers with an LLM Gateway -- LiteLLM, Fabric, Ollama, MSTY
Write a Code Changelog Entry
Create structured and informative changelog entries for code changes
Write a Changelog Entry
Create structured and informative changelog entries for code changes
Write a Git Commit for one Directory
Create structured and informative git commit messages for code changes
Write a meaningful but concise git commit.
Make Git and GitHub work better for your team by leveraging LLM Code Assistants.
Write a Technical Specification with a Standard but Evolving Style
Create comprehensive technical specifications for completed tasks and features
Write an note that leaves a breadcrumb for future Issue Resolution
Create comprehensive technical specifications for completed tasks and features
Create A Magazine Style Layout
Design a flexible, reusable magazine-style layout for displaying content threads (e.g., blog posts, articles) in Astro using modular components and a clear render pipeline.
Citation Processing for FileSystem Observer
Enhance the filesystem observer to automatically format citations, convert to hex IDs, and maintain a citation registry
blueprints/4
Maintain an Elegant Open Graph System
A scalable, consistent architecture for Open Graph/Twitter share metadata across multi-site Astro projects.
Maintain a Map of Content Paradigm
Implement MOC directive-driven content capacity management for centralized, markdown-native content curation
Improvise a few Creative Component Variants
Generate a few variants of a web component with similar functionality and consistent with the overall design, style, theme, and mode using CSS variables.
Keep a Changelog
Standardized approach to maintaining comprehensive changelogs for code and content changes
reminders/28
Reminder of Specification Template and Guidelines for AI Code Assistants
Guidlines and templates only work if you use them.
How to manage gnarly routing with Static Site Generators
Guidlines for how to manage dynamic and static routing with Static Site Generators
Maintain an Environment-based Build System
Build across environments, including different deployments, using environment variables and configuration files.
Fire up the Observer
Ready to automate? Learn how to launch the Observer system for seamless citation and frontmatter processing across your content library.
Implement Client-Specific Content Routing in Astro
Create dynamic routes for client-specific content while maintaining existing general content structure
Maintain Consistent Debugging Conventions
Debugging is a critical part of our development process. We should maintain consistent debugging conventions across all our code.
Ways We Avoid Hard Validation
Prevent build failures and gracefully handle frontmatter inconsistencies.
The Simplified Observer Logic
Clarify and streamline the Observer’s orchestration logic—ensuring every subsystem, expectation, and write operation is perfectly sequenced.
Use Safe Syntax in Mermaid Charts
Assure your Mermaid Charts render by avoiding unsafe characters and syntax while writing technical documentation
An Exhaustive list of content YAML patterns.
Never repeat yourself—reference this comprehensive guide to all frontmatter YAML patterns for bulletproof data integrity and automation.
Change Role and Implement Prompt
Seamlessly switch roles from product manager to developer and implement prompts with context awareness and precision.
Comprehensive Rules to tame Code Generator LLMs
Unlock the secrets to taming LLM code generators with a masterclass in rules, conventions, and practical strategies for bulletproof automation.
Create a permanent memory for project YAML conventions
Eliminate frustration by observing guidelines, working within hard rules and constraints, and learning to detect YAML irregularties that could cause bugs and failures.
Extending Markdown with Obsidian FlavoredSyntax
Discover how to supercharge your Markdown with Obsidian's advanced syntax, templates, and automation tricks for next-level note-taking and productivity.
Maintain a word-for-word dialog of our session
Capture every word of your human-AI dialog for perfect transparency, reproducibility, and context-aware automation.
Maintain Consistent Reporting
Master the art of consistent, auditable reporting for every automation, script, and observer in your content pipeline.
Maintain Consistent Reporting Templates
Build trust and clarity with consistent, reusable reporting templates that make every audit, fix, and automation step transparent and repeatable.
Maintain Robust Commenting in our Flavor
Unlock the power of readable, maintainable code with our signature commenting style—section openers, function docs, and clarity-first annotation for every project.
Maintain a Scripting Pipeline
Design modular pipelines to detect, clean, and report on markdown files—ensuring every content workflow is robust, maintainable, and auditable.
Map of Dependencies
Eliminate frustration by observing guidelines, working within hard rules and constraints, and learning to detect YAML irregularities that could cause bugs and failures.
Map of Relevant Paths
Review this file to ensure code generation is using the correct paths and directory structure in this complex monorepo.
Meticulous Constraints for Every Prompt
Master prompt engineering with essential, actionable constraints—ensuring every code generation task is robust, DRY, and error-resilient.
Read the relevant documentation before guessing.
Illuminate your coding journey by diving into relevant documentation, and transform assumptions into accurate, well-informed decisions.
Remind a model to read documentation sources of included libraries
Give your AI Code Assistant the Aha! moment it needs to get through your blockers by learning directly from documentation sources.
Respect the framework nuances, read the docs
Brief description of the reminder functionality and purpose
Discuss Spec init starter before Developing Spec
Brief description of the reminder functionality and purpose
Comprehensive Rules to tame Code Generator LLMs
A comprehensive, click-worthy guide to every YAML property and value syntax nuance you need to master for robust automation and content integrity.
lost-in-public/reminders/specification-guidelines-template
explorations/13
Enhance Visualizations with Use of Formats
lost-in-public/explorations/self-hosting-multi-site-analytics-platforms
Multi-Site Astro Starter Kit Architecture
Exploration of building a comprehensive Astro starter kit optimized for rapid deployment of multiple marketing sites with environment-driven customization
Foundational Workflow In The Terminal And Command Line
Accessing Figma through a Windsurf MCP Server
Interact with Figma Designs while building an application, straight from the IDE
Automating Content Generation With Local LLMs
Creating a Custom GPT with OpenAI
Exploring Model Context Protocol SDK
Tinker with the Model Context Protocol SDK created by Anthropic
Finding an Email Newsletter API that Supports Multiple Domains
Most email newsletter services boast the deliverability and the large number of emails. But what if you just need to send a limited number of emails but support multiple domains?
Using MCP Servers to Speed-up Astro Development
What kind of MCP Servers actually speed up Astro Development?
Creating A Flavored Syntax Parsed To UI
Using Obsidian To Manage Markdown Based Content Collections For Static Site Generation Frameworks
Using Test Coverage to Constrain AI Code Assistants
issue-resolution/39
Running the Latest and Greatest LLM Locally
Step-by-step guide for installing and configuring local LLMs—including Ollama, LiteLLM, Fabric, and Perplexica—for modern AI workflows and toolchains.
Aggregating GitHub Statistics
Creating aggregate stats on GitHub commits using the gh CLI and GitHub APIs.
Broken YAML Key Replacement Workflow
Documenting a critical workflow bug and its resolution for YAML key replacement in Markdown frontmatter.
Computing Entry Object Values in Astro
A practical guide to ensuring content collections in Astro have complete and valid entry objects for reliable builds.
Conditional Console Logging as a Standard Practice
Establishing a DRY, configurable approach to console logging for transparent debugging and maintainability.
Rendering AST Through a Thoughtful Transformation Pipeline
Achieving robust component-based markdown rendering by optimizing the AST transformation pipeline, fixing blockquote/callout handling, and leveraging the unified ecosystem for efficiency.
Rolling back in time with BTRFS
Fixing Markdown Frontmatter Default Values
Resolving issues with missing frontmatter fields not being populated with template defaults
Fixing MOC Content Filtering Across Multiple Collections
Resolving client reader sidebar issues when Map of Content files reference articles from different content collections with mismatched paths and titles
Optimizing Share Functionality Across Content
Search and share are the only scalable organic growth engines. Optimizing some aspects are easy.
Nested Scroll and Keyboard Behavior Conflicts in Interactive UI Components
Resolving conflicts between parent and child component event handling when nested interactive elements compete for mouse and keyboard control
Creating an Astro Collection from Multiple Directory Paths
Solving the challenge of combining multiple portfolio directories into a single unified collection
Getting Through CORS
A practical guide to improving cross-origin data rendering and troubleshooting CORS issues in modern web development.
Handling Unexpected API Responses
Robust strategies for normalizing and integrating unpredictable API data into observer pipelines and frontmatter logic.
Fix: Author Metadata Not Rendering on Custom Collection Pages
Resolve incomplete data propagation in a dynamic routing component.
Cursor and Claude 3.7 go Overkill with Regex & Validation
Diagnosing the pitfalls of excessive regex and validation logic in collaborative AI-powered workflows.
Grid Layout Centering with Responsive Breakpoints
Solving complex CSS grid layout issues with simplified media queries
Persistent File Processing State in Observer
Assure the FileSystemObserver has a persistent file processing state, and also resets the state upon initialization and shutdown.
Dynamic Image Masking Control in FeatureSideImage Component
Implementing flexible image masking with configurable dimensions via JSON data
Extending Astro Markdown with Remark and Rehype Plugins
How to enhance Astro's Markdown pipeline by integrating custom Remark and Rehype plugins for advanced content processing.
Getting Astro Collections to Work on Messy Frontmatter
How to configure Astro content collections to handle Markdown files with inconsistent or incomplete frontmatter, using .passthrough and transform for robust schema handling.
How Micromark Handles Markdown and the AST
A deep dive into how Micromark tokenizes Markdown and how the AST is built by higher-level utilities in the remark/unified ecosystem.
How remark-gfm Renders Tables
A technical deep dive into how the remark-gfm plugin parses, transforms, and renders Markdown tables in the unified ecosystem.
Managing Complex Integrations Through Git
Solutions and essential commands for managing complex Git integrations, especially in monorepos with submodules and loosely-coupled architectures.
Obsidian Stuck in Regex Memory Hang
Diagnosing and resolving a persistent regex-induced freeze in Obsidian, including hidden file investigation and advanced directory tree commands.
Preventing Infinite Loops in Observers
Strategies and atomic patterns for preventing infinite loops and redundant writes in observers, with robust frontmatter repair and idempotency.
Preventing Infinite Loops in RemindersWatcher
Comprehensive breadcrumb and technical guide for debugging and resolving infinite loop issues in the RemindersWatcher observer system, with inspector-only enforcement and atomic property aggregation.
ReferenceGrid Layout Issue Resolution (CSS vs Tailwind)
Troubleshooting and resolving the ReferenceGrid component's layout issue—switching from custom CSS/media queries to Tailwind utilities for robust responsive grids.
Setting up Rehype to Better Parse Markdown
Implementing a custom unified pipeline with remark and rehype for Astro Flavored Markdown, solving file reference and plugin integration issues.
Showing Hidden Directories in Tree Output
How to configure the `tree` command to display hidden directories and files when visualizing project folder structures.
Tame Generative AI with Rule Sets
Canonical rules and technical conventions for controlling, documenting, and collaborating with code-generating LLMs in complex TypeScript/Astro projects.
Troubleshooting Rendering Citations
Resolving issues with citation rendering in Markdown pipelines—strategies for AST transformation, plugin fallback, and robust user experience in Astro/Remark environments.
Write Git Commit Messages with Your Favorite Editor
How to configure Git to use your preferred editor (like Neovim) for writing multi-line commit messages, plus tips for advanced commit workflows.
YAML Consistency for Content Collections & Script Actions
Ensuring reliable YAML frontmatter for Astro content collections and script automation—approaches, pitfalls, and tooling support.
Fixing 404 Errors in Dynamic Routes with Proper Slug Generation
Resolving path mismatches between URL construction and getStaticPaths in Astro dynamic routes
Frontmatter Date Formatting Fix
Resolving timestamp and quoted date issues in frontmatter
Full-Width Separator Issue Resolution
Solving the challenge of creating truly full-viewport-width separators in a constrained layout
Prompt Rendering Pipeline Issue Resolution
Fixing content rendering issues in the dynamic prompt pages
AstroMarkdown Mermaid Rendering Issue Resolution
Breadcrumb documenting the resolution of Markdown/AST rendering issues for Mermaid diagrams and code blocks in AstroMarkdown.astro.
refactors/6
Update an Older Codebase one Dependency at a time.
Refactor Changelog Content By Project
Refactor Reference Lists into Reference Grid
Refactor reference lists into a grid-based component
Refactor a really long Obsidian Modal file.
Creating modular maintainable code for Obsidian Plugin Modals
Refactor Plan: Consolidate Callout Processing to Pipeline Architecture
lost-in-public/refactors/ongoing-log-of-opportunities-to-refactor