12-factor-agents
CLAUDE.md27k starsChanged 16 months agoLicence not identifiedView on GitHub
IMPORTANT: Copy or merge this file into your project's CLAUDE.md file to activate agent personas. CRITICAL: You MUST adopt one of the specialized personas before proceeding with any work. BEFORE…
We split this CLAUDE.md into the rules it gives an agent
10 rules. About 0 are common, 5 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
The licence could not be identified — read it at the source. We count its rules but don't quote them. Read them on GitHub.
≈ “Common” is an estimate: at least 1 in 5 of the 25,680 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Trending
Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data
Who's talking about humanlayer/12-factor-agents
- AI Engineer“Why Software Factories Fail”YouTube · Jul 23, 2026 · 560k views
- AI Engineer“12-Factor Agents: Patterns of reliable LLM applications — Dex Horthy, HumanLayer”YouTube · Jul 3, 2025 · 294k views
- AI Tinkerers“How to Ship Complex Features 10x Faster with AI Agents | Dex Horthy (HumanLayer)”YouTube · Mar 2, 2026 · 26k views
- 最佳拍档“【人工智能】12 Factor Agents | 构建生产环境Agent的十二个原则 | HumanLayer | Dexter Horthy | 反框架理念 | 控制核心组件”YouTube · Sep 8, 2025 · 20k views
- Tool Use“Why AI Agents Keep Failing at Simple Tasks (ft Dexter Horthy) - Ep 34”YouTube · Apr 8, 2025 · 6.3k views
The biggest 5 of 100 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 100
Talked about on GitHub, YouTube, Bluesky, Hacker News and the web (100 times).
On GitHub · 50
- Jun 28, 2025Ideas & Plans for this Project — symfony/ai24 reactions · 6 comments
- Jul 3, 2025[Suggestion] Documenting how to implement 12 Factor Agents — pydantic/pydantic-ai3 reactions · 1 comment
- Oct 26, 2026Weekly verification 2026-W44 — 167 ok / 0 quarantined / 0 recovered / 3 dead / 5 migrated — jdg2896/agentic-engineering0 reactions
- Oct 21, 2026🕰️ შენიშვნა: humanlayer/12-factor-agents აღარ ახლდება — tornikebolokadze1-cyber/awesome-ai-pulse-georgia0 reactions
- Oct 20, 2026Add Glim to text editing tools — smashism/awesome-macadmin-tools0 reactions
45 more on GitHub
- Oct 19, 2026Weekly verification 2026-W43 — 172 ok / 0 quarantined / 0 recovered / 3 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Oct 12, 2026Weekly verification 2026-W42 — 170 ok / 0 quarantined / 1 recovered / 3 dead / 2 migrated — jdg2896/agentic-engineering0 reactions
- Oct 7, 2026docs(readme): add fork header block above upstream essay — wolven-tech/12-factor-agents0 reactions
- Sep 28, 2026Weekly verification 2026-W40 — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Sep 21, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Sep 17, 2026aiready.sh redirects browsers to orbi.build: render the ai-ready 12-factor page there (EN + ZH, badge.svg), keep the curl install path — orbi-build/orbi-website0 reactions · 7 comments
- Sep 14, 2026Weekly verification — 142 ok / 0 quarantined / 0 recovered / 6 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Sep 14, 2026Maintained-bar check: entries to review — jimy-r/awesome-agent-workspaces0 reactions
- Sep 13, 2026ci: SHA-pin third-party actions and split the 90-day flag from the 365-day breach — jimy-r/awesome-agent-workspaces0 reactions
- Sep 11, 2026Draft: How AI Agents Fail in Production: Real-World Reliability, Observability, and Recovery Patterns — PriyeshDave/BlogMind0 reactions
- Sep 7, 2026Weekly verification — 142 ok / 0 quarantined / 0 recovered / 6 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Aug 31, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Aug 31, 2026Maintained-bar check: entries to review — jimy-r/awesome-agent-workspaces0 reactions · 2 comments
- Aug 24, 2026Weekly verification — 142 ok / 0 quarantined / 0 recovered / 6 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Aug 17, 2026Weekly verification — 141 ok / 0 quarantined / 0 recovered / 6 dead / 1 migrated — jdg2896/agentic-engineering0 reactions
- Aug 10, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Aug 3, 2026Weekly verification — 142 ok / 0 quarantined / 0 recovered / 5 dead / 1 migrated — jdg2896/agentic-engineering0 reactions
- Aug 3, 2026Add 12-Factor Agents as a faithful reproduction, and teach the generator to say so — angheladrianclaudiu/AI-Library0 reactions
- Jul 30, 2026feat: Rhai context assembly hook for custom context window shaping — GEMISIS/leviath0 reactions
- Jul 27, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Jul 23, 2026Design: assumption-ledger autonomous multi-spec runs — embrace speckit upstream, jj retroactive reconcile, Claude Code review frontend — get2knowio/maverick0 reactions · 1 comment
- Jul 20, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Jul 18, 2026Fork v2: worker lifecycle — verdict loop, checks, worktrees, ledger — resolveworks/fork0 reactions
- Jul 18, 2026Verdict loop: persistent children with `message_agent` / `close_agent` — resolveworks/fork0 reactions · 2 comments
- Jul 13, 2026Weekly verification — 142 ok / 0 quarantined / 0 recovered / 6 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Jul 6, 2026Weekly verification — 141 ok / 0 quarantined / 0 recovered / 6 dead / 1 migrated — jdg2896/agentic-engineering0 reactions
- Jul 5, 2026Review 12-factor Agents, Determine Skills or Changes to Adopt Internally — j0sh3rs/ai-skills0 reactions
- Jun 29, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Jun 22, 2026Weekly verification — 137 ok / 0 quarantined / 0 recovered / 7 dead / 4 migrated — jdg2896/agentic-engineering0 reactions
- Jun 15, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Jun 8, 2026Weekly verification — 143 ok / 0 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- Jun 7, 2026Add 12-factor-agents knowledge base + runnable reference agent — joe8080/Joemoyo-0 reactions · 1 comment
- Jun 2, 2026💎 Knowledge Update & Optimization: 02 Jun 2026 — nubenetes/awesome-kubernetes0 reactions · 3 comments
- Jun 1, 2026Weekly verification — 142 ok / 0 quarantined / 0 recovered / 5 dead / 1 migrated — jdg2896/agentic-engineering0 reactions
- May 25, 2026Weekly verification — 142 ok / 5 quarantined / 0 recovered / 5 dead / 0 migrated — jdg2896/agentic-engineering0 reactions
- May 20, 2026Add subagent context contract to work shaping — OktayCopurlu/ai-shared0 reactions
- May 19, 202612-Factor Agents ビジュアル解説ページの追加 — 53able/docs-site0 reactions
- May 19, 202612-Factor #9: Improve error compaction in SDM scorer for inline use — GuillaumeBld/Financial-Literacy-Toolkit0 reactions
- May 19, 202612-Factor #6: Add checkpoint/resume to SDM scoring pipeline — GuillaumeBld/Financial-Literacy-Toolkit0 reactions · 1 comment
- May 19, 202612-Factor #12: Refactor SDM scorer into stateless reducer — GuillaumeBld/Financial-Literacy-Toolkit0 reactions · 1 comment
- May 18, 2026Weekly verification — 115 ok / 0 quarantined / 0 recovered / 5 dead / 27 migrated — jdg2896/agentic-engineering0 reactions
- May 17, 2026docs(harness-principles): add 3 principles from 12-Factor Agents — errors, HITL, pre-dispatch pause — markhazlett/agent-harness0 reactions
- May 16, 2026docs(harness-principles): add 3 principles from HumanLayer 12-factor-agents — markhazlett/agent-harness0 reactions
- May 15, 2026docs(harness-principles): add 2 principles from 12-Factor Agents — markhazlett/agent-harness0 reactions
- May 11, 2026Weekly verification — 114 ok / 0 quarantined / 0 recovered / 5 dead / 27 migrated — jdg2896/agentic-engineering0 reactions
On YouTube · 22
- Jul 23, 2026Why Software Factories Fail — AI Engineer560k views · 308 comments
- Jul 3, 202512-Factor Agents: Patterns of reliable LLM applications — Dex Horthy, HumanLayer — AI Engineer294k views · 181 comments
- Mar 2, 2026How to Ship Complex Features 10x Faster with AI Agents | Dex Horthy (HumanLayer) — AI Tinkererssays it tested it26k views · 34 comments
- Sep 8, 2025【人工智能】12 Factor Agents | 构建生产环境Agent的十二个原则 | HumanLayer | Dexter Horthy | 反框架理念 | 控制核心组件 — 最佳拍档20k views · 43 comments
- Apr 8, 2025Why AI Agents Keep Failing at Simple Tasks (ft Dexter Horthy) - Ep 34 — Tool Use - AI Conversations6.3k views · 6 comments
17 more on YouTube
- Jun 3, 2026humanlayer/12-factor-agents — Twelve principles for production agents. 🟢 Clone #Shorts — ForkCast1.2k views
- May 9, 2025Production-Ready AI: Implementing Factor 1 of 12 Factor Agents — App Vitals568 views · 2 comments
- Jul 16, 202512 Factor Agents — AI + Cloud Stack491 views · 3 comments
- May 24, 2025Why 12-factor agents? - Design Patterns for great LLM applications — BazAI490 views
- May 20, 2026생산용 LLM 앱을 위한 12-Factor Agents — Repocast | GitHub 일일 브리핑357 views · 1 comment
- May 23, 2026How to Build Production-Ready AI Agents (12 Factor Agents) — Build Things With AI288 views
- Jun 26, 2026The Secret to Composable AI Agents (It’s Just Software Engineering) — I'll host it myself249 views · 4 comments
- Jul 8, 2026You Can't Trust Your AI Agent Until You Know This — Out Of Distribution214 views · 6 comments
- Apr 16, 2025GitHub - humanlayer/12-factor-agents: What are the principles we can use to build LLM-powered sof... — GitHub Daily Trend AI Podcast128 views
- May 24, 2025Building Production-Ready LLM Agents Using the 12-Factor Agent Framework — BazAI115 views
- Aug 13, 2025Reaction To 12 Factor Agents by Humanlayer (Principles for building reliable LLM applications) — zitterbewegung100 views
- Jun 5, 2026(Podcast) Engineering Reliable AI Agents with the 12 Factor Methodology — Eddy Says Hi #EddySaysHi60 views
- Jul 8, 2025humanlayer/12-factor-agents - Gource visualisation — Gourcer32 views
- Oct 30, 2025Context Engineering for AI Agents — BigTechDeepDive20 views · 1 comment
- Jun 5, 2026Mastering 12 Factor Agents for Production Ready AI Applications — Eddy Says Hi #EddySaysHi16 views
- Jul 12, 2025Building Production-Ready LLM Apps: The 12-Factor Agents Principles — Hugo V15 views
- Oct 18, 2025Context Engineering (A Practical Approach) — Blessed Josiah13 views
On Bluesky · 20
- Apr 19, 2025In the spirit of 12 Factor Apps, voici 12 Factor Agents : Principles for building reliable LLM applications github.com/humanlaye... — @pierrearlais.bsky.social9 likes and reposts
- Apr 11, 2025This very closely mirrors my experie ce of the last several weeks of prototyping. It’s very easy to get something that’s 80% good. Carrying… — @adamhjk.mesays it tested it7 likes and reposts · 2 replies
- Jul 20, 2026📦 humanlayer / 12-factor-agents ⭐ 24,540 (+73) 🗒 TypeScript What are the principles we can use to build LLM-powered software that is… — @github-trending-js.bsky.social2 likes and reposts
- May 19, 2026🚀 Skyrocketing! 🚀 (200+ new stars) 📦 humanlayer / 12-factor-agents ⭐ 20,228 (+359) 🗒 TypeScript What are the principles we can use to… — @github-trending-js.bsky.social2 likes and reposts · 1 reply
- May 19, 2026🚀 Skyrocketing! 🚀 (200+ new stars) 📦 humanlayer / 12-factor-agents ⭐ 20,228 (+359) 🗒 TypeScript What are the principles we can use to… — @github-trending.bsky.social2 likes and reposts · 1 reply
15 more on Bluesky
- Jul 18, 2025🔥 Hot Repo! 🔥 (100+ new stars) 📦 humanlayer / 12-factor-agents ⭐ 9,415 (+184) 🗒 TypeScript What are the principles we can use to build… — @github-trending-js.bsky.social2 likes and reposts
- Apr 17, 2025GitHub - humanlayer/12-factor-agents: What are the principles we can use to build LLM-powered software that is actually good enough to put… — @tech-trending.bsky.social2 likes and reposts
- Sep 29, 2026🚀 GitHub Intelligence Drop onlook (TypeScript • 🟢) ⭐ 26.8K → https://github.com/onlook-dev/onlook 12-factor-agents (TypeScript • 🟡) ⭐… — @githubfeed.bsky.social1 likes and repost
- Jul 28, 2026📦 humanlayer / 12-factor-agents ⭐ 24,891 (+54) 🗒 TypeScript What are the principles we can use to build LLM-powered software that is… — @github-trending-js.bsky.social1 likes and repost
- Jul 21, 2026humanlayer/12-factor-agents: What are the principles we can use to build LLM-powered software that is actually good enough to put in the… — @chrisshort.net1 likes and repost
- Jun 28, 2026📦 humanlayer / 12-factor-agents ⭐ 23,632 (+34) 🗒 TypeScript What are the principles we can use to build LLM-powered software that is… — @github-trending-js.bsky.social1 likes and repost
- Sep 9, 2025🔥 Hot Repo! 🔥 (100+ new stars) 📦 humanlayer / 12-factor-agents ⭐ 14,045 (+172) 🗒 TypeScript What are the principles we can use to build… — @github-trending-js.bsky.social1 likes and repost
- Aug 26, 2025📦 humanlayer / 12-factor-agents ⭐ 13,041 (+49) 🗒 TypeScript What are the principles we can use to build LLM-powered software that is… — @github-trending-js.bsky.social1 likes and repost
- Jul 8, 2025🎉 Celebrating! 🎉 (500+ new stars) 📦 humanlayer / 12-factor-agents ⭐ 7,065 (+705) 🗒 TypeScript What are the principles we can use to… — @github-trending-js.bsky.social1 likes and repost · 1 reply
- Jul 8, 2025今日のGitHubトレンド humanlayer/12-factor-agents このリポジトリは、本番環境で顧客に提供できる品質のLLM搭載ソフトウェア、特にAIエージェントを構築するための原則を探求し、定義することを目的としています。… — @dailygithubtrends.bsky.social1 likes and repost
- Apr 17, 202512因子エージェント信頼性の高いLLMアプリケーションのパターン 12-factor Agents: Patterns of reliable LLM applications 🔺 362 💬 22 🔗 HN Post | Article — @hacker-news-jp.bsky.social1 likes and repost · 1 reply
- Apr 17, 2025"I've been surprised to find that most of the products out there billing themselves as "AI Agents" are not all that agentic. A lot of them… — @juliendorra.com1 likes and repost
- Apr 16, 202512-factor Agents: Patterns of reliable LLM applications #HackerNews https://github.com/humanlayer/12-factor-agents — @hackernewstop5.bsky.social1 likes and repost
- Apr 16, 202512-factor Agents: Patterns of reliable LLM applications https://github.com/humanlayer/12-factor-agents… — @betterhn50.e-work.xyz1 likes and repost
- Jun 29, 20265. Object-Centric Residual RL Transfers Sim-Trained Policies to Real VLAs Zero-Shot LINK 6. 12-Factor Agents: Production Principles for… — @hackobar.bsky.social0 likes and reposts · 1 reply
On Hacker News · 5
- Apr 15, 202512-factor Agents: Patterns of reliable LLM applications475 points · 78 comments
- Aug 16, 202612-Factor Agents – Principles for building reliable LLM applications3 points
- Sep 18, 202612-Factor Agents – Principles for building reliable LLM applications2 points
- Jul 18, 202612 Factor Agents1 point
- Apr 11, 202512-factor-agents: principles to build LLM software good enough for production1 point
On the web · 3
- Sep 4, 2026HumanLayer - All Resources — google.com
- Dec 5, 202512 Factor Agents: Principles for AI That Actually Work — paddo.dev
- Aug 3, 2025GitHub - humanlayer/12-factor-agents: What are the principles ... — liens.opytex.org
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

