Agent Doc Pack Index
Canonical index for the generated workflow docs Kevin can hand to any agent: brain capsules are the public interface to Kevin's wiki, and packs are compact execution bundles compiled from those capsules plus the current wiki corpus.
Generated: 2026-06-30
Manifest hash: 8c48ca05b60d
Pack count: 65
The end product has three layers:
- Organized wiki articles: every page belongs to exactly one capsule, with stable ids and clear routers.
- Brain capsules: public, source-backed slices of the wiki that expose purpose, sources, skills, tools, and maintenance rules.
- Generated workflow packs: large, curated markdown files that agents can load by task.
Packs are not a replacement for the wiki or the capsules. Packs are the portable execution surface. Each pack includes static operating rules, capsule routes, and a programmatic knowledge surface from current wiki pages.
Capsule manifest: agent-docs/capsules.json.
Readable capsule index: wiki/meta/brain-capsules.md.
Core Packs
| Pack |
Load When |
identity.md |
Starting any serious Kevin-owned task. |
session.md |
Beginning a session or resuming after context loss. |
routing.md |
Choosing skills, tools, wiki pages, or capability routes. |
workflow-index.md |
Deciding which packs belong in an agent context. |
Engineering Packs
| Pack |
Load When |
code.md |
Writing or reviewing general code. |
architecture.md |
Designing modules, seams, system boundaries, or domain models. |
typescript.md |
Writing TypeScript, APIs, Effect patterns, or type-heavy code. |
testing.md |
Adding unit, integration, E2E, browser, or AI tests. |
debugging.md |
Diagnosing bugs, regressions, flakes, or production issues. |
review-qa.md |
Reviewing, dogfooding, screenshotting, or release-checking work. |
doctors.md |
Choosing or running Kevin's scored doctors, autoreview, self-heal, and release gates. |
security.md |
Touching auth, secrets, webhooks, supply chain, or permissions. |
git-process.md |
Committing, splitting PRs, rebasing, merging, or preserving worktrees. |
process-hygiene.md |
Starting, auditing, or cleaning long-running agent/dev processes. |
Frontend And Design Packs
| Pack |
Load When |
frontend.md |
Building product UI in React/Next/Tailwind. |
react.md |
Working on React structure, hooks, state, Suspense, or client/server boundaries. |
nextjs.md |
Working on App Router, Cache Components, instant navigation, or upgrades. |
design.md |
Making visual/product design decisions. |
design-systems.md |
Working on tokens, component libraries, presets, or brand kits. |
motion.md |
Animation, transitions, scroll effects, timelines, or reduced motion. |
accessibility.md |
Keyboard, semantics, contrast, focus, screen readers. |
performance.md |
Core Web Vitals, loading states, caching, bundle budgets. |
browser-qa.md |
Playwright, screenshots, responsive checks, visual regression. |
web3d.md |
Three.js, R3F, shaders, WebGL, WebXR. |
mobile.md |
Mobile UI, touch targets, responsive constraints, mobile-first verification. |
Backend And Infrastructure Packs
| Pack |
Load When |
backend.md |
Building backend services, APIs, infra, auth, deploy paths. |
databases.md |
Postgres, Supabase, Firestore, ClickHouse, TanStack data, RLS, migrations, query performance. |
auth.md |
Clerk, Firebase Auth, Entra, sessions, roles, identity. |
infra.md |
Queues, workers, storage, sandboxes, runtime topology. |
cloud.md |
Azure, Vercel, Cloudflare, AWS, Firebase, Railway, Render, provider routing. |
observability.md |
Logs, traces, diagnostics, dashboards, alerts, error tracking, product analytics. |
payments.md |
Stripe, webhooks, billing safety, idempotency. |
data.md |
Pipelines, Sheets, structured extraction, analytics. |
ops.md |
Daily operational/service work, safe mutations, logistics, maintenance actions. |
service-cli.md |
Service CLIs, account checks, JSON output, dry-run policy. |
google-workspace.md |
Drive, Gmail, Calendar, Sheets, Docs, Slides, Tasks. |
AI And Agent Packs
| Pack |
Load When |
ai-agents.md |
Building or operating agent systems. |
agent-harnesses.md |
Comparing Cursor, Claude Code, Codex, OpenCode, OpenClaw, Hermes. |
skills.md |
Creating, pruning, installing, or routing skills. |
mcp-tools.md |
Choosing MCP servers, registries, permissions, hosted/local tradeoffs. |
memory.md |
Designing memory, wiki state, durable sessions, skill overlays. |
evals.md |
Trigger evals, AI tests, quality gates, deterministic checks. |
sandboxes.md |
E2B, Vercel Sandbox, Dedalus Machines, Daytona, long-running execution. |
model-routing.md |
Model/provider choice, costs, latency, fallbacks, gateways. |
automations.md |
Recurring agents, monitors, capability harvest, self-heal. |
Wiki, Research, And Docs Packs
| Pack |
Load When |
wiki-ops.md |
Maintaining wiki structure, index, qmd, lint, backlinks, doctors. |
capture-ingest.md |
Adding links, X bookmarks, artifacts, sources, media, raw absorption. |
research.md |
Synthesizing papers, briefs, prior research, source-ledger material. |
learning.md |
Turning concepts and frontier scans into durable knowledge. |
docs-writing.md |
Writing READMEs, docs, MDX, explanations, examples. |
diagrams.md |
Mermaid, Excalidraw, architecture diagrams, visual explanations. |
Product, Career, And Communication Packs
| Pack |
Load When |
product.md |
Product thinking, onboarding, UX flows, launch docs, user research. |
content.md |
Social/content strategy, Kevin voice, SEO/GEO, platform drafts. |
writing.md |
Writing fragments, beats, shape, humanization, narrative edits. |
seo.md |
Programmatic SEO, AEO/GEO, metadata, OG images, content strategy. |
career.md |
Resume, proof, applications, interviews, recruiting. |
portfolio.md |
Projects, research, hackathons, websites, deployments, impact stories. |
people.md |
People Kevin knows/admires and why they matter. |
principles.md |
Stable beliefs, decisions, postmortems, operating principles. |
narrative.md |
Stories, eras, transitions, tensions, personal context. |
Specialty Packs
| Pack |
Load When |
media-generation.md |
Image/video/audio generation, model selection, artifact creation. |
documents-presentations.md |
Docs, PDFs, slides, spreadsheets, reports, decks. |
game-dev.md |
Browser games, Pixi/Canvas/Three, loops, QA, assets. |
hardware-graphics.md |
Graphics, shaders, render pipelines, visual effects. |
events-travel.md |
Offsites, travel, calendar logistics, venue research. |
Bundle Presets
| Work Mode |
Packs |
| New coding session |
identity.md, session.md, routing.md, code.md, doctors.md, review-qa.md |
| Web app |
identity.md, code.md, frontend.md, typescript.md, nextjs.md, design.md, browser-qa.md, doctors.md, review-qa.md |
| Design/frontend polish |
identity.md, design.md, design-systems.md, motion.md, accessibility.md, browser-qa.md, doctors.md |
| Backend/API |
identity.md, code.md, backend.md, typescript.md, databases.md, auth.md, security.md, doctors.md, review-qa.md |
| AI agent product |
identity.md, ai-agents.md, agent-harnesses.md, skills.md, memory.md, evals.md, sandboxes.md, backend.md, doctors.md |
| Wiki maintenance |
identity.md, wiki-ops.md, capture-ingest.md, routing.md, automations.md |
| Research synthesis |
identity.md, research.md, learning.md, docs-writing.md, diagrams.md |
| Career/portfolio |
identity.md, career.md, portfolio.md, people.md, writing.md, principles.md |
| Content/social |
identity.md, content.md, writing.md, seo.md, media-generation.md |
| Service/ops work |
identity.md, ops.md, service-cli.md, google-workspace.md, security.md |
Generation Contract
- Generated files live in
agent-docs/packs/.
- Capsule manifest lives in
agent-docs/capsules.json and the readable index lives in wiki/meta/brain-capsules.md.
- The generator owns this index and the pack files.
- Source pages stay authoritative.
- Capsules are the public brain boundary; packs are task-specific execution bundles attached to those capsules.
- Pack knowledge surfaces are selected from current wiki markdown/frontmatter.
- Consolidation queues come from
npm run wiki-consolidation:audit; review them before merging pages.
- Run
npm run agent-packs after changing pack definitions or relevant source pages.
- Run
npm run agent-packs:check before commit.
Timeline