Skip to content

Instantly share code, notes, and snippets.

❯ how does this app work
⏺ Bash(date '+%Y-%m-%d %H:%M:%S %z')
⎿  2026-03-07 19:43:19 -0800
⏺ Based on the CLAUDE.md and project structure, here's how Demo Kit works:
What It Is
A web platform for structured demo nights and project showcases. Think: hackathon demo day as a service.
❯ how does this app work
⏺ Bash(date '+%Y-%m-%d %H:%M:%S %z')
⎿  2026-03-07 19:39:07 -0800
⏺ Searched for 2 patterns, read 5 files (ctrl+o to expand)
⏺ Here's how Demo Kit works:
The Big Picture

PR Decomposition Agent Prompt

Agent Instructions

You are a senior staff engineer acting as a PR decomposition facilitator. You've been given a diff that is far too large to review meaningfully. Your job is to work with the PR creator through a structured interview to:

  1. Understand the core motivation — the single problem that triggered this work
  2. Identify what's essential vs. what got bundled in along the way
  3. Surface opportunities for simplification — places where the same intent could be achieved with less code, less complexity, or a more incremental approach
  4. Make a deliberate decision about every piece of intent — ship it, spec it, track it, simplify it, or drop it
@samkeen
samkeen / claude-ralph-test.txt
Last active January 21, 2026 19:06
Test using the Ralph Claude Code Plugin for a feature request
* ▐▛███▜▌ * Claude Code v2.0.76
* ▝▜█████▛▘ * Opus 4.5 · Claude Max
* ▘▘ ▝▝ * ~/Projects/revenue-experiments/expenses-sbucks
> use your ralph task setup skill to gather requirements for gh issue 4
⎿  ⧉ Selected 1 lines from README.md in Visual Studio Code
⏺ Bash(gh issue view 4)
⎿  title: Add receipt upload UI
@samkeen
samkeen / Claude Code result without the API.md
Last active January 6, 2026 22:01
AC research: Dev journal response from Claude Code , in this case with system prompt only (no code)

Dev Journal: January 3-5, 2026

You had a productive 3-day stretch focused on three main areas: advancing fast-llms-txt (your FastAPI OpenAPI-to-markdown library), polishing chat-rag as an educational tool, and significant business/marketing work for AlteredCraft.


Friday, January 3

fast-llms-txt - Schema documentation improvements

  • Worked through nested object extraction for arrays (e.g., Array[HistoryEvent]) to improve markdown output quality
  • Added a premise section to the README explaining why OpenAPI specs, while excellent for machines, need LLM-optimized formats
@samkeen
samkeen / Claude Code result with the API.md
Last active January 6, 2026 22:02
AC research: Dev journal response from Claude Code , in this case with system prompt + use of a custom built API

Dev Journal: January 3-6, 2026

A productive 4-day stretch focused on three main projects. The highlight was building out the dev-journal skill for Claude Explorer—creating an API-powered workflow that lets an AI agent journal your development activity. You also shipped several UX improvements to Chat-RAG and refined the markdown output for fast-llms-txt.


Monday, January 6

Claude Explorer - Dev journal skill and API refinements

  • Crafted a system prompt for an LLM agent to generate developer journals from the Claude Explorer API
@samkeen
samkeen / claude-code-data-structures.md
Last active February 10, 2026 17:18
This is the extracted logic of the makeup of the `~/.claude directory` and `~/.claude.json` file
description research_date claude_code_version sources
Documentation of the `~/.claude/` directory structure for dev journal integration.
2026-01-01
2.0.x
Local filesystem analysis + [Official Docs](https://code.claude.com/docs)

Claude Code Data Structures

Overview

╭─── Claude Code v2.0.55 ──────────────────────────────────────────────────────╮
│ │ Tips for getting started │
│ Welcome back! │ Run /init to create a CLAUDE.md file with inst… │
│ │ ─────────────────────────────────────────────── │
│ ▐▛███▜▌ │ Recent activity │
│ ▝▜█████▛▘ │ No recent activity │
│ ▘▘ ▝▝ │ │
│ │ │
│ Opus 4.5 · Claude API │ │
# Example create PR skill
## Layout
```
skills/create-pr
├── references
│   └── pr-best-practices.md
└── SKILL.md
```
Can you add an export trace button to the ui
I'll help you add an export trace button to the UI. Let me first explore the codebase structure to understand the current implementation.
Task
Explore UI codebase structure
Bash
find /home/user/mcp_visualizer -type f -name "*.tsx" -o -name "*.ts" -o -name "*.jsx" -o -name "*.js" | head -30
/home/user/mcp_visualizer/mcp-inspector-app/app/test-module-2/page.tsx
/home/user/mcp_visualizer/mcp-inspector-app/app/demo/page.tsx