1	# Wiki Index
2
3	A catalog of everything in this knowledge base. Updated by Nano on every ingest.
4
5	## Tools & Software
6	*Guest-endorsed or actively used — not sponsors.*
7	- [[Agent Browser]] — Vercel Labs Rust CLI for AI-driven browser automation. Credential vault, accessibility-tree refs, React introspection, HAR recording.
8	- [[Devin]] — AI coding agent by Cognition. 15-thread code factory model.
9	- [[OpenClaw]] — Open-source AI executive assistant / chief of staff.
10	- [[ClawChief]] — Ryan Carson's open-sourced OpenClaw chief-of-staff config.
11	- [[Claude Code]] — Anthropic's coding agent. Ryan Carson's preferred coding tool.
12	- [[Codex]] — OpenAI's coding agent / browser testing tool.
13	- [[Sentry]] — Error monitoring. Used with Devin for automated bug triage.
14	- [[Tailscale]] — WireGuard mesh network. Used for remote access to Mac Mini services from phone. Includes full recipe for exposing any local port via `tailscale serve` + launchd.
15	- [[Figma]] — Design/wireframing. Visual context layer in Ravi Mehta's system.
16	- [[AgentsView]] — Agent token/cost accounting tool. Useful when new frontier-model pricing appears before dashboards and pricing databases catch up.
17	- [[Teach Skill]] — `/teach` by Matt Pocock. ZPD-based personalized tutor with persistent learning records. Trigger-based (no idle context cost). Claude Code only. Install: `npx skills add mattpocock/skills --skill teach`.
18
19	## Anthropic Official Repos & Resources
20	*Official Anthropic repositories — tools, SDKs, plugins, and reference implementations.*
21	- [[Anthropic Skills Repo]] — Reference implementations of the Claude Agent Skills system. Template for building custom skills.
22	- [[Claude Plugins Official]] — Anthropic's curated plugin marketplace for Claude Code. Install via `/plugin install`.
23	- [[Ralph Loop Plugin]] — Stop-hook-based autonomous iteration loop. Feeds Claude the same prompt until it outputs a completion promise. For well-defined tasks with clear success criteria and automatic verification.
24	- [[Hookify Plugin]] — Create Claude Code hooks from natural language. `/hookify warn me when I use rm -rf` → working hook instantly. No hooks.json editing required.
25	- [[Knowledge Work Plugins]] — 18 open-source role-specific plugins (sales, legal, finance, design, engineering, HR, ops, etc.) built on Claude Agent SDK.
26	- [[Claude for Legal]] — Deep legal workflow plugin suite (transactional + litigation + learning). Integrates with Westlaw, CourtListener.
27	- [[Claude for Life Sciences]] — Research marketplace: PubMed, BioRender, Synapse, Consensus + RNA-seq/Nextflow skills.
28	- [[Claude for Healthcare]] — Healthcare marketplace: FHIR developer, prior-auth review, clinical trial protocols + CMS/NPI servers.
29	- [[Claude for Financial Services]] — 10 named agents (Pitch Agent, GL Reconciler, Market Researcher, KYC Screener, etc.) + 9 vertical skill bundles (IB, ER, PE, WM, fund admin). Deployable as Cowork plugins or Managed Agent templates.
30	- [[Managed Agents]] — Anthropic's hosted agent orchestration platform. Self-hosted sandbox option (tool execution on your infra via outbound-polling worker), mid-session tool/MCP updates, large MCP output auto-offload. Scheduled deployments (cron, no custom infra). Env vars in vaults (credentials injected at network boundary). Opus 4.8 tool-description guidance included.
31	- [[Claude Agent SDK Demos]] — 8 local demo apps showcasing Claude Agent SDK patterns (multi-agent, streaming, email, docs).
32	- [[Anthropic SDK Go]] — `go get anthropic-sdk-go@v1.56.0`. Go 1.24+. Type-safe Claude API client for Go: model constants, context support, standard Go idioms.
33	- [[Anthropic SDK Java]] — `com.anthropic:anthropic-java:2.49.0`. Java 8+. Maven/Gradle. Builder-pattern Claude API client for JVM applications.
34	- [[Claude Agent SDK TypeScript]] — `npm install @anthropic-ai/claude-agent-sdk`. Node.js 18+. Renamed from Claude Code SDK.
35	- [[Claude Agent SDK Python]] — `pip install claude-agent-sdk`. Python 3.10+. In-process MCP servers, hooks as Python functions, CLI bundled in wheel.
36	- [[Claude Cookbooks]] — Copy-paste code recipes and notebooks for Claude API (RAG, tool use, multimodal, agents).
37	- [[Claude Quickstarts]] — Production-ready starter projects: customer support, computer use, browser automation, coding agent.
38	- [[Anthropic Courses]] — 5-course official curriculum: API fundamentals → prompt engineering → real-world prompting → evals → tool use. Jupyter notebooks.
39	- [[Anthropic Prompt Engineering Tutorial]] — 9-chapter interactive prompt engineering course with exercise playgrounds. Available direct API and Amazon Bedrock variants.
40	- [[Claude Code Action]] — GitHub Action that brings Claude into PR review and CI/CD workflows.
41	- [[Defending Code Reference Harness]] — Reference impl for autonomous vuln discovery + human-reviewed patching. gVisor-sandboxed agents. Not actively maintained; Claude Security is the hosted version.
42	- [[Scone Bench]] — 417-task benchmark for evaluating LLM agents on smart-contract vuln discovery/exploitation. Historical DeFi incidents, MCP-based, Docker-sandboxed. From Anthropic Red Team.
43	- [[Claudes C Compiler]] — Claude Opus 4.6 wrote a dependency-free C compiler in Rust from scratch. Compiles PostgreSQL, SQLite, Linux kernel, FFmpeg. Capability showcase, not production-validated.
44	- [[Anthropic Performance Take-Home]] — Open version of Anthropic's original performance engineering take-home. Optimize a VLIW SIMD kernel; Claude Opus 4.5 scored 1,363 cycles vs 147,734 baseline (108× improvement).
45	- [[Claude Code Security Review]] — GitHub Action that auto-scans PRs for security vulnerabilities using Claude.
46	- [[Claude Desktop Buddy]] — ESP32 desk pet + Bluetooth API reference for makers integrating with Claude Desktop.
47	- [[HTML Effectiveness Examples]] — Anthropic's reference collection of single-file HTML artifacts (slide decks, dashboards, editing UIs, diagrams).
48	- [[Claude Code Setup Plugin]] — Official Anthropic plugin that scans your codebase and recommends tailored hooks, skills, MCP servers, subagents, and plugins. Read-only, 1-2 recs per category.
49	- [[Claude Code Monitoring Guide]] — Prometheus + OpenTelemetry toolkit for tracking Claude Code ROI, token spend, and team adoption.
50	- [[GitHub MCP Server]] — GitHub's official MCP server.
51	- [[PineForge MCP]] — Hosted MCP server for real Pine Script v6 backtests. `claude mcp add --transport http pineforge https://mcp.pineforge.dev/mcp`. No key/signup. 245/246 TradingView parity, 100 backtests/week, 13mo Binance data. Docker route for unlimited/custom data. 60+ tools: repos, issues, PRs, code search, security scanning.
52	- [[Devcontainer Features]] — One-line devcontainer.json feature that installs Claude Code CLI in any dev container.
53	- [[Claude Code Routines]] — Scheduled/triggered cloud automation. Runs on Anthropic infrastructure, not your machine. `/schedule` command, API + GitHub + time triggers. Research preview.
54	- [[Long-Running Agent Primitives]] — 3 core primitives (Default-FAIL, Fresh-context evaluator, Handoff) + 2 operator hooks (kill switch, STEER.md). From Anthropic's own patterns.
55	- [[Claude Code Migration Kit]] — Official Anthropic toolkit for large-scale language migrations. 8 sequential prompts (00-feasibility → 06-post-parity), templates (RULEBOOK.md, manifest.tsv, inventory.tsv, cost-log.tsv, settings.json), scripts (dependency mappers, queue runners, build daemons). Companion to the AI Code Migration blog post. Operationalizes [[Rulebook-Driven Migration Loop]].
56	- [[Claude Plugins Community]] — Community plugin marketplace (security-reviewed). Submit at clau.de/plugin-directory-submission.
57	- [[Anthropic CLI]] — `ant` CLI for the Claude Developer Platform API. `brew install anthropics/tap/ant`.
58	- [[Anthropic CWC Workshops]] — 8 Code-with-Claude workshop curricula: Managed Agents, memory primitives (Dreaming Service), eval-driven dev, multi-agent decomposition, Deal Desk reference impl.
59	- [[Agent SDK Workshop]] — Hands-on workshop for Claude Agent SDK: 4-stage guided demo (chat → tools → subagents → memory) + breakout scenarios. Python 3.10+, flip switches in config.py.
60	- [[Long-Horizon Coding Agent Demo]] — Archived AWS re:Invent 2025 demo. GitHub issue → agent builds full-stack app → CloudFront preview → human approval gate. Bedrock AgentCore + Claude Agent SDK.
61	- [[Claude Foundation Models Swift Package]] — Swift package for hybrid Apple-platform apps: on-device model for fast/private tasks, Claude for reasoning + web search. iOS 27+, SPM install. Announced June 2026.
62	- [[Claude Tag Plugins]] — 19 SaaS integration plugins (Jira, Linear, Snowflake, Salesforce, Sentry, Datadog, etc.) via Claude Tag CLI. Credentials injected at runtime; install only what you need.
63	- [[Launch Your Agent]] — Claude Code skill that guides a founder from raw idea to live Claude Managed Agent: interview → scope → deploy → grade → schedule. One session, costs cents.
64	- [[Claude Fable 5 and Mythos 5]] — Anthropic's latest frontier models. Always-on adaptive thinking, new tokenizer (~30% more tokens), refusal stop reason + SDK fallback middleware, 30-day data-retention requirement. Fable 5 = GA; Mythos 5 = Preview.
65
66	## Third-Party Tools & Platforms
67	- [[Supertonic]] — On-device TTS. 66M params, ONNX, MIT license. 167× realtime on M4 Pro. Zero cost, zero cloud. Drop-in OpenAI TTS API compatible. Primary use case: StageHand narration replacing ElevenLabs.
68	- [[Legora]] — AI-native operating system for legal teams. Autonomously plans, executes, reviews, and completes complex legal work end-to-end. Built on Claude. "Raises the tide" model: improves with each Claude release.
69
70	## Sources (Talks, Posts, Papers)
71	- [[Claude CwC - The Prompting Playbook]] — Margot van Laar (Anthropic), CwC London 2026. Eval-first, XML structure, delete legacy patches, tools > instructions, Generator→Evaluator→Repairer loop.
72
73	## Concepts & Reference Docs
74	- [[Test Isolation for Runtime Activity Logs]] — Prevent orchestration tests from polluting live alert/error/state feeds by redirecting module-level runtime paths to `tmp_path`, then prove production logs are unchanged by the suite.
75	- [[LaunchAgent Quarantine and Tailscale Recovery]] — Recover a reboot-stalled local site by clearing the LaunchAgent quarantine and re-bootstrapping it, then separately reconnecting Tailscale and verifying both local and public routes.
76	- [[Orthogonal Visual Channels on Map Lines]] — Don't recolor a line to encode a boolean when color already carries a scalar; add a near-black dotted overlay (Mapbox: short dash + round cap, dasharray units are line-widths so zoom-scaling is free). Plus a puppeteer pattern for E2E-verifying map layers via the app's own custom events.
77	- [[CLAUDE.md Progressive Disclosure]] — Every-session context files hold only always-relevant rules; situational procedures move to `.claude/docs/` behind trigger-phrased pointers. Measure per-section cost first; add a size budget against regrowth.
78	- [[Claude Constitution]] — Anthropic's foundational values document. CC0 licensed. January 2026.
79	- [[Agentic UI Impedance Mismatch]] — Dario Amodei's framing: agents will complete tasks end-to-end most of the time, but humans need deep-dive inspection capability for the exceptions. No product solves this yet.
80	- [[Claude Code Subagents]] — Separate Claude instances with their own context windows. 5 copy-paste templates (reviewer, test-writer, doc-writer, security, pr-writer). Route to Sonnet for 5× cost savings.
81	- [[WebMCP]] — Chrome's proposed web standard for exposing structured tools to AI agents. Declarative HTML annotations + JS API replace fragile UI actuation. Origin trial in Chrome 149.
82	- [[But For Real Skill]] — Self-audit pattern: follow-up prompt that assumes bugs are present and bullies the AI into finding them. Simulates PR code review. From Josh Pigford's solo-founder skills stack.
83	- [[Claude Code Agent Teams]] — Native experimental feature: Team Lead + Teammates model with shared task list, dependency management, plan approval, and hooks. Enable via env flag. Claude Code only (no Codex/Aider).
84	- [[Claude Code Dynamic Workflows]] — Claude writes its own JS orchestration harness on the fly (`ultracode` keyword). 6 patterns: classify-and-act, fan-out-and-synthesize, adversarial verification, generate-and-filter, tournament, loop-until-done. Opus 4.8 era.
85	- [[Finding Your Unknowns Framework]] — Pre-flight protocol for agentic work. 4-quadrant unknowns model (Known/Unknown × Knowns/Unknowns) + 8 elicitation techniques (blind spot pass, interview mode, reference prompting, implementation plan, explainer artifact, quiz mode). Fable-era shift: user clarity is now the bottleneck, not model capability.
86	- [[AI-Native Engineering Org]] — Fiona Fung (Claude Code eng director): JIT planning, Claude reviews style/bugs/humans review domain, kill obsolete processes, track ramp time + PR cycle time + Claude-assisted commit rate.
87	- [[Claude Code Skills Best Practices]] — Thariq Shihipar: 9 skill categories, Gotchas sections, progressive disclosure via file system, trigger keywords, `${CLAUDE_PLUGIN_DATA}` memory, on-demand hooks. From Anthropic's own usage.
88	- [[X AI Signal Ingestion Source]] — Regular monitored X source for high-signal AI voices. Uses browser-visible/public pages only; no credential extraction or social-account side effects.
89	- [[NanoClaw Slack Mention-Sticky Session Bug]] — Two stacked router bugs made a documented `session_mode='shared'` config inert on threaded adapters (Slack/Discord): a forced per-thread coercion, plus a sticky-engagement check that always did an exact-thread lookup regardless of the wiring's actual session mode. Fix makes `mention-sticky` self-bootstrapping: first message creates the shared session, every message after keeps engaging.
90	- [[NanoClaw REST Fallback Tool-Call Hallucination]] — A toolless LM Studio/Codex fallback rung hallucinated fake tool-call tags (`<read_file .../>`) instead of admitting it had no tools, and the existing `<message>`-block validation only checked the wrapper, not the content, so raw tag soup reached the user. Fixed with an output-side allowlist check + corrective retry + honest fallback, deliberately without over-fitting the routing heuristic.
91	- [[Hermes Provider Fallback Config]] — Configure Hermes LLM quota failover with top-level `fallback_providers`; put LM Studio first for cloud usage-limit failures, include only authenticated providers, and use Hermes' fallback CLI/runtime/gateway tests as evidence.
92	- [[Cowork Dispatcher-Specialist Pattern]] — Dispatcher routes intake → specialist agents execute → independent audit agent verifies → human reviews. Skills as living systems: corrections loop back into skill instructions. Applicable to qip-qien triage, nanoclaw agent architecture, and signal-routing in trading projects.
93	- [[Frontier Code Evaluation]] — Use your best engineers to test models on real production work; gate on "Would I keep this code?" Cognition's internal benchmark showed 3× Fable 5 improvement over prior Opus on their hardest subset.
94	- [[Cross-Agent Session State]] — A gitignored `.agent-state/session.md` Markdown handoff lets Claude Code, Codex, Antigravity, Grok, and local agents resume interrupted work from shared evidence-based state.
95	- [[Eval-Routed Local-First Code Delegation]] — Use a standing eval's machine-readable routing block to pick the cheap local default, per-task exceptions, and cloud-only task classes instead of guessing model choice.
96	- [[Freshness-Fit-Eval Model Radar]] — Separate external freshness discovery, hardware fit scoring, and local eval verdicts so a proxy scorer can help candidate selection without silently becoming the promotion metric.
97	- [[Productization and Pricing Research Concierge Reel Workflow]] — Stagehand go-to-market memo: sell a concierge reel retainer first, keep Telegram as intake, run locally until 2-3 paying clients, and charge for reviewed outcomes rather than raw AI access.
98	- [[Rulebook-Driven Migration Loop]] — Fix the translation rulebook → regenerate the affected batch, not individual files. Loop: Rulebook → Batch Generator → Output Files → Compiler/Tests → Error Feedback → Fix rule. Includes work-queue via file existence (resumable), build daemons, advisory model split (Fable 5 judgment + Opus workhorse), parity harnesses.
99	- [[Named-But-Unbuilt Skill References in CLAUDE.md]] — A CLAUDE.md line can *describe* a primitive (`get-from-secondbrain`/`add-to-secondbrain`) convincingly enough that no one checks it exists. Verify any named skill/script actually resolves to a file before trusting the instruction.
100	- [[Layer-Matrix Verification for Multi-Layer Rendering Bugs]] — When a visible feature is composited from several rendering layers, write the intended predicate per layer × mode as an explicit matrix, apply it atomically, and verify against the live rendered state (not a unit test) — watch for stale production builds.
101	- [[Default-Off for Heavy Optional Background Features]] — If an optional feature's real implementation is heavyweight (hidden webview, continuous polling) relative to the app's baseline cost, default it off; an opt-out toggle alone still exposes users who never read settings.
102	- [[A Reported Click Does Nothing Bug Can Be An Off-Screen Render]] — "clicked and nothing happened" can mean the state update is correct but the result rendered off-screen (e.g. a mobile reflow) — verify state changed and re-test at the actual breakpoint before concluding the handler is broken.
103	- [[Symlink Hijack in Skill Updaters]] — Any auto-updating CLI with write access to shared agent config can relink every agent's skill dir under `$HOME`, indistinguishable from a supply-chain attack. Decouple detection (sandboxed `HOME`+`PATH`, not just the tool's own scoping flag) from adoption.
104	- [[Converge on One Canonical Engine]] — Two agents each defaulting to their own implementation path for the same capability diverges silently until outputs are compared. Root cause is usually an asymmetric instruction file (e.g. `AGENTS.md` with no mirrored `CLAUDE.md`); fix with a guardrail test on file symmetry, not just better docs.
105
106	## 📢 Sponsor-only mentions
107	*Paid placements — not guest endorsements. Pages exist for reference.*
108	- [[Granola]] — AI meeting notes (Behind the Craft sponsor)
109	- [[Wispr Flow]] — Voice dictation (Behind the Craft sponsor)
110	- [[Linear]] — Project management / AI agent platform (Behind the Craft sponsor)
111
112	## Frameworks & Mental Models
113	- [[Apple Widget Rendering Modes]] — How to design SwiftUI widgets that work in both full-color and monochrome/accented modes (macOS, iOS, watchOS). Luminance zones, arc opacity, adaptive line colors, and `widgetAccentedRenderingMode`.
114	- [[WidgetKit Engineering Pitfalls]] — Infrastructure and data-layer pitfalls: intent-type orphaning, chronod descriptor caching, provider-data siloing, weekly-exhausted 5H row rules (0% + weekly reset + blank chart), and the early-cap reset pattern.
115	- [[Mac Widget Runtime Verification Loop]] — Layered macOS WidgetKit validation: active target membership, render tests, installed AppIntents metadata, chronod cache refresh, and desktop screenshot proof.
116	- [[Human Sandwich Model]] — Human frames → AI executes → Human judges. Dan Shipper's model for human-AI collaboration.
117	- [[Screenshot-First Visual Verification]] — Screenshots are the only ground truth for visual UI work; code correctness ≠ visual correctness.
118	- [[3-Layer Context Engineering System]] — Functional + Visual + Data layers for polished AI prototypes. Ravi Mehta's framework.
119	- [[Tokenmaxxing]] — Accusation that AI companies inflate token metrics; Boris Cherny's 250% productivity rebuttal.
120	- [[Saaspocalypse]] — Thesis that agents erode SaaS switching costs. Boris Cherny's nuanced take via Seven Powers.
121	- [[Claude Code Drift Problem]] — Config entropy at ~5 months: stale CLAUDE.md, bad folder structure, manual triggers that should be routines.
122	- [[4 AI Digital Employees Framework]] — 4 agent roles to "hire": Research Analyst, Strategic Advisor, Communication Specialist, Operations Manager.
123	- [[Friction-First Development]] — 6-principle philosophy for personal tool building: scratch your own itch, define the friction before the code, resist market-bias. Includes a pre-code Problem & Friction Analysis template.
124	- [[Devin vs Claude Code]] — Head-to-head comparison: philosophy, SWE-Bench (80.8% vs 13.86%), billing model, failure modes. Verdict: Claude Code wins for James's current stage.
125	- [[Frontier Model Qualitative Step Change]] — Pattern for treating credible practitioner reports as eval triggers when a model feels like a major-version jump on long tasks.
126	- [[Builder-Verifier Loop Pattern]] — Every code-writing loop needs a separate verifier running the real app. Builder makes the change; Verifier confirms feature correctness; you read the diff. Boris Cherny's core rule for avoiding confident-but-broken PRs.
127	- [[Question-Led Selling Arc]] — Synthesis of SPIN / Sandler / NEPQ / Oren Klaff / Chris Do into a four-step ask-don't-pitch arc (problem → change → cost → worth) plus a button-driven profiling block. Cross-project pattern for solution-selling sites' stage-2 discovery flow.
128	- [[Frontier Model Extraction Strategy]] — Frontier judgment required to *create*, ordinary intelligence sufficient to *use*. The irreversibility filter test: "Can a cheaper model redo this tomorrow?" Basis for the Learning Law in root CLAUDE.md.
129
130	## Reference
131	- [[Local Coding Model Benchmarks]] — 🔁 auto-maintained leaderboard for local (LM Studio/MLX) and cloud coding models on the `evals/local-code` gate, synced from `projects/` on every benchmark run. Includes a vetted list of where to source new local-model candidates (Aider Polyglot, LiveBench, model-discover.sh, aidatatools/ollama-benchmark) and a list of low-trust SEO leaderboards to avoid.
132	- [[Coding Agent Behavior Guide]] — INTJ-A derived instructions for coding agents working with James. Communication style, autonomy rules, pushback expectations, blindspot compensations.
133	- [[Ingestion Pipeline Patterns]] — 6 cost/quality optimization patterns for the wiki ingest pipeline: QFS, chapter chunking, map-reduce, tiered models, prompt caching, RAPTOR. Includes Phase 1–3 implementation order.
134	- [[Instagram Reel Transcription Pipeline]] — agent-browser + OpenAI Whisper pipeline for overnight reel-to-transcript processing. ~$0.003–$0.008/reel.
135	- [[Shared Vault Mount Guide]] — Step-by-step for mounting a shared host directory into multiple NanoClaw agent containers. `additionalMounts` config, allowlist setup, restart flow.
136	- [[Ryan Carson Tool Usage Notes]] — Detailed "how he actually uses it" notes for each tool from the May 24 episode (OpenClaw, Devin, Codex, Claude Code, Sentry, Tailscale, ClawChief).
137
138	## People
139	- [[James Lopez]] — Owner of this wiki. INTJ-A, mobile engineer (LinkedIn iOS), Austin TX. Full personality profile and background.
140	- [[Ramón Lopez]] — James's brother. Sr. Director Digital Manufacturing Architecture at Jabil. 25+ yrs medical device quality (FDA/ISO 13485). Domain expert persona for qip-qien.
141	- [[Ryan Carson]] — 5x founder, building Untangle solo with AI agents.
142	- [[Peter Yang]] — Host of Behind the Craft podcast.
143	- [[Dan Shipper]] — Co-founder of Every. Author of "After Automation."
144	- [[Andrej Karpathy]] — AI researcher and educator. High-signal source on frontier model capability and workflow ergonomics.
145	- [[Simon Willison]] — Developer and LLM tooling analyst. High-signal source on evals, sandboxing, cost accounting, and practical AI tools.
146	- [[Nathaniel Whittemore]] — Host of The AI Daily Brief.
147	- [[Ravi Mehta]] — AI instructor, ex-CPO Tinder. Created 3-layer context engineering system.
148	- [[Boris Cherny]] — Head of Claude Code at Anthropic.
149	- [[Alex Kantrowitz]] — Host of Big Technology Podcast.
150	- [[Gael Breton]] — Co-founder, Authority Hacker. Small biz AI automation practitioner.
151	- [[Mark Webster]] — Co-founder, Authority Hacker.
152	- [[Nufar Gaspar]] — Co-host, The AI Daily Brief.
153	- [[Delba de Oliveira]] — MTS Claude Code engineer at Anthropic. Created "Claude Code Patterns: Feedback loops" video — Cherny's cited breakdown of self-verification.
154	- [[Josh Pigford]] — Solo founder building 5 apps with AI agents. Creator of /but-for-real, /adversarial-code-review, /build, /learnings skills.
155	- [[Max Junestrand]] — Founder/CEO of Legora. Building AI-native OS for legal teams on Claude.
156
157	## Sources
158	- [[AI Daily Brief - The 4 AI Team Members Execs Should Hire Right Now]] — May 25, 2026. Framework for 4 agent roles leaders should implement.
159	- [[Instagram - hegetfunds - Claude Code Team of Developers]] — May 6, 2026. Using plugins/skills to assign specialist developer roles in Claude Code.
160	- [[Authority Hacker - Claude Code Setup Roast]] — May 21, 2026. 5-month setup audit: CLAUDE.md, folder structure, drift problem.
161	- [[Big Technology Podcast - Boris Cherny Claude Code]] — May 20, 2026. Claude Code growth, tokenmaxxing, agents beyond coding.
162	- [[Behind the Craft - Ryan Carson Episode]] — May 24, 2026. Tools for running a solo startup with AI agents.
163	- [[Behind the Craft - Ravi Mehta Context Engineering]] — May 3, 2026. 3-layer context engineering system with live demo.
164	- [[AI Daily Brief - Why Agents Still Need Humans]] — May 24, 2026. Covers Dan Shipper's After Automation essay.
165	- [[Dan Shipper - After Automation Essay]] — May 21, 2026. Why AI creates more expert human work, not less.
166	- [[Cheeky Pint - Dario Amodei Interview]] — Aug 6, 2025 (ingested May 30, 2026). Dario Amodei on Anthropic's business model, market structure, AGI-pilled products, the AI UI problem, regulation, and how he uses AI.
167	- [[Behind the Craft - Josh Pigford AI Skills Stack]] — May 31, 2026. Solo founder's exact AI skills: /build, /adversarial-code-review, /but-for-real (self-audit), /learnings. Transcript pending.
168	- [[CWC - Problem Solvers Max Junestrand Legora]] — June 2, 2026. Legora's bet on Claude as AI-native legal OS. "Raises the tide" model thesis.
169	- [[Authority Hacker - Claude Opus 4.8 Review]] — May 29, 2026. What changed: 4.7 regression fixed, more honest, 4x fewer logic errors in code. Full transcript pending.
170	- [[Claude Blog - Dynamic Workflows in Claude Code]] — June 2, 2026. Claude writes its own JS harness on the fly (`ultracode`). 6 patterns: classify-and-act, fan-out-and-synthesize, adversarial verification, generate-and-filter, tournament, loop-until-done.
171	- [[Claude Blog - Introducing Dynamic Workflows]] — May 28, 2026. Announcement post: availability, plan tiers, Bun Zig→Rust case study (750K lines, 11 days, 99.8% tests passing).
172	- [[Claude Blog - Managed Agents Self-Hosted Sandboxes]] — May 19, 2026. Sandbox providers: Cloudflare, Daytona, Modal, Vercel. MCP Tunnels for private-network MCP servers.
173	- [[Claude Blog - Founders Playbook]] — May 14, 2026. 4 AI-remapped startup stages + Chat/Cowork/Claude Code tool selection matrix. PDF download available.
174	- [[Claude Blog - Running an AI-Native Engineering Org]] — June 3, 2026. Fiona Fung on JIT planning, killing obsolete processes, metrics, and blurred roles.
175	- [[Claude Blog - Lessons from Building Claude Code How We Use Skills]] — June 3, 2026. Thariq Shihipar: 9 skill categories, best practices, distribution models, measurement via PreToolUse hooks.
176	- [[Claude Blog - Claude Cowork Product Guide]] — June 5, 2026. Official product guide: 7 workflow templates, permissions model, plugin usage, 3-tool selection matrix. eBook available.
177	- [[X AI Signal Sweep - 2026-06-09]] — Seed sweep for the regular X source. Captures Karpathy, Simon Willison, Dan Shipper, Ethan Mollick, and Claude Fable 5 / Mythos field reports.
178	- [[Claude Blog - Best Practices for Claude Cowork]] — June 3, 2026. Chat vs Cowork vs Claude Code matrix. 5 ingredients of a Cowork task. Context > prompt quality.
179	- [[Claude Blog - Self-Service Data Analytics with Claude]] — June 3, 2026. 3 failure modes + 4-layer architecture for agentic analytics. 95% query automation at 95% accuracy.
180	- [[0xchromium - Claude Workflows That Run Without You]] — June 4, 2026. 4-part workflow anatomy (Role/Tools/Trigger/Output), 12 workflow templates by role, 5-step build process, copy-paste morning briefing prompt.
181	- [[Andrej Karpathy - How I Use LLMs]] — Feb 27, 2025. 2h11m practical guide: zip-file mental model, LLM council approach, model selection matrix, tool integration hierarchy. Full chapter list.
182	- [[Claude Blog - Claude for Foundation Models]] — June 8, 2026. Swift package for hybrid Apple apps: on-device model + Claude handoff. iOS/macOS 27+, typed Swift inputs, streaming to SwiftUI.
183	- [[Claude Blog - Connector Observability]] — June 8, 2026. Performance dashboards (active users, tool calls, latency by tool) for published MCP connectors. In-app directory submission. Public beta.
184	- [[Reddit - Depureco MCP Case Study]] — June 2026. Depureco (Italian industrial vacuum manufacturer) connected product catalog to Claude via Remote MCP. Key insight: grounded AI becomes more humble and asks better questions — directly applicable to qip-qien and any regulated/safety-critical B2B tool.
185	- [[Mountain Movers - Boris Cherny Loop Definition]] — June 2026. Cherny's 3-stage engineer evolution + definition of a loop as a program that prompts, reads, evaluates, re-prompts. Hard stops, skills vs. plumbing distinction, cost reality (Uber $1,500/mo cap).
186	- [[Claude Blog - Building With Claude Managed Agents]] — June 10, 2026. Foundational engineering post: decoupled harness/sandbox architecture (p50 ~60% / p95 >90% latency reduction), Dreaming (scheduled memory refinement), Outcomes (agent self-grading), context anxiety history, three-phase evolution, when-to-use guidance.
187	- [[Claude Blog - Whats New in Claude Managed Agents]] — June 9, 2026. Two new public beta features: scheduled deployments (cron, no infra) and env vars in vaults (credential injection at network boundary). Customer examples: Rakuten, Notion, Browserbase, Milana.
188	- [[Alpha Batcher - Boris Cherny 5-Day Claude Code Setup]] — June 9, 2026. 5-day progressive setup ladder from Boris Cherny's loop philosophy. Includes embedded "Reflecting on a year of Claude Code" video (18 min) with Cherny & Cat Wu.
189	- [[Boris Cherny - Self-Verification Loops]] — June 9, 2026. Cherny's own statement: self-verification is the mechanism that enables longer autonomous runs. Cites ClaudeDevs video by Delba de Oliveira (839K views).
190	- [[DCBitMax - Bitcoin Power Law Out-of-Sample Test]] — June 10, 2026. Out-of-sample validation of Bitcoin Power Law using Claude Opus 4.8. Froze model at 2016 → 10-year mean residual −0.05σ. Same validation methodology applies to congressional-trading.
191	- [[AdiiX - Claude Trading Bot Architecture]] — June 9, 2026. 7.1M views. Claude Code writes trading logic; Claude Cowork sends 7am/9pm daily briefings. Multi-asset: SPX/NDX mean reversion (15m), crypto momentum (1h), commodities trend (4h). ATR sizing + correlation filter. No repo — marketing post. Architecture applicable to tradingbot25 and congressional-trading.
192	- [[Claude Blog - Field Guide to Claude Fable]] — July 6, 2026. Thariq Shihipar. 4-quadrant unknowns framework, 8 elicitation techniques (blind spot pass, interview mode, reference prompting, implementation plan, explainer, quiz). Core claim: with Fable, output quality is now bottlenecked by user clarity, not model capability.
193	- [[Claude Blog - Marketing Ops Cowork Automation]] — July 8, 2026. Anthropic's own marketing ops team. Dispatcher-specialist architecture, audit agent pattern, skill refinement loops. Concrete Cowork workflow patterns applicable to qip-qien and nanoclaw.
194	- [[Claude Blog - Cognition Claude Fable 5]] — July 10, 2026. Silas Alberti (Cognition SVP of Research). Production validation: 8h overnight autonomous runs, 3× improvement on Frontier Code hardest subset (30% vs 10% prior Opus), honest uncertainty, tool use under noise.
195	- [[Claude Blog - Working at the Frontier Cursor]] — July 17, 2026. Cursor's evaluation of Fable 5: 72.9% on CursorBench. Global vs local reasoning framing: Fable figures out what B is when you don't know; lighter models for when B is clear. Route by problem ambiguity, not just complexity.
196	- [[Claude Blog - CISO Guide to Agentic AI]] — July 17, 2026. Jason Clinton (Anthropic Deputy CISO). Four-question agent assessment framework + seven governance requirements. Service account vs human credential agents. Key: shadow adoption is worse than governed adoption; design for model capability in 6 months, not today.
197	- [[Claude Blog - AI Code Migration]] — July 16, 2026. Large-scale code migration in days using multi-agent loops. Core insight: "You don't fix the code. You fix the process (loop) that produced the code." Six-step process, real proof: Bun 1M-line Zig→Rust (2 weeks), Python→TS 165k lines (weekend).
198	- [[Claude Blog - Fable 5 in Claude Cowork]] — July 16, 2026. Josefina Albert (Anthropic Education). New Fable 5 Cowork features: adjustable effort settings, transparent planning panel, multi-day context retention. Delegation model: define done, hand off, review outputs.
199
200	[[Wiki Ingest Log]]
201

# Wiki Index

A catalog of everything in this knowledge base. Updated by Nano on every ingest.

## Tools & Software
*Guest-endorsed or actively used — not sponsors.*
- [[Agent Browser]] — Vercel Labs Rust CLI for AI-driven browser automation. Credential vault, accessibility-tree refs, React introspection, HAR recording.
- [[Devin]] — AI coding agent by Cognition. 15-thread code factory model.
- [[OpenClaw]] — Open-source AI executive assistant / chief of staff.
- [[ClawChief]] — Ryan Carson's open-sourced OpenClaw chief-of-staff config.
- [[Claude Code]] — Anthropic's coding agent. Ryan Carson's preferred coding tool.
- [[Codex]] — OpenAI's coding agent / browser testing tool.
- [[Sentry]] — Error monitoring. Used with Devin for automated bug triage.
- [[Tailscale]] — WireGuard mesh network. Used for remote access to Mac Mini services from phone. Includes full recipe for exposing any local port via `tailscale serve` + launchd.
- [[Figma]] — Design/wireframing. Visual context layer in Ravi Mehta's system.
- [[AgentsView]] — Agent token/cost accounting tool. Useful when new frontier-model pricing appears before dashboards and pricing databases catch up.
- [[Teach Skill]] — `/teach` by Matt Pocock. ZPD-based personalized tutor with persistent learning records. Trigger-based (no idle context cost). Claude Code only. Install: `npx skills add mattpocock/skills --skill teach`.

## Anthropic Official Repos & Resources
*Official Anthropic repositories — tools, SDKs, plugins, and reference implementations.*
- [[Anthropic Skills Repo]] — Reference implementations of the Claude Agent Skills system. Template for building custom skills.
- [[Claude Plugins Official]] — Anthropic's curated plugin marketplace for Claude Code. Install via `/plugin install`.
- [[Ralph Loop Plugin]] — Stop-hook-based autonomous iteration loop. Feeds Claude the same prompt until it outputs a completion promise. For well-defined tasks with clear success criteria and automatic verification.
- [[Hookify Plugin]] — Create Claude Code hooks from natural language. `/hookify warn me when I use rm -rf` → working hook instantly. No hooks.json editing required.
- [[Knowledge Work Plugins]] — 18 open-source role-specific plugins (sales, legal, finance, design, engineering, HR, ops, etc.) built on Claude Agent SDK.
- [[Claude for Legal]] — Deep legal workflow plugin suite (transactional + litigation + learning). Integrates with Westlaw, CourtListener.
- [[Claude for Life Sciences]] — Research marketplace: PubMed, BioRender, Synapse, Consensus + RNA-seq/Nextflow skills.
- [[Claude for Healthcare]] — Healthcare marketplace: FHIR developer, prior-auth review, clinical trial protocols + CMS/NPI servers.
- [[Claude for Financial Services]] — 10 named agents (Pitch Agent, GL Reconciler, Market Researcher, KYC Screener, etc.) + 9 vertical skill bundles (IB, ER, PE, WM, fund admin). Deployable as Cowork plugins or Managed Agent templates.
- [[Managed Agents]] — Anthropic's hosted agent orchestration platform. Self-hosted sandbox option (tool execution on your infra via outbound-polling worker), mid-session tool/MCP updates, large MCP output auto-offload. Scheduled deployments (cron, no custom infra). Env vars in vaults (credentials injected at network boundary). Opus 4.8 tool-description guidance included.
- [[Claude Agent SDK Demos]] — 8 local demo apps showcasing Claude Agent SDK patterns (multi-agent, streaming, email, docs).
- [[Anthropic SDK Go]] — `go get anthropic-sdk-go@v1.56.0`. Go 1.24+. Type-safe Claude API client for Go: model constants, context support, standard Go idioms.
- [[Anthropic SDK Java]] — `com.anthropic:anthropic-java:2.49.0`. Java 8+. Maven/Gradle. Builder-pattern Claude API client for JVM applications.
- [[Claude Agent SDK TypeScript]] — `npm install @anthropic-ai/claude-agent-sdk`. Node.js 18+. Renamed from Claude Code SDK.
- [[Claude Agent SDK Python]] — `pip install claude-agent-sdk`. Python 3.10+. In-process MCP servers, hooks as Python functions, CLI bundled in wheel.
- [[Claude Cookbooks]] — Copy-paste code recipes and notebooks for Claude API (RAG, tool use, multimodal, agents).
- [[Claude Quickstarts]] — Production-ready starter projects: customer support, computer use, browser automation, coding agent.
- [[Anthropic Courses]] — 5-course official curriculum: API fundamentals → prompt engineering → real-world prompting → evals → tool use. Jupyter notebooks.
- [[Anthropic Prompt Engineering Tutorial]] — 9-chapter interactive prompt engineering course with exercise playgrounds. Available direct API and Amazon Bedrock variants.
- [[Claude Code Action]] — GitHub Action that brings Claude into PR review and CI/CD workflows.
- [[Defending Code Reference Harness]] — Reference impl for autonomous vuln discovery + human-reviewed patching. gVisor-sandboxed agents. Not actively maintained; Claude Security is the hosted version.
- [[Scone Bench]] — 417-task benchmark for evaluating LLM agents on smart-contract vuln discovery/exploitation. Historical DeFi incidents, MCP-based, Docker-sandboxed. From Anthropic Red Team.
- [[Claudes C Compiler]] — Claude Opus 4.6 wrote a dependency-free C compiler in Rust from scratch. Compiles PostgreSQL, SQLite, Linux kernel, FFmpeg. Capability showcase, not production-validated.
- [[Anthropic Performance Take-Home]] — Open version of Anthropic's original performance engineering take-home. Optimize a VLIW SIMD kernel; Claude Opus 4.5 scored 1,363 cycles vs 147,734 baseline (108× improvement).
- [[Claude Code Security Review]] — GitHub Action that auto-scans PRs for security vulnerabilities using Claude.
- [[Claude Desktop Buddy]] — ESP32 desk pet + Bluetooth API reference for makers integrating with Claude Desktop.
- [[HTML Effectiveness Examples]] — Anthropic's reference collection of single-file HTML artifacts (slide decks, dashboards, editing UIs, diagrams).
- [[Claude Code Setup Plugin]] — Official Anthropic plugin that scans your codebase and recommends tailored hooks, skills, MCP servers, subagents, and plugins. Read-only, 1-2 recs per category.
- [[Claude Code Monitoring Guide]] — Prometheus + OpenTelemetry toolkit for tracking Claude Code ROI, token spend, and team adoption.
- [[GitHub MCP Server]] — GitHub's official MCP server.
- [[PineForge MCP]] — Hosted MCP server for real Pine Script v6 backtests. `claude mcp add --transport http pineforge https://mcp.pineforge.dev/mcp`. No key/signup. 245/246 TradingView parity, 100 backtests/week, 13mo Binance data. Docker route for unlimited/custom data. 60+ tools: repos, issues, PRs, code search, security scanning.
- [[Devcontainer Features]] — One-line devcontainer.json feature that installs Claude Code CLI in any dev container.
- [[Claude Code Routines]] — Scheduled/triggered cloud automation. Runs on Anthropic infrastructure, not your machine. `/schedule` command, API + GitHub + time triggers. Research preview.
- [[Long-Running Agent Primitives]] — 3 core primitives (Default-FAIL, Fresh-context evaluator, Handoff) + 2 operator hooks (kill switch, STEER.md). From Anthropic's own patterns.
- [[Claude Code Migration Kit]] — Official Anthropic toolkit for large-scale language migrations. 8 sequential prompts (00-feasibility → 06-post-parity), templates (RULEBOOK.md, manifest.tsv, inventory.tsv, cost-log.tsv, settings.json), scripts (dependency mappers, queue runners, build daemons). Companion to the AI Code Migration blog post. Operationalizes [[Rulebook-Driven Migration Loop]].
- [[Claude Plugins Community]] — Community plugin marketplace (security-reviewed). Submit at clau.de/plugin-directory-submission.
- [[Anthropic CLI]] — `ant` CLI for the Claude Developer Platform API. `brew install anthropics/tap/ant`.
- [[Anthropic CWC Workshops]] — 8 Code-with-Claude workshop curricula: Managed Agents, memory primitives (Dreaming Service), eval-driven dev, multi-agent decomposition, Deal Desk reference impl.
- [[Agent SDK Workshop]] — Hands-on workshop for Claude Agent SDK: 4-stage guided demo (chat → tools → subagents → memory) + breakout scenarios. Python 3.10+, flip switches in config.py.
- [[Long-Horizon Coding Agent Demo]] — Archived AWS re:Invent 2025 demo. GitHub issue → agent builds full-stack app → CloudFront preview → human approval gate. Bedrock AgentCore + Claude Agent SDK.
- [[Claude Foundation Models Swift Package]] — Swift package for hybrid Apple-platform apps: on-device model for fast/private tasks, Claude for reasoning + web search. iOS 27+, SPM install. Announced June 2026.
- [[Claude Tag Plugins]] — 19 SaaS integration plugins (Jira, Linear, Snowflake, Salesforce, Sentry, Datadog, etc.) via Claude Tag CLI. Credentials injected at runtime; install only what you need.
- [[Launch Your Agent]] — Claude Code skill that guides a founder from raw idea to live Claude Managed Agent: interview → scope → deploy → grade → schedule. One session, costs cents.
- [[Claude Fable 5 and Mythos 5]] — Anthropic's latest frontier models. Always-on adaptive thinking, new tokenizer (~30% more tokens), refusal stop reason + SDK fallback middleware, 30-day data-retention requirement. Fable 5 = GA; Mythos 5 = Preview.

## Third-Party Tools & Platforms
- [[Supertonic]] — On-device TTS. 66M params, ONNX, MIT license. 167× realtime on M4 Pro. Zero cost, zero cloud. Drop-in OpenAI TTS API compatible. Primary use case: StageHand narration replacing ElevenLabs.
- [[Legora]] — AI-native operating system for legal teams. Autonomously plans, executes, reviews, and completes complex legal work end-to-end. Built on Claude. "Raises the tide" model: improves with each Claude release.

## Sources (Talks, Posts, Papers)
- [[Claude CwC - The Prompting Playbook]] — Margot van Laar (Anthropic), CwC London 2026. Eval-first, XML structure, delete legacy patches, tools > instructions, Generator→Evaluator→Repairer loop.

## Concepts & Reference Docs
- [[Test Isolation for Runtime Activity Logs]] — Prevent orchestration tests from polluting live alert/error/state feeds by redirecting module-level runtime paths to `tmp_path`, then prove production logs are unchanged by the suite.
- [[LaunchAgent Quarantine and Tailscale Recovery]] — Recover a reboot-stalled local site by clearing the LaunchAgent quarantine and re-bootstrapping it, then separately reconnecting Tailscale and verifying both local and public routes.
- [[Orthogonal Visual Channels on Map Lines]] — Don't recolor a line to encode a boolean when color already carries a scalar; add a near-black dotted overlay (Mapbox: short dash + round cap, dasharray units are line-widths so zoom-scaling is free). Plus a puppeteer pattern for E2E-verifying map layers via the app's own custom events.
- [[CLAUDE.md Progressive Disclosure]] — Every-session context files hold only always-relevant rules; situational procedures move to `.claude/docs/` behind trigger-phrased pointers. Measure per-section cost first; add a size budget against regrowth.
- [[Claude Constitution]] — Anthropic's foundational values document. CC0 licensed. January 2026.
- [[Agentic UI Impedance Mismatch]] — Dario Amodei's framing: agents will complete tasks end-to-end most of the time, but humans need deep-dive inspection capability for the exceptions. No product solves this yet.
- [[Claude Code Subagents]] — Separate Claude instances with their own context windows. 5 copy-paste templates (reviewer, test-writer, doc-writer, security, pr-writer). Route to Sonnet for 5× cost savings.
- [[WebMCP]] — Chrome's proposed web standard for exposing structured tools to AI agents. Declarative HTML annotations + JS API replace fragile UI actuation. Origin trial in Chrome 149.
- [[But For Real Skill]] — Self-audit pattern: follow-up prompt that assumes bugs are present and bullies the AI into finding them. Simulates PR code review. From Josh Pigford's solo-founder skills stack.
- [[Claude Code Agent Teams]] — Native experimental feature: Team Lead + Teammates model with shared task list, dependency management, plan approval, and hooks. Enable via env flag. Claude Code only (no Codex/Aider).
- [[Claude Code Dynamic Workflows]] — Claude writes its own JS orchestration harness on the fly (`ultracode` keyword). 6 patterns: classify-and-act, fan-out-and-synthesize, adversarial verification, generate-and-filter, tournament, loop-until-done. Opus 4.8 era.
- [[Finding Your Unknowns Framework]] — Pre-flight protocol for agentic work. 4-quadrant unknowns model (Known/Unknown × Knowns/Unknowns) + 8 elicitation techniques (blind spot pass, interview mode, reference prompting, implementation plan, explainer artifact, quiz mode). Fable-era shift: user clarity is now the bottleneck, not model capability.
- [[AI-Native Engineering Org]] — Fiona Fung (Claude Code eng director): JIT planning, Claude reviews style/bugs/humans review domain, kill obsolete processes, track ramp time + PR cycle time + Claude-assisted commit rate.
- [[Claude Code Skills Best Practices]] — Thariq Shihipar: 9 skill categories, Gotchas sections, progressive disclosure via file system, trigger keywords, `${CLAUDE_PLUGIN_DATA}` memory, on-demand hooks. From Anthropic's own usage.
- [[X AI Signal Ingestion Source]] — Regular monitored X source for high-signal AI voices. Uses browser-visible/public pages only; no credential extraction or social-account side effects.
- [[NanoClaw Slack Mention-Sticky Session Bug]] — Two stacked router bugs made a documented `session_mode='shared'` config inert on threaded adapters (Slack/Discord): a forced per-thread coercion, plus a sticky-engagement check that always did an exact-thread lookup regardless of the wiring's actual session mode. Fix makes `mention-sticky` self-bootstrapping: first message creates the shared session, every message after keeps engaging.
- [[NanoClaw REST Fallback Tool-Call Hallucination]] — A toolless LM Studio/Codex fallback rung hallucinated fake tool-call tags (`<read_file .../>`) instead of admitting it had no tools, and the existing `<message>`-block validation only checked the wrapper, not the content, so raw tag soup reached the user. Fixed with an output-side allowlist check + corrective retry + honest fallback, deliberately without over-fitting the routing heuristic.
- [[Hermes Provider Fallback Config]] — Configure Hermes LLM quota failover with top-level `fallback_providers`; put LM Studio first for cloud usage-limit failures, include only authenticated providers, and use Hermes' fallback CLI/runtime/gateway tests as evidence.
- [[Cowork Dispatcher-Specialist Pattern]] — Dispatcher routes intake → specialist agents execute → independent audit agent verifies → human reviews. Skills as living systems: corrections loop back into skill instructions. Applicable to qip-qien triage, nanoclaw agent architecture, and signal-routing in trading projects.
- [[Frontier Code Evaluation]] — Use your best engineers to test models on real production work; gate on "Would I keep this code?" Cognition's internal benchmark showed 3× Fable 5 improvement over prior Opus on their hardest subset.
- [[Cross-Agent Session State]] — A gitignored `.agent-state/session.md` Markdown handoff lets Claude Code, Codex, Antigravity, Grok, and local agents resume interrupted work from shared evidence-based state.
- [[Eval-Routed Local-First Code Delegation]] — Use a standing eval's machine-readable routing block to pick the cheap local default, per-task exceptions, and cloud-only task classes instead of guessing model choice.
- [[Freshness-Fit-Eval Model Radar]] — Separate external freshness discovery, hardware fit scoring, and local eval verdicts so a proxy scorer can help candidate selection without silently becoming the promotion metric.
- [[Productization and Pricing Research Concierge Reel Workflow]] — Stagehand go-to-market memo: sell a concierge reel retainer first, keep Telegram as intake, run locally until 2-3 paying clients, and charge for reviewed outcomes rather than raw AI access.
- [[Rulebook-Driven Migration Loop]] — Fix the translation rulebook → regenerate the affected batch, not individual files. Loop: Rulebook → Batch Generator → Output Files → Compiler/Tests → Error Feedback → Fix rule. Includes work-queue via file existence (resumable), build daemons, advisory model split (Fable 5 judgment + Opus workhorse), parity harnesses.
- [[Named-But-Unbuilt Skill References in CLAUDE.md]] — A CLAUDE.md line can *describe* a primitive (`get-from-secondbrain`/`add-to-secondbrain`) convincingly enough that no one checks it exists. Verify any named skill/script actually resolves to a file before trusting the instruction.
- [[Layer-Matrix Verification for Multi-Layer Rendering Bugs]] — When a visible feature is composited from several rendering layers, write the intended predicate per layer × mode as an explicit matrix, apply it atomically, and verify against the live rendered state (not a unit test) — watch for stale production builds.
- [[Default-Off for Heavy Optional Background Features]] — If an optional feature's real implementation is heavyweight (hidden webview, continuous polling) relative to the app's baseline cost, default it off; an opt-out toggle alone still exposes users who never read settings.
- [[A Reported Click Does Nothing Bug Can Be An Off-Screen Render]] — "clicked and nothing happened" can mean the state update is correct but the result rendered off-screen (e.g. a mobile reflow) — verify state changed and re-test at the actual breakpoint before concluding the handler is broken.
- [[Symlink Hijack in Skill Updaters]] — Any auto-updating CLI with write access to shared agent config can relink every agent's skill dir under `$HOME`, indistinguishable from a supply-chain attack. Decouple detection (sandboxed `HOME`+`PATH`, not just the tool's own scoping flag) from adoption.
- [[Converge on One Canonical Engine]] — Two agents each defaulting to their own implementation path for the same capability diverges silently until outputs are compared. Root cause is usually an asymmetric instruction file (e.g. `AGENTS.md` with no mirrored `CLAUDE.md`); fix with a guardrail test on file symmetry, not just better docs.

## 📢 Sponsor-only mentions
*Paid placements — not guest endorsements. Pages exist for reference.*
- [[Granola]] — AI meeting notes (Behind the Craft sponsor)
- [[Wispr Flow]] — Voice dictation (Behind the Craft sponsor)
- [[Linear]] — Project management / AI agent platform (Behind the Craft sponsor)

## Frameworks & Mental Models
- [[Apple Widget Rendering Modes]] — How to design SwiftUI widgets that work in both full-color and monochrome/accented modes (macOS, iOS, watchOS). Luminance zones, arc opacity, adaptive line colors, and `widgetAccentedRenderingMode`.
- [[WidgetKit Engineering Pitfalls]] — Infrastructure and data-layer pitfalls: intent-type orphaning, chronod descriptor caching, provider-data siloing, weekly-exhausted 5H row rules (0% + weekly reset + blank chart), and the early-cap reset pattern.
- [[Mac Widget Runtime Verification Loop]] — Layered macOS WidgetKit validation: active target membership, render tests, installed AppIntents metadata, chronod cache refresh, and desktop screenshot proof.
- [[Human Sandwich Model]] — Human frames → AI executes → Human judges. Dan Shipper's model for human-AI collaboration.
- [[Screenshot-First Visual Verification]] — Screenshots are the only ground truth for visual UI work; code correctness ≠ visual correctness.
- [[3-Layer Context Engineering System]] — Functional + Visual + Data layers for polished AI prototypes. Ravi Mehta's framework.
- [[Tokenmaxxing]] — Accusation that AI companies inflate token metrics; Boris Cherny's 250% productivity rebuttal.
- [[Saaspocalypse]] — Thesis that agents erode SaaS switching costs. Boris Cherny's nuanced take via Seven Powers.
- [[Claude Code Drift Problem]] — Config entropy at ~5 months: stale CLAUDE.md, bad folder structure, manual triggers that should be routines.
- [[4 AI Digital Employees Framework]] — 4 agent roles to "hire": Research Analyst, Strategic Advisor, Communication Specialist, Operations Manager.
- [[Friction-First Development]] — 6-principle philosophy for personal tool building: scratch your own itch, define the friction before the code, resist market-bias. Includes a pre-code Problem & Friction Analysis template.
- [[Devin vs Claude Code]] — Head-to-head comparison: philosophy, SWE-Bench (80.8% vs 13.86%), billing model, failure modes. Verdict: Claude Code wins for James's current stage.
- [[Frontier Model Qualitative Step Change]] — Pattern for treating credible practitioner reports as eval triggers when a model feels like a major-version jump on long tasks.
- [[Builder-Verifier Loop Pattern]] — Every code-writing loop needs a separate verifier running the real app. Builder makes the change; Verifier confirms feature correctness; you read the diff. Boris Cherny's core rule for avoiding confident-but-broken PRs.
- [[Question-Led Selling Arc]] — Synthesis of SPIN / Sandler / NEPQ / Oren Klaff / Chris Do into a four-step ask-don't-pitch arc (problem → change → cost → worth) plus a button-driven profiling block. Cross-project pattern for solution-selling sites' stage-2 discovery flow.
- [[Frontier Model Extraction Strategy]] — Frontier judgment required to *create*, ordinary intelligence sufficient to *use*. The irreversibility filter test: "Can a cheaper model redo this tomorrow?" Basis for the Learning Law in root CLAUDE.md.

## Reference
- [[Local Coding Model Benchmarks]] — 🔁 auto-maintained leaderboard for local (LM Studio/MLX) and cloud coding models on the `evals/local-code` gate, synced from `projects/` on every benchmark run. Includes a vetted list of where to source new local-model candidates (Aider Polyglot, LiveBench, model-discover.sh, aidatatools/ollama-benchmark) and a list of low-trust SEO leaderboards to avoid.
- [[Coding Agent Behavior Guide]] — INTJ-A derived instructions for coding agents working with James. Communication style, autonomy rules, pushback expectations, blindspot compensations.
- [[Ingestion Pipeline Patterns]] — 6 cost/quality optimization patterns for the wiki ingest pipeline: QFS, chapter chunking, map-reduce, tiered models, prompt caching, RAPTOR. Includes Phase 1–3 implementation order.
- [[Instagram Reel Transcription Pipeline]] — agent-browser + OpenAI Whisper pipeline for overnight reel-to-transcript processing. ~$0.003–$0.008/reel.
- [[Shared Vault Mount Guide]] — Step-by-step for mounting a shared host directory into multiple NanoClaw agent containers. `additionalMounts` config, allowlist setup, restart flow.
- [[Ryan Carson Tool Usage Notes]] — Detailed "how he actually uses it" notes for each tool from the May 24 episode (OpenClaw, Devin, Codex, Claude Code, Sentry, Tailscale, ClawChief).

## People
- [[James Lopez]] — Owner of this wiki. INTJ-A, mobile engineer (LinkedIn iOS), Austin TX. Full personality profile and background.
- [[Ramón Lopez]] — James's brother. Sr. Director Digital Manufacturing Architecture at Jabil. 25+ yrs medical device quality (FDA/ISO 13485). Domain expert persona for qip-qien.
- [[Ryan Carson]] — 5x founder, building Untangle solo with AI agents.
- [[Peter Yang]] — Host of Behind the Craft podcast.
- [[Dan Shipper]] — Co-founder of Every. Author of "After Automation."
- [[Andrej Karpathy]] — AI researcher and educator. High-signal source on frontier model capability and workflow ergonomics.
- [[Simon Willison]] — Developer and LLM tooling analyst. High-signal source on evals, sandboxing, cost accounting, and practical AI tools.
- [[Nathaniel Whittemore]] — Host of The AI Daily Brief.
- [[Ravi Mehta]] — AI instructor, ex-CPO Tinder. Created 3-layer context engineering system.
- [[Boris Cherny]] — Head of Claude Code at Anthropic.
- [[Alex Kantrowitz]] — Host of Big Technology Podcast.
- [[Gael Breton]] — Co-founder, Authority Hacker. Small biz AI automation practitioner.
- [[Mark Webster]] — Co-founder, Authority Hacker.
- [[Nufar Gaspar]] — Co-host, The AI Daily Brief.
- [[Delba de Oliveira]] — MTS Claude Code engineer at Anthropic. Created "Claude Code Patterns: Feedback loops" video — Cherny's cited breakdown of self-verification.
- [[Josh Pigford]] — Solo founder building 5 apps with AI agents. Creator of /but-for-real, /adversarial-code-review, /build, /learnings skills.
- [[Max Junestrand]] — Founder/CEO of Legora. Building AI-native OS for legal teams on Claude.

## Sources
- [[AI Daily Brief - The 4 AI Team Members Execs Should Hire Right Now]] — May 25, 2026. Framework for 4 agent roles leaders should implement.
- [[Instagram - hegetfunds - Claude Code Team of Developers]] — May 6, 2026. Using plugins/skills to assign specialist developer roles in Claude Code.
- [[Authority Hacker - Claude Code Setup Roast]] — May 21, 2026. 5-month setup audit: CLAUDE.md, folder structure, drift problem.
- [[Big Technology Podcast - Boris Cherny Claude Code]] — May 20, 2026. Claude Code growth, tokenmaxxing, agents beyond coding.
- [[Behind the Craft - Ryan Carson Episode]] — May 24, 2026. Tools for running a solo startup with AI agents.
- [[Behind the Craft - Ravi Mehta Context Engineering]] — May 3, 2026. 3-layer context engineering system with live demo.
- [[AI Daily Brief - Why Agents Still Need Humans]] — May 24, 2026. Covers Dan Shipper's After Automation essay.
- [[Dan Shipper - After Automation Essay]] — May 21, 2026. Why AI creates more expert human work, not less.
- [[Cheeky Pint - Dario Amodei Interview]] — Aug 6, 2025 (ingested May 30, 2026). Dario Amodei on Anthropic's business model, market structure, AGI-pilled products, the AI UI problem, regulation, and how he uses AI.
- [[Behind the Craft - Josh Pigford AI Skills Stack]] — May 31, 2026. Solo founder's exact AI skills: /build, /adversarial-code-review, /but-for-real (self-audit), /learnings. Transcript pending.
- [[CWC - Problem Solvers Max Junestrand Legora]] — June 2, 2026. Legora's bet on Claude as AI-native legal OS. "Raises the tide" model thesis.
- [[Authority Hacker - Claude Opus 4.8 Review]] — May 29, 2026. What changed: 4.7 regression fixed, more honest, 4x fewer logic errors in code. Full transcript pending.
- [[Claude Blog - Dynamic Workflows in Claude Code]] — June 2, 2026. Claude writes its own JS harness on the fly (`ultracode`). 6 patterns: classify-and-act, fan-out-and-synthesize, adversarial verification, generate-and-filter, tournament, loop-until-done.
- [[Claude Blog - Introducing Dynamic Workflows]] — May 28, 2026. Announcement post: availability, plan tiers, Bun Zig→Rust case study (750K lines, 11 days, 99.8% tests passing).
- [[Claude Blog - Managed Agents Self-Hosted Sandboxes]] — May 19, 2026. Sandbox providers: Cloudflare, Daytona, Modal, Vercel. MCP Tunnels for private-network MCP servers.
- [[Claude Blog - Founders Playbook]] — May 14, 2026. 4 AI-remapped startup stages + Chat/Cowork/Claude Code tool selection matrix. PDF download available.
- [[Claude Blog - Running an AI-Native Engineering Org]] — June 3, 2026. Fiona Fung on JIT planning, killing obsolete processes, metrics, and blurred roles.
- [[Claude Blog - Lessons from Building Claude Code How We Use Skills]] — June 3, 2026. Thariq Shihipar: 9 skill categories, best practices, distribution models, measurement via PreToolUse hooks.
- [[Claude Blog - Claude Cowork Product Guide]] — June 5, 2026. Official product guide: 7 workflow templates, permissions model, plugin usage, 3-tool selection matrix. eBook available.
- [[X AI Signal Sweep - 2026-06-09]] — Seed sweep for the regular X source. Captures Karpathy, Simon Willison, Dan Shipper, Ethan Mollick, and Claude Fable 5 / Mythos field reports.
- [[Claude Blog - Best Practices for Claude Cowork]] — June 3, 2026. Chat vs Cowork vs Claude Code matrix. 5 ingredients of a Cowork task. Context > prompt quality.
- [[Claude Blog - Self-Service Data Analytics with Claude]] — June 3, 2026. 3 failure modes + 4-layer architecture for agentic analytics. 95% query automation at 95% accuracy.
- [[0xchromium - Claude Workflows That Run Without You]] — June 4, 2026. 4-part workflow anatomy (Role/Tools/Trigger/Output), 12 workflow templates by role, 5-step build process, copy-paste morning briefing prompt.
- [[Andrej Karpathy - How I Use LLMs]] — Feb 27, 2025. 2h11m practical guide: zip-file mental model, LLM council approach, model selection matrix, tool integration hierarchy. Full chapter list.
- [[Claude Blog - Claude for Foundation Models]] — June 8, 2026. Swift package for hybrid Apple apps: on-device model + Claude handoff. iOS/macOS 27+, typed Swift inputs, streaming to SwiftUI.
- [[Claude Blog - Connector Observability]] — June 8, 2026. Performance dashboards (active users, tool calls, latency by tool) for published MCP connectors. In-app directory submission. Public beta.
- [[Reddit - Depureco MCP Case Study]] — June 2026. Depureco (Italian industrial vacuum manufacturer) connected product catalog to Claude via Remote MCP. Key insight: grounded AI becomes more humble and asks better questions — directly applicable to qip-qien and any regulated/safety-critical B2B tool.
- [[Mountain Movers - Boris Cherny Loop Definition]] — June 2026. Cherny's 3-stage engineer evolution + definition of a loop as a program that prompts, reads, evaluates, re-prompts. Hard stops, skills vs. plumbing distinction, cost reality (Uber $1,500/mo cap).
- [[Claude Blog - Building With Claude Managed Agents]] — June 10, 2026. Foundational engineering post: decoupled harness/sandbox architecture (p50 ~60% / p95 >90% latency reduction), Dreaming (scheduled memory refinement), Outcomes (agent self-grading), context anxiety history, three-phase evolution, when-to-use guidance.
- [[Claude Blog - Whats New in Claude Managed Agents]] — June 9, 2026. Two new public beta features: scheduled deployments (cron, no infra) and env vars in vaults (credential injection at network boundary). Customer examples: Rakuten, Notion, Browserbase, Milana.
- [[Alpha Batcher - Boris Cherny 5-Day Claude Code Setup]] — June 9, 2026. 5-day progressive setup ladder from Boris Cherny's loop philosophy. Includes embedded "Reflecting on a year of Claude Code" video (18 min) with Cherny & Cat Wu.
- [[Boris Cherny - Self-Verification Loops]] — June 9, 2026. Cherny's own statement: self-verification is the mechanism that enables longer autonomous runs. Cites ClaudeDevs video by Delba de Oliveira (839K views).
- [[DCBitMax - Bitcoin Power Law Out-of-Sample Test]] — June 10, 2026. Out-of-sample validation of Bitcoin Power Law using Claude Opus 4.8. Froze model at 2016 → 10-year mean residual −0.05σ. Same validation methodology applies to congressional-trading.
- [[AdiiX - Claude Trading Bot Architecture]] — June 9, 2026. 7.1M views. Claude Code writes trading logic; Claude Cowork sends 7am/9pm daily briefings. Multi-asset: SPX/NDX mean reversion (15m), crypto momentum (1h), commodities trend (4h). ATR sizing + correlation filter. No repo — marketing post. Architecture applicable to tradingbot25 and congressional-trading.
- [[Claude Blog - Field Guide to Claude Fable]] — July 6, 2026. Thariq Shihipar. 4-quadrant unknowns framework, 8 elicitation techniques (blind spot pass, interview mode, reference prompting, implementation plan, explainer, quiz). Core claim: with Fable, output quality is now bottlenecked by user clarity, not model capability.
- [[Claude Blog - Marketing Ops Cowork Automation]] — July 8, 2026. Anthropic's own marketing ops team. Dispatcher-specialist architecture, audit agent pattern, skill refinement loops. Concrete Cowork workflow patterns applicable to qip-qien and nanoclaw.
- [[Claude Blog - Cognition Claude Fable 5]] — July 10, 2026. Silas Alberti (Cognition SVP of Research). Production validation: 8h overnight autonomous runs, 3× improvement on Frontier Code hardest subset (30% vs 10% prior Opus), honest uncertainty, tool use under noise.
- [[Claude Blog - Working at the Frontier Cursor]] — July 17, 2026. Cursor's evaluation of Fable 5: 72.9% on CursorBench. Global vs local reasoning framing: Fable figures out what B is when you don't know; lighter models for when B is clear. Route by problem ambiguity, not just complexity.
- [[Claude Blog - CISO Guide to Agentic AI]] — July 17, 2026. Jason Clinton (Anthropic Deputy CISO). Four-question agent assessment framework + seven governance requirements. Service account vs human credential agents. Key: shadow adoption is worse than governed adoption; design for model capability in 6 months, not today.
- [[Claude Blog - AI Code Migration]] — July 16, 2026. Large-scale code migration in days using multi-agent loops. Core insight: "You don't fix the code. You fix the process (loop) that produced the code." Six-step process, real proof: Bun 1M-line Zig→Rust (2 weeks), Python→TS 165k lines (weekend).
- [[Claude Blog - Fable 5 in Claude Cowork]] — July 16, 2026. Josefina Albert (Anthropic Education). New Fable 5 Cowork features: adjustable effort settings, transparent planning panel, multi-day context retention. Delegation model: define done, hand off, review outputs.

[[Wiki Ingest Log]]


Ingest Claude blog post on marketing operations automation


I have a good picture of the wiki structure. Let me now read the SCHEMA.md to understand conventions before writing pages.

Actually, I've seen enough examples from the existing wiki pages to understand the format. Let me now:

1. Create the source page: `Claude Blog - Datadog Universal Machine Tool.md`
2. Create a concept page for the "Specification-Based Agentic Development" or "Temper" concept
3. Update Home.md
4. Update Wiki Ingest Log.md

Let me think about what concept page(s) to create:
The key insight here is that agents should emit specifications rather than code—moving compilation and verification outside the LLM so that a verified spec becomes the executed artifact. I'll also capture the Dark Factory Pattern idea about agents working autonomously within a formal verification kernel. I'll create a source page for the Datadog blog post and a concept page on "Specification-First Agentic Development" that ties together the spec-as-artifact approach, verification cascade, and dark factory patterns. Then I need to update the Home.md sources and concepts sections, plus the Ingest Log. I should also consider how the Tailscale link fits in.

Now I'm working out the URL slugs for these pages based on the Tailscale format—converting the filenames to URL-encoded slugs and building the full links.


This is highly relevant — it's Datadog engineering sharing a novel Claude Code architecture pattern. Let me create the wiki pages.


ToolSearch

Question: select:SendMessage


Question: select:SendMessage


Let me now write the source page and concept page for the Datadog Universal Machine Tool post. I'll do this in parallel.


Write

/workspace/extra/second-brain/wiki/sources/Claude Blog - Datadog Universal Machine Tool for Claude Code.md

# Claude Blog — How Datadog Built a "Universal Machine Tool" for Claude Code

**Source:** https://claude.com/blog/how-datadog-built-a-universal-machine-tool-for-claude-code
**Author:** Anthropic (no individual author; features Datadog VP Eng Sesh Nalla)
**Date:** July 21, 2026
**Reading time:** 5 min

## Summary

Datadog engineering uses Claude Code for ~2/3 of their production code output, operating at four scales: targeted fixes, large refactors, component replacements, and full system builds. At the highest scale, agents build faster than humans can verify. Their solution—**Temper**—inverts the problem: agents produce *specifications*, a deterministic kernel verifies and executes them, and the verified artifact IS the running system. No drift between proof and production.

## The Problem: Verification Bottleneck

VP of Engineering Sesh Nalla:

> "You're no longer writing the code; you're shaping the work. You're deciding what the agent should see. What tools it should have, what success means, how failure should be detected… It's like everyone's promoted three levels up into the management chain."

With managed agents running for days, each invents custom tools and conventions. The gap widens between agent execution and human-facing tooling. Throughput isn't the bottleneck — **verification** is.

## Three Predecessor Projects

**Courier (2024):** Distributed queuing system. Bottleneck was making component interactions observable, testable, and verifiable through formal modeling and simulation.

**BitsEvolve (Sep 2025):** Closed-loop evolutionary optimization — a model council generates code variants; benchmarks/tests/production observability determine survival. Key insight: "parts of software could be cultivated like living organisms."

**Helix (2025):** A Kafka-comparable streaming service, built largely by Claude Code in days. Production hardiness required extended operational mileage — exposing the next bottleneck: humans must still coordinate deployment through human-oriented tools.

## Temper: The Core Innovation

Instead of generating application code, **agents produce specifications**. A deterministic kernel:
1. Reads each specification
2. Verifies it through four analytical layers
3. Deploys the running system the specification describes

**Critical property:** "The specification is both the artifact that gets proved and the artifact that gets executed. There is no drift between what was verified and what is running."

### Key Contracts per Capability

1. **Behavior Contract** — states, transitions, preconditions, and safety properties
2. **Data Contract** — entity types, properties, actions in machine-parseable form (agents discover the API without docs)
3. **Authorization** — default-deny, scope-based, human-approvable pending decisions hot-loadable into the policy engine

### Verification Cascade (sub-second for small specs)

1. **Symbolic reasoning** — proves each guard is satisfiable and each invariant is inductive
2. **Exhaustive state exploration** — visits every reachable state
3. **Deterministic simulation** — runs production code paths with seeded fault injection (drops, delays, reordering, crashes)
4. **Randomized property testing** — ~1,000 pseudorandom action sequences; violations shrunk to minimal counterexamples

## Why Not Just Build a CRUD App?

Claude Code builds CRUD apps well. But conventional CRUD scatters control logic across routes, database constraints, service code, background jobs, and documentation. Temper makes the implicit state machine explicit:

> "Temper makes that state machine explicit. The agent produces a precise description, not arbitrary code. The compilation step is outside the LLM, the same way you hand Rust code to the Rust compiler."

Agents can now hot-reload transition tables dynamically with safety, bypassing CI.

## The Dark Factory for Helix

Temper operates as three layers:
- **Agent control plane** — sessions, roles, work queues, lifecycle
- **Tool-builder layer** — bridging SDLC tooling (Git, CI, deployment)
- **Helix control API** — data plane lifecycle and workload exercise

Sesh: "A lot of software, if you squint, is just control logic around database APIs: state, policies around mutation, lifecycle transitions, integrations with external systems. Temper could be universal."

## Machine Tool Analogy

Manufacturing uses jigs, fixtures, and mills to produce precise, repeatable parts that assemble into complex machines. Temper applies this to agentic systems—the smallest kernel agents need to build systems safely and precisely.

High-assurance software (aviation, financial systems) has been built with small, comprehensible artifacts for decades, but human costs were prohibitive. Agents enable this rigor for general software:

> "The industrial revolution became possible because machine tools made parts composable, inspectable, and replaceable, so we could build ever-larger and more complex machines. If agents can build software autonomously inside factories with this kind of discipline, maybe we don't need to stop at dark factories."

## Key Concepts

- [[Specification-First Agentic Development]] — the core paradigm Temper embodies
- [[AI-Native Engineering Org]] — related: verification bottleneck, role shift
- [[Claude Code Dynamic Workflows]] — related: agent autonomy at scale
- [[Builder-Verifier Loop Pattern]] — related: the verification gap problem

## Applicability to James's Projects

- **nanoclaw** — Temper's agent control plane (sessions, roles, work queues) is a more formal version of nanoclaw's container model. The "dark factory" framing maps directly.
- **RoadSense / congressional-trading** — Scoring pipeline stages are already state machines; making them explicit (Temper-style spec → verifiable kernel) would eliminate the class of "score-inheritance regression" bugs where two adjacency definitions silently conflict.
- **qip-qien** — Behavior contracts + authorization model (default-deny, human-approvable policy) maps exactly to the admin route guarding work done 2026-07-19.


File created successfully at: /workspace/extra/second-brain/wiki/sources/Claude Blog - Datadog Universal Machine Tool for Claude Code.md (file state is current in your context — no need to Read it back)

# Claude Blog — How Datadog Built a "Universal Machine Tool" for Claude Code

**Source:** https://claude.com/blog/how-datadog-built-a-universal-machine-tool-for-claude-code
**Author:** Anthropic (no individual author; features Datadog VP Eng Sesh Nalla)
**Date:** July 21, 2026
**Reading time:** 5 min

## Summary

Datadog engineering uses Claude Code for ~2/3 of their production code output, operating at four scales: targeted fixes, large refactors, component replacements, and full system builds. At the highest scale, agents build faster than humans can verify. Their solution—**Temper**—inverts the problem: agents produce *specifications*, a deterministic kernel verifies and executes them, and the verified artifact IS the running system. No drift between proof and production.

## The Problem: Verification Bottleneck

VP of Engineering Sesh Nalla:

> "You're no longer writing the code; you're shaping the work. You're deciding what the agent should see. What tools it should have, what success means, how failure should be detected… It's like everyone's promoted three levels up into the management chain."

With managed agents running for days, each invents custom tools and conventions. The gap widens between agent execution and human-facing tooling. Throughput isn't the bottleneck — **verification** is.

## Three Predecessor Projects

**Courier (2024):** Distributed queuing system. Bottleneck was making component interactions observable, testable, and verifiable through formal modeling and simulation.

**BitsEvolve (Sep 2025):** Closed-loop evolutionary optimization — a model council generates code variants; benchmarks/tests/production observability determine survival. Key insight: "parts of software could be cultivated like living organisms."

**Helix (2025):** A Kafka-comparable streaming service, built largely by Claude Code in days. Production hardiness required extended operational mileage — exposing the next bottleneck: humans must still coordinate deployment through human-oriented tools.

## Temper: The Core Innovation

Instead of generating application code, **agents produce specifications**. A deterministic kernel:
1. Reads each specification
2. Verifies it through four analytical layers
3. Deploys the running system the specification describes

**Critical property:** "The specification is both the artifact that gets proved and the artifact that gets executed. There is no drift between what was verified and what is running."

### Key Contracts per Capability

1. **Behavior Contract** — states, transitions, preconditions, and safety properties
2. **Data Contract** — entity types, properties, actions in machine-parseable form (agents discover the API without docs)
3. **Authorization** — default-deny, scope-based, human-approvable pending decisions hot-loadable into the policy engine

### Verification Cascade (sub-second for small specs)

1. **Symbolic reasoning** — proves each guard is satisfiable and each invariant is inductive
2. **Exhaustive state exploration** — visits every reachable state
3. **Deterministic simulation** — runs production code paths with seeded fault injection (drops, delays, reordering, crashes)
4. **Randomized property testing** — ~1,000 pseudorandom action sequences; violations shrunk to minimal counterexamples

## Why Not Just Build a CRUD App?

Claude Code builds CRUD apps well. But conventional CRUD scatters control logic across routes, database constraints, service code, background jobs, and documentation. Temper makes the implicit state machine explicit:

> "Temper makes that state machine explicit. The agent produces a precise description, not arbitrary code. The compilation step is outside the LLM, the same way you hand Rust code to the Rust compiler."

Agents can now hot-reload transition tables dynamically with safety, bypassing CI.

## The Dark Factory for Helix

Temper operates as three layers:
- **Agent control plane** — sessions, roles, work queues, lifecycle
- **Tool-builder layer** — bridging SDLC tooling (Git, CI, deployment)
- **Helix control API** — data plane lifecycle and workload exercise

Sesh: "A lot of software, if you squint, is just control logic around database APIs: state, policies around mutation, lifecycle transitions, integrations with external systems. Temper could be universal."

## Machine Tool Analogy

Manufacturing uses jigs, fixtures, and mills to produce precise, repeatable parts that assemble into complex machines. Temper applies this to agentic systems—the smallest kernel agents need to build systems safely and precisely.

High-assurance software (aviation, financial systems) has been built with small, comprehensible artifacts for decades, but human costs were prohibitive. Agents enable this rigor for general software:

> "The industrial revolution became possible because machine tools made parts composable, inspectable, and replaceable, so we could build ever-larger and more complex machines. If agents can build software autonomously inside factories with this kind of discipline, maybe we don't need to stop at dark factories."

## Key Concepts

- [[Specification-First Agentic Development]] — the core paradigm Temper embodies
- [[AI-Native Engineering Org]] — related: verification bottleneck, role shift
- [[Claude Code Dynamic Workflows]] — related: agent autonomy at scale
- [[Builder-Verifier Loop Pattern]] — related: the verification gap problem

## Applicability to James's Projects

- **nanoclaw** — Temper's agent control plane (sessions, roles, work queues) is a more formal version of nanoclaw's container model. The "dark factory" framing maps directly.
- **RoadSense / congressional-trading** — Scoring pipeline stages are already state machines; making them explicit (Temper-style spec → verifiable kernel) would eliminate the class of "score-inheritance regression" bugs where two adjacency definitions silently conflict.
- **qip-qien** — Behavior contracts + authorization model (default-deny, human-approvable policy) maps exactly to the admin route guarding work done 2026-07-19.


# Specification-First Agentic Development

**Source:** [[Claude Blog - Datadog Universal Machine Tool for Claude Code]] (2026-07-21)
**Origin:** Datadog's Temper system, built on Claude Managed Agents

## Core Idea

When agents produce code faster than humans can review it, the bottleneck is **verification**, not throughput. The fix: agents emit *specifications*, not code. A deterministic kernel verifies the spec and deploys the running system it describes.

**The key invariant:** Spec = proof artifact = executing artifact. No drift.

> "The compilation step is outside the LLM, the same way you hand Rust code to the Rust compiler."

## Why This Works

Conventional code scatters control logic across routes, DB constraints, service code, background jobs, and docs. A specification makes the implicit state machine explicit and small enough that:
- A human can hold it in their head
- A verifier can exhaustively check it
- An agent can modify it safely and hot-reload it

The constraint is intentional: **if a generated artifact isn't small enough for a human to comprehend, the approach reverts to its starting point**.

## The Verification Cascade (Temper)

Applied sub-second for small specs:

1. **Symbolic reasoning** — every guard satisfiable, every invariant inductive
2. **Exhaustive state exploration** — every reachable state visited
3. **Deterministic simulation** — production code paths with seeded fault injection (drops, delays, reordering, crashes)
4. **Randomized property testing** — ~1,000 pseudorandom action sequences, violations shrunk to minimal counterexamples

## Key Contracts per Capability

- **Behavior contract** — states, transitions, preconditions, safety properties
- **Data contract** — entity types, properties, actions (machine-parseable → agent API discovery without docs)
- **Authorization** — default-deny, scope-based, human-approvable pending decisions hot-loadable into policy engine

## The Dark Factory

When a formal kernel handles verification, agents can work autonomously inside a "dark factory":

- Agent control plane (sessions, roles, work queues, lifecycle)
- Tool-builder layer (Git, CI, deployment)
- Domain control API (lifecycle + workload)

"A lot of software, if you squint, is just control logic around database APIs: state, policies around mutation, lifecycle transitions, integrations with external systems. Temper could be universal." — Sesh Nalla, Datadog VP Eng

## Machine Tool Analogy

The industrial revolution required machine tools (jigs, fixtures, mills) that made parts composable, inspectable, and replaceable. Temper is the machine tool for agentic software: the smallest kernel agents need to build systems safely and precisely.

This enables high-assurance software rigor (aviation, finance) for general software — historically too human-labor-intensive to be practical.

## Evolution Path (Datadog's)

1. **Courier** — formal modeling for distributed system interactions
2. **BitsEvolve** — evolutionary code optimization with production observability as fitness signal
3. **Helix** — first large system built largely by agents; exposed the deployment coordination gap
4. **Temper** — formal spec kernel eliminating the verify-then-deploy gap

## When to Apply

Strong signal that this pattern is worth reaching for:
- Agent throughput exceeds human review capacity
- Bugs cluster at implicit state machine boundaries (two subsystems with different adjacency definitions, as in [[RoadSense score-inheritance regression]])
- Authorization rules are scattered across routes and middleware rather than declared in one place
- You're building control logic around database APIs (state, mutation policies, lifecycle transitions)

## Related Concepts

- [[Builder-Verifier Loop Pattern]] — tactical version: separate builder and verifier agents
- [[AI-Native Engineering Org]] — organizational context: verification bottleneck, role shift
- [[Long-Running Agent Primitives]] — Default-FAIL, Fresh-context evaluator, Handoff — complementary primitives for the agent control plane
- [[Claude Code Dynamic Workflows]] — agent autonomy patterns that feed into a Temper-style kernel


File created successfully at: /workspace/extra/second-brain/wiki/concepts/Specification-First Agentic Development.md (file state is current in your context — no need to Read it back)

# Specification-First Agentic Development

**Source:** [[Claude Blog - Datadog Universal Machine Tool for Claude Code]] (2026-07-21)
**Origin:** Datadog's Temper system, built on Claude Managed Agents

## Core Idea

When agents produce code faster than humans can review it, the bottleneck is **verification**, not throughput. The fix: agents emit *specifications*, not code. A deterministic kernel verifies the spec and deploys the running system it describes.

**The key invariant:** Spec = proof artifact = executing artifact. No drift.

> "The compilation step is outside the LLM, the same way you hand Rust code to the Rust compiler."

## Why This Works

Conventional code scatters control logic across routes, DB constraints, service code, background jobs, and docs. A specification makes the implicit state machine explicit and small enough that:
- A human can hold it in their head
- A verifier can exhaustively check it
- An agent can modify it safely and hot-reload it

The constraint is intentional: **if a generated artifact isn't small enough for a human to comprehend, the approach reverts to its starting point**.

## The Verification Cascade (Temper)

Applied sub-second for small specs:

1. **Symbolic reasoning** — every guard satisfiable, every invariant inductive
2. **Exhaustive state exploration** — every reachable state visited
3. **Deterministic simulation** — production code paths with seeded fault injection (drops, delays, reordering, crashes)
4. **Randomized property testing** — ~1,000 pseudorandom action sequences, violations shrunk to minimal counterexamples

## Key Contracts per Capability

- **Behavior contract** — states, transitions, preconditions, safety properties
- **Data contract** — entity types, properties, actions (machine-parseable → agent API discovery without docs)
- **Authorization** — default-deny, scope-based, human-approvable pending decisions hot-loadable into policy engine

## The Dark Factory

When a formal kernel handles verification, agents can work autonomously inside a "dark factory":

- Agent control plane (sessions, roles, work queues, lifecycle)
- Tool-builder layer (Git, CI, deployment)
- Domain control API (lifecycle + workload)

"A lot of software, if you squint, is just control logic around database APIs: state, policies around mutation, lifecycle transitions, integrations with external systems. Temper could be universal." — Sesh Nalla, Datadog VP Eng

## Machine Tool Analogy

The industrial revolution required machine tools (jigs, fixtures, mills) that made parts composable, inspectable, and replaceable. Temper is the machine tool for agentic software: the smallest kernel agents need to build systems safely and precisely.

This enables high-assurance software rigor (aviation, finance) for general software — historically too human-labor-intensive to be practical.

## Evolution Path (Datadog's)

1. **Courier** — formal modeling for distributed system interactions
2. **BitsEvolve** — evolutionary code optimization with production observability as fitness signal
3. **Helix** — first large system built largely by agents; exposed the deployment coordination gap
4. **Temper** — formal spec kernel eliminating the verify-then-deploy gap

## When to Apply

Strong signal that this pattern is worth reaching for:
- Agent throughput exceeds human review capacity
- Bugs cluster at implicit state machine boundaries (two subsystems with different adjacency definitions, as in [[RoadSense score-inheritance regression]])
- Authorization rules are scattered across routes and middleware rather than declared in one place
- You're building control logic around database APIs (state, mutation policies, lifecycle transitions)

## Related Concepts

- [[Builder-Verifier Loop Pattern]] — tactical version: separate builder and verifier agents
- [[AI-Native Engineering Org]] — organizational context: verification bottleneck, role shift
- [[Long-Running Agent Primitives]] — Default-FAIL, Fresh-context evaluator, Handoff — complementary primitives for the agent control plane
- [[Claude Code Dynamic Workflows]] — agent autonomy patterns that feed into a Temper-style kernel


Now update Home.md and the Ingest Log in parallel.


Edit

- [[Claude Blog - Fable 5 in Claude Cowork]] — July 16, 2026. Josefina Albert (Anthropic Education). New Fable 5 Cowork features: adjustable effort settings, transparent planning panel, multi-day context retention. Delegation model: define done, hand off, review outputs.

- [[Claude Blog - Fable 5 in Claude Cowork]] — July 16, 2026. Josefina Albert (Anthropic Education). New Fable 5 Cowork features: adjustable effort settings, transparent planning panel, multi-day context retention. Delegation model: define done, hand off, review outputs.
- [[Claude Blog - Datadog Universal Machine Tool for Claude Code]] — July 21, 2026. How Datadog built Temper: agents emit specifications, a deterministic kernel verifies + executes them. Spec = proof artifact = running artifact. Verification cascade (symbolic → exhaustive state → simulation → property testing). "Dark factory" for autonomous agentic systems.


The file /workspace/extra/second-brain/wiki/Home.md has been updated successfully. (file state is current in your context — no need to Read it back)

- [[Claude Blog - Fable 5 in Claude Cowork]] — July 16, 2026. Josefina Albert (Anthropic Education). New Fable 5 Cowork features: adjustable effort settings, transparent planning panel, multi-day context retention. Delegation model: define done, hand off, review outputs.
- [[Claude Blog - Datadog Universal Machine Tool for Claude Code]] — July 21, 2026. How Datadog built Temper: agents emit specifications, a deterministic kernel verifies + executes them. Spec = proof artifact = running artifact. Verification cascade (symbolic → exhaustive state → simulation → property testing). "Dark factory" for autonomous agentic systems.

- [[Claude Blog - CISO Guide to Agentic AI]] — July 17, 2026. Jason Clinton (Anthropic Deputy CISO). Four-question agent assessment framework + seven governance requirements. Service account vs human credential agents. Key: shadow adoption is worse than governed adoption; design for model capability in 6 months, not today.

- [[Claude Blog - AI Code Migration]] — July 16, 2026. Large-scale code migration in days using multi-agent loops. Core insight: "You don't fix the code. You fix the process (loop) that produced the code." Six-step process, real proof: Bun 1M-line Zig→Rust (2 weeks), Python→TS 165k lines (weekend).

+- [[Claude Blog - Datadog Universal Machine Tool for Claude Code]] — July 21, 2026. How Datadog built Temper: agents emit specifications, a deterministic kernel verifies + executes them. Spec = proof artifact = running artifact. Verification cascade (symbolic → exhaustive state → simulation → property testing). "Dark factory" for autonomous agentic systems.


- [[Converge on One Canonical Engine]] — Two agents each defaulting to their own implementation path for the same capability diverges silently until outputs are compared. Root cause is usually an asymmetric instruction file (e.g. `AGENTS.md` with no mirrored `CLAUDE.md`); fix with a guardrail test on file symmetry, not just better docs.

- [[Converge on One Canonical Engine]] — Two agents each defaulting to their own implementation path for the same capability diverges silently until outputs are compared. Root cause is usually an asymmetric instruction file (e.g. `AGENTS.md` with no mirrored `CLAUDE.md`); fix with a guardrail test on file symmetry, not just better docs.
- [[Specification-First Agentic Development]] — Agents emit specs, not code; a deterministic kernel verifies + executes. No drift between proof and production. Verification cascade: symbolic reasoning → exhaustive state exploration → deterministic simulation → property testing. Applies when agent throughput exceeds human review capacity.


- [[Converge on One Canonical Engine]] — Two agents each defaulting to their own implementation path for the same capability diverges silently until outputs are compared. Root cause is usually an asymmetric instruction file (e.g. `AGENTS.md` with no mirrored `CLAUDE.md`); fix with a guardrail test on file symmetry, not just better docs.
- [[Specification-First Agentic Development]] — Agents emit specs, not code; a deterministic kernel verifies + executes. No drift between proof and production. Verification cascade: symbolic reasoning → exhaustive state exploration → deterministic simulation → property testing. Applies when agent throughput exceeds human review capacity.

- [[A Reported Click Does Nothing Bug Can Be An Off-Screen Render]] — "clicked and nothing happened" can mean the state update is correct but the result rendered off-screen (e.g. a mobile reflow) — verify state changed and re-test at the actual breakpoint before concluding the handler is broken.

- [[Symlink Hijack in Skill Updaters]] — Any auto-updating CLI with write access to shared agent config can relink every agent's skill dir under `$HOME`, indistinguishable from a supply-chain attack. Decouple detection (sandboxed `HOME`+`PATH`, not just the tool's own scoping flag) from adoption.

+- [[Specification-First Agentic Development]] — Agents emit specs, not code; a deterministic kernel verifies + executes. No drift between proof and production. Verification cascade: symbolic reasoning → exhaustive state exploration → deterministic simulation → property testing. Applies when agent throughput exceeds human review capacity.

*Paid placements — not guest endorsements. Pages exist for reference.*


## 2026-07-21 (Anthropic GitHub sweep #36)

## 2026-07-21 (Claude blog check)

- **[[Claude Blog - Datadog Universal Machine Tool for Claude Code]]** (new source page) — Datadog VP Eng Sesh Nalla + Claude Code. Core innovation: **Temper**, a deterministic spec kernel. Instead of generating code, agents produce specifications; the kernel verifies them through a 4-layer cascade (symbolic reasoning → exhaustive state exploration → deterministic simulation → property testing) and deploys the running system the spec describes. Spec = proof artifact = executing artifact — no drift. Three predecessor projects (Courier, BitsEvolve, Helix) converged on the verification bottleneck as the core problem. "Dark factory" framing: agents work autonomously inside Temper's formal kernel. "A lot of software is just control logic around database APIs — Temper could be universal." High-assurance software rigor (aviation, finance) now feasible for general software via agents. GitHub: `nerdsane/temper`. New concept: [[Specification-First Agentic Development]].

## 2026-07-21 (Anthropic GitHub sweep #36)


The file /workspace/extra/second-brain/wiki/Wiki Ingest Log.md has been updated successfully. (file state is current in your context — no need to Read it back)

## 2026-07-21 (Claude blog check)

- **[[Claude Blog - Datadog Universal Machine Tool for Claude Code]]** (new source page) — Datadog VP Eng Sesh Nalla + Claude Code. Core innovation: **Temper**, a deterministic spec kernel. Instead of generating code, agents produce specifications; the kernel verifies them through a 4-layer cascade (symbolic reasoning → exhaustive state exploration → deterministic simulation → property testing) and deploys the running system the spec describes. Spec = proof artifact = executing artifact — no drift. Three predecessor projects (Courier, BitsEvolve, Helix) converged on the verification bottleneck as the core problem. "Dark factory" framing: agents work autonomously inside Temper's formal kernel. "A lot of software is just control logic around database APIs — Temper could be universal." High-assurance software rigor (aviation, finance) now feasible for general software via agents. GitHub: `nerdsane/temper`. New concept: [[Specification-First Agentic Development]].

## 2026-07-21 (Anthropic GitHub sweep #36)

+- **[[Claude Blog - Datadog Universal Machine Tool for Claude Code]]** (new source page) — Datadog VP Eng Sesh Nalla + Claude Code. Core innovation: **Temper**, a deterministic spec kernel. Instead of generating code, agents produce specifications; the kernel verifies them through a 4-layer cascade (symbolic reasoning → exhaustive state exploration → deterministic simulation → property testing) and deploys the running system the spec describes. Spec = proof artifact = executing artifact — no drift. Three predecessor projects (Courier, BitsEvolve, Helix) converged on the verification bottleneck as the core problem. "Dark factory" framing: agents work autonomously inside Temper's formal kernel. "A lot of software is just control logic around database APIs — Temper could be universal." High-assurance software rigor (aviation, finance) now feasible for general software via agents. GitHub: `nerdsane/temper`. New concept: [[Specification-First Agentic Development]].

- All 30 updated repos already documented or skipped per prior sweeps. Three new repos not yet documented but not relevant to James's stack: `anthropic-sdk-php` (PHP API SDK), `anthropic-sdk-csharp` (C# API SDK), `PySvelte` (Python/JS visualization library — unmaintained research tool). No new skill commits.


Now run publish to verify the pages are live:


Bash

cd /workspace/extra/second-brain && node scripts/publish-wiki-note.mjs "wiki/sources/Claude Blog - Datadog Universal Machine Tool for Claude Code.md" 2>&1 | tail -5

Publish source page to wiki


(node:54833) [UNDICI-EHPA] Warning: EnvHttpProxyAgent is experimental, expect them to change at any time.
(Use `node --trace-warnings ...` to show where the warning was created)
ERROR: Unexpected argument: wiki/sources/Claude Blog - Datadog Universal Machine Tool for Claude Code.md


node scripts/publish-wiki-note.mjs --help 2>&1 | head -20

Check publish script usage


(node:54844) [UNDICI-EHPA] Warning: EnvHttpProxyAgent is experimental, expect them to change at any time.
(Use `node --trace-warnings ...` to show where the warning was created)
ERROR: Could not discover the active Tailscale host. Pass --base-url or set SECOND_BRAIN_URL.


node scripts/build-wiki-manifest.mjs 2>&1 | tail -5

Rebuild wiki manifest to register new pages


(node:54856) [UNDICI-EHPA] Warning: EnvHttpProxyAgent is experimental, expect them to change at any time.
(Use `node --trace-warnings ...` to show where the warning was created)
Wrote wiki-manifest.js with 207 pages