proofofbuild.app — Claude Code Skill Guide

What this project is

Proof of Build (proofofbuild.app) — a verified builder directory for the AI-native onchain economy. ~95 verified builders, each with bio, projects, badges, and activity feeds.

Tech stack

• Next.js 14 (App Router), Tailwind CSS
• Neon Postgres (serverless)
• Vercel (deployment) — deploy with: npm run deploy (= vercel --prod)
• Anthropic API (claude-sonnet for Ask AI)
• OpenAI API (gpt-4o-mini for Ask AI fallback)

Database tables

• builders: slug, name, bio, notable_stat, website, twitter_handle, github_handle, tags, featured
• projects: builder_slug, name, description, url, status, chain
• activity: builder_slug, type, title, url, source, created_at
• badges: builder_slug, badge_type, verified_at

Key API routes

• POST /api/ask — Ask AI (rate limited 10/min/IP). body: { question, mode: "quick"|"deep" }
• GET /api/builders — list all builders
• POST /api/activity-sync — syncs GitHub/Twitter activity (x-admin-secret header required)
• POST /api/sync-badges — syncs proof badges (x-admin-secret header required)
• GET /api/cron/agent — weekly digest cron
• All admin routes require: x-admin-secret header

Data sources (live, deep mode only)

• CoinGecko: token prices
• DeFiLlama: protocol TVL + chain TVL
• GitHub: recent repo commits/activity
• Twitter/X: via twitterapi.io
• POB activity feed: internal DB

Conventions

• Admin auth: always x-admin-secret header (never query param)
• Deploy: npm run deploy
• Rate limiting: in-memory map, resets on cold start
• Builder slugs are kebab-case, unique
• DB operations: always look up builder_id from slug first — projects table has no builder_slug column
• projects.url not projects.website — the column is url

Active features

• Ask AI (quick + deep mode)
• Weekly digest (auto Wednesday)
• Badge system (BagsApp launched, Active on X, Has Website, Featured Builder)
• Activity feed (GitHub + Twitter)
• Builder profiles with projects