content(blog): what makes a business app AI-writable — post 3 of the positioning wave (slot 2026-10-22)

content/blog/give-your-agent-rules-for-governable-apps/index.de.mdx

@@ -3,7 +3,7 @@ title: "Agent-Regeldateien schreiben: KI soll governbare Apps generieren"
 description: "AGENTS.md, .cursor/rules und CLAUDE.md sollten nicht nur Code-Stil regeln. Beschreiben Sie Rechte, Freigaben, Audit und das Ziel-Metadatenformat, damit KI-Apps prüfbar entstehen."
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ Die Antwort ist genau jenes Schwungrad, das [der Artikel zur offenen semantische
 
 1. **Lernbar**: offen + öffentlich + diskutiert → in die Trainingsdaten → das Modell kann es ohnehin schreiben;
 2. **Beschränkbar**: Eine Regeldatei verankert den Output des Agents an diesem deklarativen Ziel;
-3. **Zur Generierungszeit validierbar**: Die Runtime validiert die generierten Metadaten – eine ungültige Definition wird direkt abgewiesen, und der Agent **bekommt das Korrektursignal auf der Stelle**. Das ist der entscheidende Unterschied, den freier Code nicht bietet: Ein Stück falsches SQL läuft womöglich trotzdem und geht erst live hoch, während falsche Metadaten gar nicht erst durch die Tür kommen und auf der Stelle zur Neufassung zurückgewiesen werden.
+3. **Zur Generierungszeit validierbar**: Die Runtime validiert die generierten Metadaten – eine ungültige Definition wird direkt abgewiesen, und der Agent **bekommt das Korrektursignal auf der Stelle**. Das ist der entscheidende Unterschied, den freier Code nicht bietet: Ein Stück falsches SQL läuft womöglich trotzdem und geht erst live hoch, während falsche Metadaten gar nicht erst durch die Tür kommen und auf der Stelle zur Neufassung zurückgewiesen werden. Dieses Gate ist eines von vier – Typed, Validated, Reviewed, Governed – und [What Makes a Business App AI-Writable?](/en/blog/what-makes-a-business-app-ai-writable/) (auf Englisch) zeigt in einem echten Lauf, wie es drei absichtliche Fehler zurückweist, mit der Meldung zu jedem.
 
 Genau Punkt 3 macht aus „den Agent es richtig schreiben lassen" – statt auf Glück angewiesen – einen rückgekoppelten Konvergenzprozess: Der Agent schreibt falsch, wird abgewiesen, korrigiert – unmittelbar, wie bei einem Compilerfehler. Du kannst sogar noch einen Schritt weiter gehen und die governten Werkzeuge der Runtime über **MCP** nach außen freigeben, sodass der Agent zur Generierungszeit die autoritative Definition abruft und zur Laufzeit innerhalb der Grenzen damit operiert – Schreiben und Nutzen, dieselbe Governance. (Die Sache mit der governten Werkzeugschicht behandelt [der MCP-Artikel](/de/blog/mcp-governed-tool-layer/) gesondert.)
 

content/blog/give-your-agent-rules-for-governable-apps/index.es.mdx

@@ -3,7 +3,7 @@ title: "Cómo escribir reglas de agent para que la IA genere apps gobernables"
 description: "AGENTS.md, .cursor/rules y CLAUDE.md no deberían cubrir solo estilo de código. Describe permisos, aprobaciones, auditoría y el formato de metadatos objetivo para que las apps generadas sean revisables."
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ La respuesta es justo ese volante que ya argumentó [el artículo sobre la capa
 
 1. **Se puede aprender**: abierto + público + comentado → entra en el corpus de entrenamiento → el modelo ya sabe escribirlo;
 2. **Se puede restringir**: un archivo de reglas ancla el resultado del agent a este objetivo declarativo;
-3. **Se puede validar en el momento de la generación**: el runtime valida los metadatos generados; una definición ilegal se rechaza de inmediato y el agent **recibe la señal de corrección en el acto**. Esta es la diferencia clave que el código de formato libre no puede dar: un trozo de SQL erróneo puede correr igualmente y solo estallar en producción, mientras que unos metadatos erróneos no pasan de la puerta y se devuelven al instante para reescribir.
+3. **Se puede validar en el momento de la generación**: el runtime valida los metadatos generados; una definición ilegal se rechaza de inmediato y el agent **recibe la señal de corrección en el acto**. Esta es la diferencia clave que el código de formato libre no puede dar: un trozo de SQL erróneo puede correr igualmente y solo estallar en producción, mientras que unos metadatos erróneos no pasan de la puerta y se devuelven al instante para reescribir. Esa puerta es una de cuatro: Typed, Validated, Reviewed, Governed; [What Makes a Business App AI-Writable?](/en/blog/what-makes-a-business-app-ai-writable/) (en inglés) la muestra rechazando tres errores deliberados en una ejecución real, con el mensaje que recibe cada uno.
 
 Es precisamente el punto 3 lo que convierte «conseguir que el agent escriba bien» de un asunto de suerte en un proceso de convergencia con realimentación: el agent escribe mal, es rechazado, corrige, igual de inmediato que un error de compilación. Y, yendo más allá, también puedes exponer las herramientas gobernadas del runtime mediante **MCP**, de modo que el agent obtenga las definiciones autoritativas en el momento de generar y, en tiempo de ejecución, pueda operarlas dentro de los límites: escribir y usar, una misma gobernanza. (Lo de la capa de herramientas gobernada lo cuenta aparte [el artículo sobre MCP](/es/blog/mcp-governed-tool-layer/).)
 

content/blog/give-your-agent-rules-for-governable-apps/index.fr.mdx

@@ -3,7 +3,7 @@ title: "Comment écrire des règles d'agent pour que l'IA génère des apps gouv
 description: "AGENTS.md, .cursor/rules et CLAUDE.md ne devraient pas couvrir seulement le style de code. Décrivez permissions, approbations, audit et format cible pour obtenir des apps générées qui restent vérifiables."
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ La réponse, c'est précisément ce volant d'inertie démontré dans [l'article
 
 1. **Apprenable** : ouvert + public + discuté → entre dans les corpus d'entraînement → le modèle sait déjà l'écrire ;
 2. **Contraignable** : un fichier de règles ancre le résultat de l'agent sur cette cible déclarative ;
-3. **Validable à la génération** : le runtime valide les métadonnées générées — une définition invalide est rejetée d'emblée, et l'agent **reçoit un signal de correction sur-le-champ**. C'est la différence clé que ne peut pas offrir du code en format libre : un bout de SQL erroné peut très bien tourner et n'exploser qu'en production, tandis qu'un fichier de métadonnées erroné ne passe pas la porte et est renvoyé pour réécriture immédiate.
+3. **Validable à la génération** : le runtime valide les métadonnées générées — une définition invalide est rejetée d'emblée, et l'agent **reçoit un signal de correction sur-le-champ**. C'est la différence clé que ne peut pas offrir du code en format libre : un bout de SQL erroné peut très bien tourner et n'exploser qu'en production, tandis qu'un fichier de métadonnées erroné ne passe pas la porte et est renvoyé pour réécriture immédiate. Cette porte est l'une des quatre — Typed, Validated, Reviewed, Governed — et [What Makes a Business App AI-Writable?](/en/blog/what-makes-a-business-app-ai-writable/) (en anglais) la montre, lors d'une exécution réelle, rejeter trois erreurs délibérées avec le message que chacune reçoit.
 
 C'est justement ce point 3 qui transforme « faire écrire l'agent correctement » d'un coup de chance en un processus de convergence avec rétroaction — l'agent se trompe, est rejeté, corrige, aussi instantanément qu'une erreur de compilation. Mieux encore, vous pouvez exposer les outils gouvernés du runtime via **MCP**, pour que l'agent récupère les définitions faisant autorité au moment de la génération, et puisse ensuite les exploiter dans les limites fixées au moment de l'exécution — écrire et utiliser, une seule et même gouvernance. (Cette couche d'outils gouvernée, [l'article sur MCP](/fr/blog/mcp-governed-tool-layer/) en parle séparément.)
 

content/blog/give-your-agent-rules-for-governable-apps/index.ja.mdx

@@ -3,7 +3,7 @@ title: "Agent ルールファイルの書き方：AI にガバナンス可能な
 description: "AGENTS.md、.cursor/rules、CLAUDE.md はコードスタイルだけを管理すべきではない。権限、承認、監査、対象メタデータ形式を書けば、AI 生成アプリはレビューしやすくなる。"
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ AIでコードを書くチームなら、いまやほぼどこでもエージェ
 
 1. **学習されうる**：オープン + 公開 + 議論されている → モデルや検索システムに学ばれやすい。
 2. **制約されうる**：一つのルールファイルが、エージェントの産物をこの宣言的な目標へ錨（いかり）で固定する。
-3. **生成時に検証されうる**：ランタイムが生成されたメタデータを検証する——不正な定義はその場で拒否され、エージェントは**即座に訂正信号を受け取る**。これは自由形式のコードには出せない決定的な差だ。間違ったSQLはそのまま動いて本番で爆発しうるが、間違ったメタデータは門をくぐれず、その場で突き返されて書き直される。
+3. **生成時に検証されうる**：ランタイムが生成されたメタデータを検証する——不正な定義はその場で拒否され、エージェントは**即座に訂正信号を受け取る**。これは自由形式のコードには出せない決定的な差だ。間違ったSQLはそのまま動いて本番で爆発しうるが、間違ったメタデータは門をくぐれず、その場で突き返されて書き直される。このゲートは四つ——Typed・Validated・Reviewed・Governed——のうちの一つで、[ビジネスアプリが「AI が書ける」とはどういうことか](/ja/blog/what-makes-a-business-app-ai-writable/)は、実走で故意の三つのミスを拒否する様子を、それぞれが受け取るメッセージとともに示している。
 
 まさにこの3点目が、「エージェントに正しく書かせる」を運任せから、フィードバックのある収束プロセスへ変える——エージェントが書き間違え、拒否され、直す。コンパイルエラーのように即時だ。さらに一歩進めて、ランタイムのガバナンスされたツールを **MCP** 経由で公開すれば、エージェントは生成時に権威ある定義を取りに行き、ランタイムでは境界内でそれを操作できる——書くことと使うことが、一つのガバナンスを共有する。（ガバナンスされたツール層という件は、[MCPの記事](/ja/blog/mcp-governed-tool-layer/) で別途語った。）
 

content/blog/give-your-agent-rules-for-governable-apps/index.ko.mdx

@@ -3,7 +3,7 @@ title: "Agent 규칙 파일 작성법: AI가 거버넌스 가능한 앱을 생
 description: "AGENTS.md, .cursor/rules, CLAUDE.md는 코드 스타일만 다뤄서는 안 된다. 권한, 승인, 감사, 대상 메타데이터 형식을 쓰면 AI 생성 앱은 처음부터 검토하기 쉬워진다."
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ AI로 코드를 쓰는 거의 모든 팀이 이제 에이전트용 규칙 파일
 
 1. **학습될 수 있다**: 개방 + 공개 + 활발한 논의 → 학습 코퍼스에 편입 → 모델이 애초에 쓸 줄 안다.
 2. **제약될 수 있다**: 규칙 파일 하나가 에이전트의 결과물을 이 선언적 목표에 닻 내린다.
-3. **생성 시점에 검증될 수 있다**: 런타임이 생성된 메타데이터를 검증한다 — 부적합한 정의는 곧장 거부되고, 에이전트는 **그 자리에서 교정 신호를 받는다**. 이것이 자유 형식 코드는 줄 수 없는 결정적 차이다. 잘못된 SQL 한 토막은 멀쩡히 돌아가다가 출시되고 나서야 터질 수 있지만, 잘못된 메타데이터 한 벌은 문턱을 넘지 못하고 그 자리에서 되돌려 보내진다.
+3. **생성 시점에 검증될 수 있다**: 런타임이 생성된 메타데이터를 검증한다 — 부적합한 정의는 곧장 거부되고, 에이전트는 **그 자리에서 교정 신호를 받는다**. 이것이 자유 형식 코드는 줄 수 없는 결정적 차이다. 잘못된 SQL 한 토막은 멀쩡히 돌아가다가 출시되고 나서야 터질 수 있지만, 잘못된 메타데이터 한 벌은 문턱을 넘지 못하고 그 자리에서 되돌려 보내진다. 이 게이트는 네 개 — Typed, Validated, Reviewed, Governed — 중 하나이며, [What Makes a Business App AI-Writable?](/en/blog/what-makes-a-business-app-ai-writable/)(영어)는 실제 실행에서 일부러 넣은 세 가지 실수를 거부하는 모습을, 각 실수가 받는 메시지와 함께 보여 준다.
 
 바로 이 3번이, "에이전트가 제대로 쓰게 하기"를 운에 맡기는 것에서 피드백이 있는 수렴 과정으로 바꿔놓는다 — 에이전트가 틀리고, 거부당하고, 고쳐 쓰는 것이, 컴파일 에러처럼 즉각적이다. 더 나아가, 런타임의 거버넌스되는 도구를 **MCP**로 노출해, 에이전트가 생성 시점에는 권위 있는 정의를 끌어다 쓰고 런타임에는 경계 안에서 그것을 조작하게 할 수도 있다 — 쓰기와 쓰임이, 하나의 거버넌스를 공유한다. (거버넌스되는 도구 계층이라는 이 이야기는 [MCP 글](/ko/blog/mcp-governed-tool-layer/)에서 따로 다뤘다.)
 

content/blog/give-your-agent-rules-for-governable-apps/index.mdx

@@ -3,7 +3,7 @@ title: "How to Write Agent Rules That Generate Governable Apps"
 description: "Most agent rule files police style, not governance. Use AGENTS.md, .cursor/rules, and an open declarative target so AI-generated apps are reviewable from day one."
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ The answer is the flywheel argued in [the piece on the open semantic layer](/en/
 
 1. **Learnable**: open + public + discussed → enters the training corpus → the model already knows how to write it;
 2. **Constrainable**: a rules file anchors the agent's output to this declarative target;
-3. **Validatable at generation time**: the runtime validates the generated metadata — an illegal definition is rejected outright, and the agent **gets a correction signal on the spot.** This is the key difference free-form code can't offer: a bad piece of SQL may run fine and only blow up in production, while a bad piece of metadata never gets in the door — it's bounced back to be rewritten right then.
+3. **Validatable at generation time**: the runtime validates the generated metadata — an illegal definition is rejected outright, and the agent **gets a correction signal on the spot.** This is the key difference free-form code can't offer: a bad piece of SQL may run fine and only blow up in production, while a bad piece of metadata never gets in the door — it's bounced back to be rewritten right then. That gate is one of four — Typed, Validated, Reviewed, Governed — and [what makes a business app AI-writable](/en/blog/what-makes-a-business-app-ai-writable/) shows it refusing three deliberate mistakes in a real run, with the message each one gets.
 
 That third point turns "have the agent write it correctly" from luck into feedback-driven convergence: the agent writes it wrong, gets rejected, fixes it, much like a compile error. Going further, you can expose the runtime's governed tools via **MCP**, so the agent pulls authoritative definitions at generation time and operates within the boundary at runtime. Writing and using share one governance layer. That governed tool layer is covered in [the MCP piece](/en/blog/mcp-governed-tool-layer/).
 

content/blog/give-your-agent-rules-for-governable-apps/index.zh-Hans.mdx

@@ -3,7 +3,7 @@ title: Agent 规则文件怎么写：让 AI 生成可治理应用
 description: 编码 agent 的 AGENTS.md、.cursor/rules 或 CLAUDE.md 不该只管代码风格。把权限、审批、审计和目标元数据格式写进去，AI 生成的应用才更容易被审查和签字。
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -54,7 +54,7 @@ tags:
 
 1. **可被学到**：开放 + 公开 + 被讨论 → 更容易被模型和检索系统学到；
 2. **可被约束**：一份规则文件把 agent 的产出锚定到这个声明式目标；
-3. **可在生成时校验**：运行时会校验生成的元数据——非法的定义直接被拒，agent **当场拿到纠错信号**。这是自由格式代码给不了的关键差别：一段错的 SQL 可能照样跑、上线才爆，而一份错的元数据进不了门、当场就被打回重写。
+3. **可在生成时校验**：运行时会校验生成的元数据——非法的定义直接被拒，agent **当场拿到纠错信号**。这是自由格式代码给不了的关键差别：一段错的 SQL 可能照样跑、上线才爆，而一份错的元数据进不了门、当场就被打回重写。这道门禁是四道之一——类型、验证、审查、治理——[什么样的业务应用是 AI 可编写的](/zh-Hans/blog/what-makes-a-business-app-ai-writable/)用一次真实运行展示了它拒收三个故意犯的错，以及每个错拿到的消息。
 
 正是第 3 点，把"让 agent 写对"变成了有反馈的收敛过程——agent 写错、被拒、改对，像编译错误一样即时。更进一步，你还可以把运行时的受治理工具通过 **MCP** 暴露出来，让 agent 在生成时就调取权威定义、在运行时又能在边界内操作它——写和用，同一套治理。（受治理工具层这件事，[MCP 那篇](/zh-Hans/blog/mcp-governed-tool-layer/) 单独讲过。）
 

content/blog/give-your-agent-rules-for-governable-apps/index.zh-Hant.mdx

@@ -4,7 +4,7 @@ title: Agent 規則檔案怎麼寫：讓 AI 生成可治理應用
 description: 編碼 agent 的 AGENTS.md、.cursor/rules 或 CLAUDE.md 不該只管程式碼風格。把權限、審批、審計和目標後設資料格式寫進去，AI 生成的應用才更容易被審查和簽字。
 author: ObjectStack Team
 date: 2026-06-16T18:00:00+08:00
-updated: 2026-10-15T10:00:00+08:00
+updated: 2026-10-22T10:00:00+08:00
 status: published
 topic: ai-agents
 audience: developer
@@ -55,7 +55,7 @@ tags:
 
 1. **可被學到**：開放 + 公開 + 被討論 → 更容易被模型和檢索系統學到；
 2. **可被約束**：一份規則檔案把 agent 的產出錨定到這個宣告式目標；
-3. **可在生成時校驗**：執行時會校驗生成的後設資料——非法的定義直接被拒，agent **當場拿到糾錯訊號**。這是自由格式程式碼給不了的關鍵差別：一段錯的 SQL 可能照樣跑、上線才爆，而一份錯的後設資料進不了門、當場就被打回重寫。
+3. **可在生成時校驗**：執行時會校驗生成的後設資料——非法的定義直接被拒，agent **當場拿到糾錯訊號**。這是自由格式程式碼給不了的關鍵差別：一段錯的 SQL 可能照樣跑、上線才爆，而一份錯的後設資料進不了門、當場就被打回重寫。這道門禁是四道之一——型別、驗證、審查、治理——[什麼樣的業務應用是 AI 可編寫的](/zh-Hant/blog/what-makes-a-business-app-ai-writable/)用一次真實執行展示了它拒收三個故意犯的錯，以及每個錯拿到的訊息。
 
 正是第 3 點，把"讓 agent 寫對"變成了有反饋的收斂過程——agent 寫錯、被拒、改對，像編譯錯誤一樣即時。更進一步，你還可以把執行時的受治理工具通過 **MCP** 暴露出來，讓 agent 在生成時就調取權威定義、在執行時又能在邊界內操作它——寫和用，同一套治理。（受治理工具層這件事，[MCP 那篇](/zh-Hant/blog/mcp-governed-tool-layer/) 單獨講過。）