https://blog.margrop.net/en/tag/context-engineering/ Recent content in Context Engineering on Margrop Blog Hugo -- gohugo.io en-US Sat, 23 May 2026 14:50:00 +0800 https://blog.margrop.net/en/post/12-factor-agents-agent-principles/ Sat, 23 May 2026 14:50:00 +0800 https://blog.margrop.net/en/post/12-factor-agents-agent-principles/ <blockquote> <p><strong>The short version</strong></p> <p><code>12-Factor Agents</code> is not an installable agent framework, and it is not a Skill for Codex, Claude, Cursor, or any other agent runtime. It is better understood as a set of engineering principles for the AI era. When a system made from a large model, a tool list, and a while loop reaches the familiar 70% or 80% quality bar but refuses to become production-grade, these principles tell you where to look: prompts, context, structured outputs, state, human approval, error compaction, control flow, and recovery.</p> <p>The best part is that it does not romanticize agents. It says, in effect, that reliable agents are mostly software. The LLM is powerful, but it should live inside a system that is observable, interruptible, recoverable, auditable, and testable.</p> </blockquote> <p>All examples in this article use public projects, public links, and placeholders. No real server addresses, accounts, tokens, business configuration, or private network details are included. The figures are taken from the official <code>humanlayer/12-factor-agents</code> repository and are referenced under the project author&rsquo;s CC BY-SA 4.0 content license statement. Code license details should be checked in the upstream repository.</p>