@aria_asi/cli 0.2.35 → 0.2.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (195) hide show
  1. package/CLIENT-ONBOARDING.md +4 -2
  2. package/bin/aria.js +11 -7
  3. package/dist/aria-connector/src/auth.d.ts +14 -0
  4. package/dist/aria-connector/src/auth.d.ts.map +1 -1
  5. package/dist/aria-connector/src/auth.js +103 -1
  6. package/dist/aria-connector/src/auth.js.map +1 -1
  7. package/dist/aria-connector/src/chat.d.ts.map +1 -1
  8. package/dist/aria-connector/src/chat.js +13 -8
  9. package/dist/aria-connector/src/chat.js.map +1 -1
  10. package/dist/aria-connector/src/config.d.ts +6 -1
  11. package/dist/aria-connector/src/config.d.ts.map +1 -1
  12. package/dist/aria-connector/src/config.js.map +1 -1
  13. package/dist/aria-connector/src/connectors/claude-code.d.ts.map +1 -1
  14. package/dist/aria-connector/src/connectors/claude-code.js +50 -6
  15. package/dist/aria-connector/src/connectors/claude-code.js.map +1 -1
  16. package/dist/aria-connector/src/connectors/codex.d.ts.map +1 -1
  17. package/dist/aria-connector/src/connectors/codex.js +312 -10
  18. package/dist/aria-connector/src/connectors/codex.js.map +1 -1
  19. package/dist/aria-connector/src/connectors/opencode.d.ts.map +1 -1
  20. package/dist/aria-connector/src/connectors/opencode.js +35 -11
  21. package/dist/aria-connector/src/connectors/opencode.js.map +1 -1
  22. package/dist/aria-connector/src/connectors/repo-guard.d.ts +10 -0
  23. package/dist/aria-connector/src/connectors/repo-guard.d.ts.map +1 -1
  24. package/dist/aria-connector/src/connectors/repo-guard.js +110 -164
  25. package/dist/aria-connector/src/connectors/repo-guard.js.map +1 -1
  26. package/dist/aria-connector/src/connectors/runtime.d.ts.map +1 -1
  27. package/dist/aria-connector/src/connectors/runtime.js +17 -7
  28. package/dist/aria-connector/src/connectors/runtime.js.map +1 -1
  29. package/dist/aria-connector/src/connectors/shell.d.ts.map +1 -1
  30. package/dist/aria-connector/src/connectors/shell.js +12 -8
  31. package/dist/aria-connector/src/connectors/shell.js.map +1 -1
  32. package/dist/aria-connector/src/harness-client.d.ts +3 -1
  33. package/dist/aria-connector/src/harness-client.d.ts.map +1 -1
  34. package/dist/aria-connector/src/harness-client.js +7 -20
  35. package/dist/aria-connector/src/harness-client.js.map +1 -1
  36. package/dist/aria-connector/src/model-context.d.ts.map +1 -1
  37. package/dist/aria-connector/src/model-context.js +5 -0
  38. package/dist/aria-connector/src/model-context.js.map +1 -1
  39. package/dist/aria-connector/src/providers/types.d.ts +1 -1
  40. package/dist/aria-connector/src/providers/types.d.ts.map +1 -1
  41. package/dist/aria-connector/src/providers/xai.d.ts +3 -0
  42. package/dist/aria-connector/src/providers/xai.d.ts.map +1 -0
  43. package/dist/aria-connector/src/providers/xai.js +40 -0
  44. package/dist/aria-connector/src/providers/xai.js.map +1 -0
  45. package/dist/aria-connector/src/setup-wizard.js +1 -0
  46. package/dist/aria-connector/src/setup-wizard.js.map +1 -1
  47. package/dist/aria-connector/src/types.d.ts +2 -0
  48. package/dist/aria-connector/src/types.d.ts.map +1 -1
  49. package/dist/assets/hooks/aria-cognition-substrate-binding.mjs +51 -9
  50. package/dist/assets/hooks/aria-first-class-coach.mjs +129 -0
  51. package/dist/assets/hooks/aria-harness-via-sdk.mjs +33 -6
  52. package/dist/assets/hooks/aria-pre-tool-gate.mjs +33 -8
  53. package/dist/assets/hooks/aria-preprompt-consult.mjs +5 -6
  54. package/dist/assets/hooks/aria-preturn-memory-gate.mjs +5 -0
  55. package/dist/assets/hooks/aria-repo-doctrine-gate.mjs +15 -0
  56. package/dist/assets/hooks/aria-stop-gate.mjs +125 -17
  57. package/dist/assets/hooks/doctrine_trigger_map.json +11 -0
  58. package/dist/assets/hooks/lib/emergency-gateoff-impl.mjs +39 -0
  59. package/dist/assets/hooks/lib/emergency-gateoff.mjs +6 -0
  60. package/dist/assets/hooks/lib/first-class-coach.mjs +755 -0
  61. package/dist/assets/hooks/lib/skill-autoload-gate-impl.mjs +103 -0
  62. package/dist/assets/hooks/lib/skill-autoload-gate.mjs +1 -14
  63. package/dist/assets/opencode-plugins/harness-context/auth-token.mjs +126 -0
  64. package/dist/assets/opencode-plugins/harness-context/inject-context.mjs +62 -22
  65. package/dist/assets/opencode-plugins/harness-context/task-project-ledger.mjs +290 -0
  66. package/dist/assets/opencode-plugins/harness-gate/index.js +87 -27
  67. package/dist/assets/opencode-plugins/harness-gate/lib/skill-autoload-gate.js +1 -14
  68. package/dist/assets/opencode-plugins/harness-outcome/index.js +29 -24
  69. package/dist/assets/opencode-plugins/harness-stop/index.js +229 -68
  70. package/dist/assets/opencode-plugins/harness-stop/lib/skill-autoload-gate.js +1 -14
  71. package/dist/runtime/auth-token.mjs +121 -0
  72. package/dist/runtime/coach-kernel.mjs +371 -0
  73. package/dist/runtime/codex-bridge.mjs +440 -69
  74. package/dist/runtime/discipline/doctrine_trigger_map.json +11 -0
  75. package/dist/runtime/discipline/skills/aria-cognition/aria-essence/SKILL.md +18 -0
  76. package/dist/runtime/discipline/skills/aria-cognition/aria-forge-guardrails/SKILL.md +18 -0
  77. package/dist/runtime/discipline/skills/aria-cognition/aria-repo-doctrine/SKILL.md +18 -0
  78. package/dist/runtime/discipline/skills/aria-cognition/forge-quality-rules/SKILL.md +18 -0
  79. package/dist/runtime/discipline/skills/aria-cognition/ghazali-8lens/SKILL.md +18 -0
  80. package/dist/runtime/discipline/skills/aria-cognition/istiqra-induction/SKILL.md +18 -0
  81. package/dist/runtime/discipline/skills/aria-cognition/ladunni-22/SKILL.md +18 -0
  82. package/dist/runtime/discipline/skills/aria-cognition/mizan/SKILL.md +18 -0
  83. package/dist/runtime/discipline/skills/aria-cognition/nadia/SKILL.md +18 -0
  84. package/dist/runtime/discipline/skills/aria-cognition/nadia-psi/SKILL.md +18 -0
  85. package/dist/runtime/discipline/skills/aria-cognition/predictor/SKILL.md +18 -0
  86. package/dist/runtime/discipline/skills/aria-cognition/qiyas-analogy/SKILL.md +18 -0
  87. package/dist/runtime/discipline/skills/aria-cognition/soul-domains/SKILL.md +18 -0
  88. package/dist/runtime/discipline/skills/aria-harness/aria-aristotle-intra-phase/SKILL.md +18 -0
  89. package/dist/runtime/discipline/skills/aria-harness/aria-aristotle-post-phase/SKILL.md +18 -0
  90. package/dist/runtime/discipline/skills/aria-harness/aria-aristotle-pre-phase/SKILL.md +18 -0
  91. package/dist/runtime/discipline/skills/aria-harness/aria-harness-deploy/SKILL.md +18 -0
  92. package/dist/runtime/discipline/skills/aria-harness/aria-harness-no-stripping/SKILL.md +18 -0
  93. package/dist/runtime/discipline/skills/aria-harness/aria-harness-onboarding/SKILL.md +18 -0
  94. package/dist/runtime/discipline/skills/aria-harness/aria-harness-output-discipline/SKILL.md +18 -0
  95. package/dist/runtime/discipline/skills/aria-harness/aria-harness-substrate-binding/SKILL.md +18 -0
  96. package/dist/runtime/doctrine_trigger_map.json +11 -0
  97. package/dist/runtime/hooks/aria-cognition-substrate-binding.mjs +51 -9
  98. package/dist/runtime/hooks/aria-first-class-coach.mjs +129 -0
  99. package/dist/runtime/hooks/aria-harness-via-sdk.mjs +33 -6
  100. package/dist/runtime/hooks/aria-pre-tool-gate.mjs +33 -8
  101. package/dist/runtime/hooks/aria-preprompt-consult.mjs +5 -6
  102. package/dist/runtime/hooks/aria-preturn-memory-gate.mjs +5 -0
  103. package/dist/runtime/hooks/aria-repo-doctrine-gate.mjs +15 -0
  104. package/dist/runtime/hooks/aria-stop-gate.mjs +125 -17
  105. package/dist/runtime/hooks/doctrine_trigger_map.json +11 -0
  106. package/dist/runtime/hooks/lib/emergency-gateoff-impl.mjs +39 -0
  107. package/dist/runtime/hooks/lib/emergency-gateoff.mjs +6 -0
  108. package/dist/runtime/hooks/lib/first-class-coach.mjs +755 -0
  109. package/dist/runtime/hooks/lib/skill-autoload-gate-impl.mjs +103 -0
  110. package/dist/runtime/hooks/lib/skill-autoload-gate.mjs +1 -14
  111. package/dist/runtime/local-phase.mjs +8 -0
  112. package/dist/runtime/manifest.json +2 -2
  113. package/dist/runtime/provider-proxy.mjs +136 -33
  114. package/dist/runtime/sdk/BUNDLED.json +2 -2
  115. package/dist/runtime/sdk/auth.d.ts +17 -0
  116. package/dist/runtime/sdk/auth.js +158 -0
  117. package/dist/runtime/sdk/auth.js.map +1 -0
  118. package/dist/runtime/sdk/index.d.ts +8 -1
  119. package/dist/runtime/sdk/index.js +15 -1
  120. package/dist/runtime/sdk/index.js.map +1 -1
  121. package/dist/runtime/service.mjs +1711 -74
  122. package/dist/runtime/task-project-ledger.mjs +290 -0
  123. package/dist/sdk/BUNDLED.json +2 -2
  124. package/dist/sdk/auth.d.ts +17 -0
  125. package/dist/sdk/auth.js +158 -0
  126. package/dist/sdk/auth.js.map +1 -0
  127. package/dist/sdk/index.d.ts +8 -1
  128. package/dist/sdk/index.js +15 -1
  129. package/dist/sdk/index.js.map +1 -1
  130. package/hooks/aria-cognition-substrate-binding.mjs +51 -9
  131. package/hooks/aria-first-class-coach.mjs +129 -0
  132. package/hooks/aria-harness-via-sdk.mjs +33 -6
  133. package/hooks/aria-pre-tool-gate.mjs +33 -8
  134. package/hooks/aria-preprompt-consult.mjs +5 -6
  135. package/hooks/aria-preturn-memory-gate.mjs +5 -0
  136. package/hooks/aria-repo-doctrine-gate.mjs +15 -0
  137. package/hooks/aria-stop-gate.mjs +125 -17
  138. package/hooks/doctrine_trigger_map.json +11 -0
  139. package/hooks/lib/emergency-gateoff-impl.mjs +39 -0
  140. package/hooks/lib/emergency-gateoff.mjs +6 -0
  141. package/hooks/lib/first-class-coach.mjs +755 -0
  142. package/hooks/lib/skill-autoload-gate-impl.mjs +103 -0
  143. package/hooks/lib/skill-autoload-gate.mjs +1 -14
  144. package/opencode-plugins/harness-context/auth-token.mjs +126 -0
  145. package/opencode-plugins/harness-context/inject-context.mjs +62 -22
  146. package/opencode-plugins/harness-context/task-project-ledger.mjs +290 -0
  147. package/opencode-plugins/harness-gate/index.js +87 -27
  148. package/opencode-plugins/harness-gate/lib/skill-autoload-gate.js +1 -14
  149. package/opencode-plugins/harness-outcome/index.js +29 -24
  150. package/opencode-plugins/harness-stop/index.js +229 -68
  151. package/opencode-plugins/harness-stop/lib/skill-autoload-gate.js +1 -14
  152. package/package.json +8 -2
  153. package/runtime-src/auth-token.mjs +121 -0
  154. package/runtime-src/coach-kernel.mjs +371 -0
  155. package/runtime-src/codex-bridge.mjs +440 -69
  156. package/runtime-src/local-phase.mjs +8 -0
  157. package/runtime-src/provider-proxy.mjs +136 -33
  158. package/runtime-src/service.mjs +1711 -74
  159. package/scripts/bundle-sdk.mjs +8 -0
  160. package/scripts/check-client-compatibility.mjs +422 -0
  161. package/scripts/check-coach-kernel.mjs +204 -0
  162. package/scripts/check-managed-runtime-ledger.mjs +107 -0
  163. package/scripts/check-opencode-config-contract.mjs +78 -0
  164. package/scripts/check-quality-ledger.mjs +121 -0
  165. package/scripts/self-test-harness-gates.mjs +179 -11
  166. package/scripts/self-test-repo-guard.mjs +38 -0
  167. package/scripts/validate-skill-prompts.mjs +14 -1
  168. package/skills/aria-cognition/aria-essence/SKILL.md +18 -0
  169. package/skills/aria-cognition/aria-forge-guardrails/SKILL.md +18 -0
  170. package/skills/aria-cognition/aria-repo-doctrine/SKILL.md +18 -0
  171. package/skills/aria-cognition/forge-quality-rules/SKILL.md +18 -0
  172. package/skills/aria-cognition/ghazali-8lens/SKILL.md +18 -0
  173. package/skills/aria-cognition/istiqra-induction/SKILL.md +18 -0
  174. package/skills/aria-cognition/ladunni-22/SKILL.md +18 -0
  175. package/skills/aria-cognition/mizan/SKILL.md +18 -0
  176. package/skills/aria-cognition/nadia/SKILL.md +18 -0
  177. package/skills/aria-cognition/nadia-psi/SKILL.md +18 -0
  178. package/skills/aria-cognition/predictor/SKILL.md +18 -0
  179. package/skills/aria-cognition/qiyas-analogy/SKILL.md +18 -0
  180. package/skills/aria-cognition/soul-domains/SKILL.md +18 -0
  181. package/src/auth.ts +136 -1
  182. package/src/chat.ts +13 -8
  183. package/src/config.ts +6 -1
  184. package/src/connectors/claude-code.ts +62 -18
  185. package/src/connectors/codex.ts +310 -10
  186. package/src/connectors/opencode.ts +35 -12
  187. package/src/connectors/repo-guard.ts +117 -172
  188. package/src/connectors/runtime.ts +19 -7
  189. package/src/connectors/shell.ts +12 -8
  190. package/src/harness-client.ts +8 -22
  191. package/src/model-context.ts +6 -0
  192. package/src/providers/types.ts +1 -1
  193. package/src/providers/xai.ts +55 -0
  194. package/src/setup-wizard.ts +1 -0
  195. package/src/types.ts +2 -0
@@ -572,6 +572,17 @@
572
572
  "teaching": "A service without a K8s manifest is not deployed — it's aspirational code. Every service in the registry must have a canonical k8s/<service>.yaml manifest. Without it, kubectl apply cannot restore the service after cluster restart.",
573
573
  "counter_action": "Create the canonical K8s manifest (Deployment + Service + liveness probe) at k8s/<service>.yaml. Register the service in k8s/service-registry.json. Never deploy via ad-hoc kubectl run or docker run — only via a version-controlled manifest.",
574
574
  "message": "Service lacks K8s manifest — see feedback_registry_image_drift.md"
575
+ },
576
+ {
577
+ "trigger_id": "containment_only_production_fix",
578
+ "trigger": "\\b(?:containment[- ]?only|only[- ]?contain(?:ed|ment)|just[- ]?contain(?:ed|ment))\\b|\\b(?:surface|cosmetic|appearance[- ]?only|form[- ]?only)\\s+(?:fix|repair|change)\\b|\\b(?:fix|repair|change)\\s+(?:only\\s+)?(?:the\\s+)?(?:surface|cosmetic|appearance|form)\\b|\\b(?:just|only|merely)\\s+(?:silence|satisfy|appease)\\s+(?:the\\s+)?(?:gate|hook|validator)\\b",
579
+ "rx": "\\b(?:containment[- ]?only|only[- ]?contain(?:ed|ment)|just[- ]?contain(?:ed|ment))\\b|\\b(?:surface|cosmetic|appearance[- ]?only|form[- ]?only)\\s+(?:fix|repair|change)\\b|\\b(?:fix|repair|change)\\s+(?:only\\s+)?(?:the\\s+)?(?:surface|cosmetic|appearance|form)\\b|\\b(?:just|only|merely)\\s+(?:silence|satisfy|appease)\\s+(?:the\\s+)?(?:gate|hook|validator)\\b",
580
+ "doctrine": "memory:feedback_gates_enforce_form_not_substance.md",
581
+ "memory": "feedback_gates_enforce_form_not_substance.md",
582
+ "severity": "block",
583
+ "teaching": "Containment-only production fixes are rationalized bypasses when they intentionally leave the broken user-visible mechanism unrepaired. Small source-level fixes are acceptable when they repair the root mechanism and are verified.",
584
+ "counter_action": "Keep the smallest correct change, but tie it to the root mechanism, observable recovery or proof, and user-visible verification; do not only silence gates or change cosmetics.",
585
+ "message": "Containment-only production fix detected. Preserve smallest-correct-change discipline, but replace cosmetic containment with root-mechanism repair plus observable recovery and proof."
575
586
  }
576
587
  ]
577
588
  }
@@ -61,3 +61,21 @@ For non-trivial work, make sure your internal workflow yields at least:
61
61
  - [references/domain-matrix.md](references/domain-matrix.md)
62
62
  - [references/evolution-loop.md](references/evolution-loop.md)
63
63
  - [references/readable-cognition.md](references/readable-cognition.md)
64
+
65
+ ## First-Class Production Contract
66
+
67
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
68
+
69
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
70
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
71
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
72
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
73
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
74
+ ## Self-Executing Recovery Contract
75
+
76
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
77
+
78
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
79
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
80
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
81
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -33,3 +33,21 @@ Use this skill when Aria should operate like a senior production engineer with c
33
33
  - surface unresolved risks directly
34
34
  - distinguish root fix from containment
35
35
  - keep cognition readable and short unless the user asks for the full internal framing
36
+
37
+ ## First-Class Production Contract
38
+
39
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
40
+
41
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
42
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
43
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
44
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
45
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
46
+ ## Self-Executing Recovery Contract
47
+
48
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
49
+
50
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
51
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
52
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
53
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -37,3 +37,21 @@ Use this skill on any doctrine-bound repo edit, even when the user did not expli
37
37
  4. Does the change improve the artifact from the right domain perspective, not only the easiest engineering perspective?
38
38
 
39
39
  If any answer is no, stop and choose a real implementation or isolate the work under an explicit allowlisted test or example path.
40
+
41
+ ## First-Class Production Contract
42
+
43
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
44
+
45
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
46
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
47
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
48
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
49
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
50
+ ## Self-Executing Recovery Contract
51
+
52
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
53
+
54
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
55
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
56
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
57
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -41,3 +41,21 @@ Use this when the task needs a sharper quality bar than "it compiles" or "it kin
41
41
 
42
42
  - [../aria-forge-guardrails/references/checklist.md](../aria-forge-guardrails/references/checklist.md)
43
43
  - [../aria-essence/references/evolution-loop.md](../aria-essence/references/evolution-loop.md)
44
+
45
+ ## First-Class Production Contract
46
+
47
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
48
+
49
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
50
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
51
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
52
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
53
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
54
+ ## Self-Executing Recovery Contract
55
+
56
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
57
+
58
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
59
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
60
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
61
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -36,3 +36,21 @@ Use this as a validation pass when a normal quick check would miss second-order
36
36
 
37
37
  - Use [../aria-essence/references/readable-cognition.md](../aria-essence/references/readable-cognition.md) for readable user-facing summaries.
38
38
  - Use [../aria-essence/references/evolution-loop.md](../aria-essence/references/evolution-loop.md) when the review yields a reusable principle.
39
+
40
+ ## First-Class Production Contract
41
+
42
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
43
+
44
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
45
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
46
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
47
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
48
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
49
+ ## Self-Executing Recovery Contract
50
+
51
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
52
+
53
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
54
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
55
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
56
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -24,3 +24,21 @@ Use this when the right answer should emerge from the evidence already present.
24
24
  ## Guardrail
25
25
 
26
26
  Do not jump from one example to a universal rule unless the evidence actually supports it.
27
+
28
+ ## First-Class Production Contract
29
+
30
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
31
+
32
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
33
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
34
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
35
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
36
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
37
+ ## Self-Executing Recovery Contract
38
+
39
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
40
+
41
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
42
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
43
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
44
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -33,3 +33,21 @@ Instead:
33
33
  - UX or funnel changes
34
34
  - code that affects support, sales, or business positioning
35
35
  - architecture decisions with product and operational consequences
36
+
37
+ ## First-Class Production Contract
38
+
39
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
40
+
41
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
42
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
43
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
44
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
45
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
46
+ ## Self-Executing Recovery Contract
47
+
48
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
49
+
50
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
51
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
52
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
53
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -70,3 +70,21 @@ Externally, keep the answer readable. The user should see clear reasoning, not a
70
70
  ## Readable Output
71
71
 
72
72
  Keep user-facing output plain. Let the runtime carry the heavy cognition and receipts.
73
+
74
+ ## First-Class Production Contract
75
+
76
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
77
+
78
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
79
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
80
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
81
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
82
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
83
+ ## Self-Executing Recovery Contract
84
+
85
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
86
+
87
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
88
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
89
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
90
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -36,3 +36,21 @@ Use this skill to choose how Aria should think and respond before the answer is
36
36
 
37
37
  - Read [../aria-essence/references/readable-cognition.md](../aria-essence/references/readable-cognition.md) for user-facing output discipline.
38
38
  - Read [../aria-essence/references/evolution-loop.md](../aria-essence/references/evolution-loop.md) if the chosen posture produced a reusable lesson.
39
+
40
+ ## First-Class Production Contract
41
+
42
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
43
+
44
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
45
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
46
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
47
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
48
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
49
+ ## Self-Executing Recovery Contract
50
+
51
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
52
+
53
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
54
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
55
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
56
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -36,3 +36,21 @@ Use this when the base posture choice is not enough and the finer state really c
36
36
 
37
37
  - [../aria-essence/references/readable-cognition.md](../aria-essence/references/readable-cognition.md)
38
38
  - [../aria-essence/references/evolution-loop.md](../aria-essence/references/evolution-loop.md)
39
+
40
+ ## First-Class Production Contract
41
+
42
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
43
+
44
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
45
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
46
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
47
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
48
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
49
+ ## Self-Executing Recovery Contract
50
+
51
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
52
+
53
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
54
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
55
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
56
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -23,3 +23,21 @@ Use this to ask whether the current approach will survive contact with the next
23
23
  ## Guardrail
24
24
 
25
25
  Prediction is for preventing breakage, not for inventing facts.
26
+
27
+ ## First-Class Production Contract
28
+
29
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
30
+
31
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
32
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
33
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
34
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
35
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
36
+ ## Self-Executing Recovery Contract
37
+
38
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
39
+
40
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
41
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
42
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
43
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -24,3 +24,21 @@ Use this when the task benefits from transferring a known structure instead of i
24
24
  ## Guardrail
25
25
 
26
26
  Analogy is subordinate to evidence. If the current repo/runtime truth disagrees, the analogy loses.
27
+
28
+ ## First-Class Production Contract
29
+
30
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
31
+
32
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
33
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
34
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
35
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
36
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
37
+ ## Self-Executing Recovery Contract
38
+
39
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
40
+
41
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
42
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
43
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
44
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -23,3 +23,21 @@ Use this skill to determine which disciplines should govern the decision.
23
23
  - Do not pretend to have exact threshold math if the live domain service was not consulted.
24
24
  - The point is better decisions, not fancy vocabulary.
25
25
  - If only one domain truly matters, say so plainly.
26
+
27
+ ## First-Class Production Contract
28
+
29
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
30
+
31
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
32
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
33
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
34
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
35
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
36
+ ## Self-Executing Recovery Contract
37
+
38
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
39
+
40
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
41
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
42
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
43
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -79,3 +79,21 @@ These are the cognition-action mismatches the intra-phase catches before they sh
79
79
  ## Bottom line
80
80
 
81
81
  Intra-phase is where mid-sequence drift gets caught before it ships. The MetaCognitive snapshot via SDK + the cognition-action coherence check together prevent the most common pattern the Stop-gate catches reactively: cognition emitted, then action drifts, then gate blocks. Loading this skill at multi-step boundaries makes the drift detection proactive instead of post-hoc.
82
+
83
+ ## First-Class Production Contract
84
+
85
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
86
+
87
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
88
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
89
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
90
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
91
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
92
+ ## Self-Executing Recovery Contract
93
+
94
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
95
+
96
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
97
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
98
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
99
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -96,3 +96,21 @@ These are the patterns post-phase intercepts before the Stop-gate fires reactive
96
96
  ## Bottom line
97
97
 
98
98
  Post-phase is where the response gets validated against the action's actual outcome before emission. The 8-lens detector + Predictor + SelfReflection + state-claim verification + cognition-log + discovery-sweep together close the gap that Stop-gate catches reactively. Loading this skill at end-of-action boundaries makes the response-quality discipline proactive: the response earns its emission, it doesn't just hope the gate doesn't catch it.
99
+
100
+ ## First-Class Production Contract
101
+
102
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
103
+
104
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
105
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
106
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
107
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
108
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
109
+ ## Self-Executing Recovery Contract
110
+
111
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
112
+
113
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
114
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
115
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
116
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -97,3 +97,21 @@ Reactive gates that fire when this skill is not honored:
97
97
  ## Bottom line
98
98
 
99
99
  Pre-phase is the phase where thinking happens. The cognition block is its artifact. Skipping pre-phase or emitting the cognition as ceremony AFTER the response is drafted produces the violations the Stop-gate catches reactively. Loading this skill at every action boundary makes the pre-phase contract proactive: you see what to do BEFORE drafting, not after the gate blocks.
100
+
101
+ ## First-Class Production Contract
102
+
103
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
104
+
105
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
106
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
107
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
108
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
109
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
110
+ ## Self-Executing Recovery Contract
111
+
112
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
113
+
114
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
115
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
116
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
117
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -125,3 +125,21 @@ If any of these fail, do NOT deploy. Fix the underlying issue first — never st
125
125
  ## Owner-permission boundary
126
126
 
127
127
  Three failed gate-blocks in a row triggers owner-level bypass-prevention lockout. If your verify block is failing repeatedly, STOP retrying. The pattern is the gate parser doesn't recognize your field syntax. Read `~/.claude/hooks/aria-pre-tool-gate.mjs` to find the exact regex, then fix your verify block to match — do not retry the same shape three times.
128
+
129
+ ## First-Class Production Contract
130
+
131
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
132
+
133
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
134
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
135
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
136
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
137
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
138
+ ## Self-Executing Recovery Contract
139
+
140
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
141
+
142
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
143
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
144
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
145
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -115,3 +115,21 @@ If you cannot fill in Y and Z with verified evidence, you are stripping. Stop. D
115
115
  - `feedback_no_flag_without_fix.md` — atomic discovery + fix pairing
116
116
  - `feedback_state_outcomes_not_narratives.md` — present-tense outcomes, not narrative camouflage
117
117
  - `feedback_senior_dev_code_quality_gate.md` — junior/LLM-flavored shortcuts rejected at gate
118
+
119
+ ## First-Class Production Contract
120
+
121
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
122
+
123
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
124
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
125
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
126
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
127
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
128
+ ## Self-Executing Recovery Contract
129
+
130
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
131
+
132
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
133
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
134
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
135
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -110,3 +110,21 @@ The harness exists because doctrine is action-coupled: text decisions ARE action
110
110
  Quality production-grade is the only acceptable bar — for code contracts AND for output prose. Both are owned. Both are the producer-side discipline.
111
111
 
112
112
  When in doubt: cite the substrate, declare the predicate, name the doctrine, reframe — don't strip.
113
+
114
+ ## First-Class Production Contract
115
+
116
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
117
+
118
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
119
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
120
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
121
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
122
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
123
+ ## Self-Executing Recovery Contract
124
+
125
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
126
+
127
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
128
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
129
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
130
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -100,3 +100,21 @@ If they understand AND no raw tokens leaked — your prose passes all three gate
100
100
  - `feedback_state_outcomes_not_narratives.md` — present-tense outcomes
101
101
  - `feedback_use_harness_to_architect.md` — make declarative recommendations, not reflex-questions
102
102
  - `feedback_no_demos.md` — all work is production-grade
103
+
104
+ ## First-Class Production Contract
105
+
106
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
107
+
108
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
109
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
110
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
111
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
112
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
113
+ ## Self-Executing Recovery Contract
114
+
115
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
116
+
117
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
118
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
119
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
120
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -119,3 +119,21 @@ This is auto-recorded as an open discovery in `~/.claude/aria-discoveries-<sessi
119
119
  - `feedback_packet_is_not_harness.md` — never claim harness state without enumerating L1/L2/L3
120
120
  - `feedback_no_flag_without_fix.md` — discoveries atomic with their fixes
121
121
  - `feedback_implementation_coupled_cognition.md` — lenses dictate specific implementation choices visible in artifact
122
+
123
+ ## First-Class Production Contract
124
+
125
+ This skill must deepen the work, not decorate it. When loaded, apply it as a production requirement:
126
+
127
+ - no placeholders, no fake fallbacks, no vague future wiring, and no cosmetic compliance
128
+ - real proof from the repo, runtime, tests, logs, endpoint, or owner instruction before any completion claim
129
+ - a redo contract whenever the skill blocks or finds a gap: what failed, what to change, how to re-test, and when to re-submit
130
+ - architect/ARIA console escalation when the same failure repeats twice, crosses system boundaries, or cannot be verified locally
131
+ - owner-visible output that states the exact state of the work: changed, verified, blocked, or needing a decision
132
+ ## Self-Executing Recovery Contract
133
+
134
+ When this skill blocks, fails verification, or finds a gap, the agent must execute recovery rather than hand work back as a user-only decision.
135
+
136
+ - Make exactly one self-executed recovery attempt using the strongest safe local, repository, runtime, test, log, endpoint, or owner-provided evidence available.
137
+ - If the same failure repeats after that one recovery attempt, switch to architect execution mode: operate under the architect/ARIA harness to diagnose, choose the next action, execute the repair path, and verify the result.
138
+ - If Aria or the architect service is unavailable, fall back to the strongest available client LLM under the architect harness or strongest available local harness substrate; mark the fallback explicitly and continue recovery instead of stopping.
139
+ - Do not end with user-handoff-only behavior. If blocked after the recovery path, report the executed recovery attempt, evidence, remaining blocker, and the next concrete action or owner decision needed; do not merely ask the user to take over.
@@ -572,6 +572,17 @@
572
572
  "teaching": "A service without a K8s manifest is not deployed — it's aspirational code. Every service in the registry must have a canonical k8s/<service>.yaml manifest. Without it, kubectl apply cannot restore the service after cluster restart.",
573
573
  "counter_action": "Create the canonical K8s manifest (Deployment + Service + liveness probe) at k8s/<service>.yaml. Register the service in k8s/service-registry.json. Never deploy via ad-hoc kubectl run or docker run — only via a version-controlled manifest.",
574
574
  "message": "Service lacks K8s manifest — see feedback_registry_image_drift.md"
575
+ },
576
+ {
577
+ "trigger_id": "containment_only_production_fix",
578
+ "trigger": "\\b(?:containment[- ]?only|only[- ]?contain(?:ed|ment)|just[- ]?contain(?:ed|ment))\\b|\\b(?:surface|cosmetic|appearance[- ]?only|form[- ]?only)\\s+(?:fix|repair|change)\\b|\\b(?:fix|repair|change)\\s+(?:only\\s+)?(?:the\\s+)?(?:surface|cosmetic|appearance|form)\\b|\\b(?:just|only|merely)\\s+(?:silence|satisfy|appease)\\s+(?:the\\s+)?(?:gate|hook|validator)\\b",
579
+ "rx": "\\b(?:containment[- ]?only|only[- ]?contain(?:ed|ment)|just[- ]?contain(?:ed|ment))\\b|\\b(?:surface|cosmetic|appearance[- ]?only|form[- ]?only)\\s+(?:fix|repair|change)\\b|\\b(?:fix|repair|change)\\s+(?:only\\s+)?(?:the\\s+)?(?:surface|cosmetic|appearance|form)\\b|\\b(?:just|only|merely)\\s+(?:silence|satisfy|appease)\\s+(?:the\\s+)?(?:gate|hook|validator)\\b",
580
+ "doctrine": "memory:feedback_gates_enforce_form_not_substance.md",
581
+ "memory": "feedback_gates_enforce_form_not_substance.md",
582
+ "severity": "block",
583
+ "teaching": "Containment-only production fixes are rationalized bypasses when they intentionally leave the broken user-visible mechanism unrepaired. Small source-level fixes are acceptable when they repair the root mechanism and are verified.",
584
+ "counter_action": "Keep the smallest correct change, but tie it to the root mechanism, observable recovery or proof, and user-visible verification; do not only silence gates or change cosmetics.",
585
+ "message": "Containment-only production fix detected. Preserve smallest-correct-change discipline, but replace cosmetic containment with root-mechanism repair plus observable recovery and proof."
575
586
  }
576
587
  ]
577
588
  }