@wildo-ai/framework-knowledge 1.1.4 → 1.1.5

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 (848) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +227 -6
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  11. package/dist/esm/index.d.ts.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  13. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  17. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  19. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  23. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  25. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  27. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  33. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  37. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  38. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  39. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  40. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  41. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  43. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  45. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  47. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  48. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  49. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  51. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  53. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  55. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  57. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  58. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  59. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  60. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  62. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  63. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  67. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  68. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  70. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  74. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  78. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  79. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  81. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  82. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  83. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  85. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  87. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  88. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  89. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  90. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  91. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  93. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  95. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  97. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  99. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  101. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  103. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  104. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  105. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  106. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  107. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  109. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  110. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  111. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  113. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  115. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  117. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  119. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  121. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  122. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  123. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  124. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  125. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  126. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  127. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  128. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  129. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  130. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  131. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  132. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  133. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  134. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  135. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  137. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  138. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  139. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  140. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  141. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  143. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  145. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  147. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  151. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  154. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  161. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  165. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  169. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  171. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  172. package/dist/knowledge/manifest.json +9 -8
  173. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  174. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  175. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  176. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  179. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  180. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  181. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  182. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  183. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  184. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  185. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  186. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  187. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  188. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  189. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  190. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  191. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  192. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  193. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  194. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  195. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  196. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  197. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  198. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  199. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  200. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  201. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  202. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  203. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  204. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  205. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  206. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  207. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  208. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  209. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  210. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  211. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  212. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  214. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  215. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  216. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  217. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  218. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  219. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  220. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  221. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  222. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  223. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  224. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  225. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  226. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  227. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  228. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  229. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  230. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  234. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  235. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  237. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  238. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  239. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  240. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  241. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  242. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  243. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  244. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  245. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  246. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  247. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  248. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  249. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  250. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  251. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  252. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  253. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  254. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  255. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  256. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  257. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  258. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  259. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  260. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  261. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  262. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  263. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  264. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  267. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  268. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  269. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  270. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  272. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  273. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  274. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  275. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  276. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  277. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  278. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  279. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  280. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  281. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  282. package/dist/knowledge/references/application-maturity.config.md +319 -0
  283. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  284. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  285. package/dist/knowledge/references/brand.asset.config.md +8 -16
  286. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  287. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  288. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  289. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  291. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  294. package/dist/knowledge/references/capability-composition.config.md +155 -0
  295. package/dist/knowledge/references/cli.market.utils.md +1 -0
  296. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  297. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  298. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  299. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  300. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  301. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  302. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  303. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  304. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  305. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  306. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  307. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  308. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  309. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  310. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  311. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  312. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  313. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  314. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  315. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  316. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  317. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  318. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  319. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  320. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  321. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  322. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  323. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  324. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  325. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  326. package/dist/knowledge/references/experience-plan.config.md +311 -0
  327. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  328. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  329. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  330. package/dist/knowledge/references/integration-plan.config.md +185 -0
  331. package/dist/knowledge/references/market.alternative.config.md +1 -1
  332. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  333. package/dist/knowledge/references/market.channel.config.md +3 -3
  334. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  335. package/dist/knowledge/references/market.gain.config.md +1 -1
  336. package/dist/knowledge/references/market.icp.config.md +2 -2
  337. package/dist/knowledge/references/market.job.config.md +1 -1
  338. package/dist/knowledge/references/market.message-template.config.md +2 -2
  339. package/dist/knowledge/references/market.objection.config.md +1 -1
  340. package/dist/knowledge/references/market.pain.config.md +1 -1
  341. package/dist/knowledge/references/market.persona.config.md +2 -2
  342. package/dist/knowledge/references/market.proof.config.md +1 -1
  343. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  345. package/dist/knowledge/references/market.trigger.config.md +1 -1
  346. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  347. package/dist/knowledge/references/placement-plan.config.md +369 -0
  348. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  349. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  350. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  351. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  352. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  353. package/dist/knowledge/references/platform.config.saas.md +261 -9
  354. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  355. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  356. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  357. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  358. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  359. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  361. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  362. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  363. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  364. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  365. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  366. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  367. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  368. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  369. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  370. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  371. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  372. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  373. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  374. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  375. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  376. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  377. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  378. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  379. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  380. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  381. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  382. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  384. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  385. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  386. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  387. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  388. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  389. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  390. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  391. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  392. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  393. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  395. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  396. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  397. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  398. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  399. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  400. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  401. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  402. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  403. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  404. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  405. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  406. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  407. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  408. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  409. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  410. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  411. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  412. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  413. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  414. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  415. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  416. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  417. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  418. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  419. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  420. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  421. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  422. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  423. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  425. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  428. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  429. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  430. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  431. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  432. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  433. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  434. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  435. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  436. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  437. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  438. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  439. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  440. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  441. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  442. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  443. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  444. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  445. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  446. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  447. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  448. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  449. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  450. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  451. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  452. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  453. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  458. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  459. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  460. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  461. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  462. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  464. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  465. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  466. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  469. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  470. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  472. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  473. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  474. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  475. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  476. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  477. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  478. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  479. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  480. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  481. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  482. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  483. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  484. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  485. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  486. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  487. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  488. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  489. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  490. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  491. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  492. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  493. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  494. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  495. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  496. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  497. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  498. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  499. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  500. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  501. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  502. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  503. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  504. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  505. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  506. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  507. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  508. package/dist/knowledge/references/website-plan.config.md +205 -0
  509. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  510. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  511. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  512. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  513. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  514. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  515. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  516. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  517. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  518. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  519. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  520. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  521. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  522. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  523. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  524. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  525. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  526. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  527. package/dist/knowledge/references/zod.factories.address.md +118 -0
  528. package/dist/knowledge/references/zod.factories.code.md +2 -0
  529. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  530. package/dist/knowledge/references/zod.factories.money.md +2 -0
  531. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  532. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  533. package/dist/knowledge/registries/framework-topics.json +1215 -11
  534. package/dist/knowledge/registries/playbooks.json +454 -50
  535. package/dist/knowledge/registries/source-tags.json +3153 -1043
  536. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  537. package/dist/knowledge/rules/live-context-door.md +108 -0
  538. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  539. package/dist/knowledge/skills/INDEX.md +46 -11
  540. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  541. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  542. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  543. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  544. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  545. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  546. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  547. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  548. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  549. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  550. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  551. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  552. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  553. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  554. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  555. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  556. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  557. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  558. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  559. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  560. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  561. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  562. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  563. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  564. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  565. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  566. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  567. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  568. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  569. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  570. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  571. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  572. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  573. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  574. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  575. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  576. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  577. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  578. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  579. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  580. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  581. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  582. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  583. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  584. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  585. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  586. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  589. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  590. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  591. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  592. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  593. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  594. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  595. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  596. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  597. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  598. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  599. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  600. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  601. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  602. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  603. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  604. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  605. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  606. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  607. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  608. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  609. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  610. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  611. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  612. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  613. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  614. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  615. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  616. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  617. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  618. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  619. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  620. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  621. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  622. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  623. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  624. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  625. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  626. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  627. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  628. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  629. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  630. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  631. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  632. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  633. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  634. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  635. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  636. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  637. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  638. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  639. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  640. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  641. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  642. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  643. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  644. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  645. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  646. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  647. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  648. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  649. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  650. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  651. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  652. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  653. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  654. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  655. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  656. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  657. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  658. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  659. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  660. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  661. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  662. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  663. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  664. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  665. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  666. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  667. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  668. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  669. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  670. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  671. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  672. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  673. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  674. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  675. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  676. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  677. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  678. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  679. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  680. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  681. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  682. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  683. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  684. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  685. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  686. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  687. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  688. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  689. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  690. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  691. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  692. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  693. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  694. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  695. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  696. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  697. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  698. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  699. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  700. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  701. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  702. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  703. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  704. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  705. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  706. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  707. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  708. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  709. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  710. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  711. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  712. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  713. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  714. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  715. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  716. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  717. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  718. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  719. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  720. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  721. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  722. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  723. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  724. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  725. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  726. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  727. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  728. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  736. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  737. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  738. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  739. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  740. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  741. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  742. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  743. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  744. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  745. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  746. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  747. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  748. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  749. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  750. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  751. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  752. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  753. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  754. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  755. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  756. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  757. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  758. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  759. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  760. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  762. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  763. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  765. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  766. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  767. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  768. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  769. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  770. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  771. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  772. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  773. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  774. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  775. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  776. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  777. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  778. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  779. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  780. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  781. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  782. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  783. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  784. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  785. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  786. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  787. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  788. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  789. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  790. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  791. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  792. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  793. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  794. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  795. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  796. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  797. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  798. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  799. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  800. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  801. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  802. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  803. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  804. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  805. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  806. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  807. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  808. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  809. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  810. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  811. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  812. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  813. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  814. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  815. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  816. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  817. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  818. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  819. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  820. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  821. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  822. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  823. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  824. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  825. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  826. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  827. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  828. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  829. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  830. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  831. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  832. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  833. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  834. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  835. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  836. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  837. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  838. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  839. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  840. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  841. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  842. package/dist/knowledge/topic-index.json +5335 -1010
  843. package/dist/tsconfig.build.tsbuildinfo +1 -1
  844. package/dist/tsconfig.tsbuildinfo +1 -1
  845. package/package.json +4 -4
  846. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  847. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  848. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -1,19 +1,20 @@
1
1
  {
2
2
  "ref": "bottom_up.build-decompose",
3
- "version": "0.1.0",
3
+ "version": "0.4.0",
4
4
  "phase": "bottom_up",
5
- "intent": "Bottom-up build decomposition — the FIRST build-execution playbook, the pivot from planning the domain (the domain-plan) to decomposing the BUILD. Reads the approved domain-plan (the ModuleBusinessSemantics module drafts + per-module resource inventory), the relationship drafts inside it (the inter-resource relationship intents), and the definition set (roadmap for phasing, requirements + feature-drafts for task-brief context), and DECOMPOSES the build work into an ordered set of coding-agent tasks. Each task is bound onto (a) the 7-topic functional taxonomy (configure_application_foundation -> model_domain_graph -> define_interaction_semantics -> shape_user_experience -> extend_application -> connect_runtime_and_external_capabilities -> assemble_verify_and_iterate) and (b) the app-knowledge skill catalog (each task names the skill(s) that carry its technical HOW). The tasks follow the per-resource inner order (schema -> config -> ui-behavior -> spec, then operations / interaction semantics, then UX, then extensions, then integrations), with companion-owned generation steps (labels / i18n, email templates, seeds) interleaved at the points their inputs exist. This playbook PRODUCES the ordered task graph (a build-plan artifact); it does NOT dispatch tasks to coding agents (that is the dispatch-orchestration playbook downstream), does NOT capture change-sets / single-flight-lock / verify, and does NOT solve multi-agent scale or interleaving. It authors no schemas and generates no code. v1 scaffold methodology — a typed build-task-graph contract, a dependency-DAG solver, and a collection validator are a later depth phase, not here.",
6
- "functionalTopics": [],
5
+ "intent": "Bottom-up build decomposition — the FIRST build-execution playbook, the pivot from planning the domain (the domain-plan) to decomposing the BUILD. Reads the approved domain-plan (the ModuleBusinessSemantics module drafts + per-module resource inventory), the relationship drafts inside it (the inter-resource relationship intents), and the definition set (roadmap for phasing, requirements + feature-drafts for task-brief context), and the PLACEMENT PLAN (where each settings destination, resource operation and view sits in the shell, decided upstream), and DECOMPOSES the build work into an ordered set of coding-agent tasks. Each task is bound onto (a) the 7-topic functional taxonomy (configure_application_foundation -> model_domain_graph -> define_interaction_semantics -> shape_user_experience -> extend_application -> connect_runtime_and_external_capabilities -> assemble_verify_and_iterate) and (b) the app-knowledge skill catalog (each task names the skill(s) that carry its technical HOW). The tasks follow the per-resource inner order (schema -> config -> ui-behavior -> spec, then operations / interaction semantics, then UX, then extensions, then integrations), with companion-owned generation steps (i18n-labels, email-templates, logo, and database-migrations for applications with an accepted PostgreSQL schema plan) interleaved at the points their inputs exist. This playbook PRODUCES the ordered task graph (a build-plan artifact); it does NOT dispatch tasks to coding agents (that is the dispatch-orchestration playbook downstream), does NOT capture change-sets / single-flight-lock / verify, and does NOT solve multi-agent scale or interleaving. It authors no schemas and generates no code. The typed BuildPlanTaskGraph contract and deterministic validator already exist. Declare prerequisiteTaskRefs explicitly: the host derives readiness from those edges; functionalTopic provides context and skill routing, not an implicit execution order.",
7
6
  "preconditions": [
8
- {
9
- "kind": "phase_is",
10
- "phase": "bottom_up"
11
- },
12
7
  {
13
8
  "kind": "artifact_exists",
14
9
  "selector": {
15
10
  "family": "domain-plan"
16
11
  }
12
+ },
13
+ {
14
+ "kind": "artifact_expected",
15
+ "selector": {
16
+ "family": "placement-plan"
17
+ }
17
18
  }
18
19
  ],
19
20
  "inputs": [
@@ -28,18 +29,43 @@
28
29
  },
29
30
  {
30
31
  "family": "feature-drafts"
32
+ },
33
+ {
34
+ "family": "placement-plan"
35
+ },
36
+ {
37
+ "family": "vision-brief"
38
+ },
39
+ {
40
+ "family": "brand-brief",
41
+ "render": "map"
42
+ },
43
+ {
44
+ "family": "experience-plan"
45
+ },
46
+ {
47
+ "family": "documentation-plan"
48
+ },
49
+ {
50
+ "family": "integration-plan"
51
+ },
52
+ {
53
+ "family": "website-plan"
54
+ },
55
+ {
56
+ "family": "build-plan"
31
57
  }
32
58
  ],
33
59
  "outputs": [
34
60
  {
35
61
  "family": "build-plan",
36
62
  "schemaRef": "saas-specifications:BuildPlanTaskGraph",
37
- "placement": ".wildo-saas/journey/<journeyId>/build-plan/",
38
- "description": "The build decomposition — an ORDERED set of coding-agent build tasks (a task graph) that turns the approved domain plan into a sequence of buildable units. Each task carries: a stable task ref, the target it builds (a module, a resource + one of its build stages, a relationship, a companion-generation step), the ONE functional topic it belongs to (a real MetaWorkflow_FunctionalTopic value), the skill(s) that carry its technical HOW (real folders from the app-knowledge skill catalog, resolved via the skills router), and its ordering intent (which tasks must precede it — expressed as prose prerequisite references, NOT a solved DAG). The ordering respects two axes: (a) the cross-app topic dependency edges (model_domain_graph before define_interaction_semantics before app-level shape_user_experience before extend_application before connect_runtime_and_external_capabilities; foundation and assemble/verify are owned by sibling playbooks) and (b) the per-resource stage sequence schema -> config -> ui-behavior -> spec — which deliberately CROSSES topics (ui-behavior is shape_user_experience; the spec is a model_domain_graph documentation capstone ordered last) and so is not monotonic on axis (a); a roadmap-driven MVP-first preference breaks ties within a band. TYPED since the flexible-intelligence Block 3: the `_core` build-task-graph contract (`BuildPlanTaskGraph` — `tasks[]` with a stable `taskRef`, a closed `BuildPlanTaskTargetKind` target (MODULE / RESOURCE_STAGE / RELATIONSHIP / COMPANION_GENERATION_STEP), exactly one `functionalTopic`, `skillRefs`, DECLARED `prerequisiteTaskRefs` the host resolves for readiness, and traceability `servesRefs`) is the family schema; the provider answers the strict `BuildPlanTaskGraphGeneration` shape and the trusted runtime stamps refs and version. The task never carries paths, commands, prompts or runtime controls — the dispatch host derives mutation scope and verification from the target kind. `validateBuildPlanTaskGraph` is the deterministic validator (prerequisite cycles are a hard floor; a resource stage without its predecessor stage is an authoring warning); the coherence reviewer checklist (`build-plan-coherent`, in the method) remains the semantic check and the creator's approve_result review the trust floor. Consumed by the bottom-up DISPATCH-ORCHESTRATION playbook (which single-flight-dispatches each task through the coding-agent contract) and the SCALE playbook (which parallelises + interleaves the companion generation steps) — both downstream of this decomposition."
63
+ "description": "The build decomposition — an ORDERED set of coding-agent build tasks (a task graph) that turns the approved domain plan into a sequence of buildable units. Each task carries: a stable task ref, the target it builds (a module, a resource + one of its build stages, a relationship, a companion-generation step, a shell-surface placement config), WHAT IT PRODUCES (`produces` — the artifacts whose presence in the finished application proves the task landed; distinct from the target, which is a write scope several tasks may share), the ONE functional topic it belongs to (a real MetaWorkflow_FunctionalTopic value), the skill(s) that carry its technical HOW (real folders from the app-knowledge skill catalog, resolved via the skills router), and its ordering intent (which tasks must precede it — expressed as typed prerequisiteTaskRefs, which the host resolves for readiness). Author prerequisiteTaskRefs to express the actual dependencies, using these planning considerations: (a) the cross-app topic dependency edges (model_domain_graph before define_interaction_semantics before app-level shape_user_experience before extend_application before connect_runtime_and_external_capabilities; foundation and assemble/verify are owned by sibling playbooks) and (b) the per-resource stage sequence schema -> config -> ui-behavior -> spec — which deliberately CROSSES topics (ui-behavior is shape_user_experience; the spec is a model_domain_graph documentation capstone ordered last) and so is not monotonic on axis (a); a roadmap-driven MVP-first preference breaks ties within a band. TYPED since the flexible-intelligence Block 3: the `_core` build-task-graph contract (`BuildPlanTaskGraph` — `tasks[]` with a stable `taskRef`, a closed `BuildPlanTaskTargetKind` target (MODULE / RESOURCE_STAGE / RELATIONSHIP / COMPANION_GENERATION_STEP / SHELL_PLACEMENT / MODULE_FRONTEND / MODULE_BACKEND / APPLICATION_FRONTEND_CONFIG / WEBSITE / TECHNICAL_DOCUMENTATION / WORKER / MINION / PROVIDER_BINDING), a `produces` list over the closed `BuildPlanTaskProductKind` vocabulary (the resource products — schema fields, registration, ui-behavior, specification, relationship, operation, composite / custom / chart view, PDF template; the application products — view, document, module, frontend configuration, custom component, milestone, guidance; and the runtime products — worker jobs, minion behaviours, provider binding, website page and section, documentation chapter), exactly one `functionalTopic`, `skillRefs`, DECLARED `prerequisiteTaskRefs` the host resolves for readiness, and traceability `servesRefs`) is the family schema; the provider answers the strict `BuildPlanTaskGraphGeneration` shape and the trusted runtime stamps refs and version. The task never carries paths, commands, prompts or runtime controls — the dispatch host derives mutation scope and verification from the target kind. `validateBuildPlanTaskGraph` is the deterministic validator. A task's products must name something COMPOSITION DOES NOT ALREADY WRITE (the fields a schema gains, not its scaffolded file) and no two tasks may claim the same artifact — that is what makes landing decidable; a coding task declaring none is reported as `TASK_DECLARES_NO_PRODUCT`. If such a task has a COMPLETED durable run, the host advances past it but reports its ref in `unverifiableLandedTaskRefs`: it ran, but its output is not proven. Without that completed run it remains unlanded. Companion-generation tasks use their own landed conditions; migrations require the schema plan to be in sync. Product probes inspect committed files and named declarations, not runtime correctness. Two things are HARD FLOORS: a prerequisite cycle, and a resource stage that declares its predecessor stage in the SAME graph without depending on it — dispatch order comes solely from `prerequisiteTaskRefs`, so an undeclared stage edge lets the host author a resources-config for a schema that has not landed. A predecessor stage that is ABSENT from the plan is an authoring WARNING instead, because a plan may legitimately author one stage of a resource the tree already carries; the coherence reviewer checklist (`build-plan-coherent`, in the method) remains the semantic check and the creator's approve_result review the trust floor. Consumed by the bottom-up DISPATCH-ORCHESTRATION playbook (which single-flight-dispatches each task through the coding-agent contract) and the SCALE playbook (which parallelises + interleaves the companion generation steps) — both downstream of this decomposition."
39
64
  }
40
65
  ],
66
+ "stepOutputs": [],
41
67
  "method": {
42
- "guidance": "# Build Decompose — Domain Plan → Ordered Coding-Agent Task Graph (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to be\n> iterated. The decomposition heuristic, the per-resource stage order, and the\n> task-shape convention below are deliberately explicit so they can be tuned against\n> real runs — treat them as a starting rubric, not a frozen contract. The *analytical\n> depth* of build planning (a typed task-graph contract, a dependency-DAG solver with\n> transitive ordering, a collection validator, cost/effort estimation) is intentionally\n> shallow here and is deepened in a later phase; do not perfect it in this playbook.\n\n## Where you are in the journey\n\nThis is the **first build-execution playbook** — the pivot from **planning the\ndomain** (the domain-plan: modules, per-module resource inventory, relationship\nintents) to **decomposing the build** (the ordered set of buildable tasks). It runs\nin the **bottom-up phase**, after the domain plan exists (`artifact_exists\ndomain-plan`). You are not re-opening domain questions here — you are turning an\n*approved* domain plan into the *ordered work that builds it*.\n\nDownstream of this playbook, two further playbooks consume your output: the\n**dispatch-orchestration** playbook single-flight-dispatches each task through the\ncoding-agent contract, and the **scale** playbook parallelises and interleaves the\ncompanion generation steps. **You author neither of those concerns** — see the\nboundary section below.\n\n## What this playbook does\n\nYou are the **build planner**. This playbook reads the approved domain plan and the\ndefinition set and drafts the **build plan**: the answer to *\"what ordered sequence\nof coding-agent tasks turns this domain plan into a running app?\"* You produce **one\nartifact**: the **build-plan** family — an **ordered task graph**, each task bound\nonto the **7-topic functional taxonomy** and the **app-knowledge skill catalog**.\n\nThis is a **decomposition pass**. You name tasks, their target, their topic, their\nskill(s), and their ordering intent. You do **not** dispatch any task, capture any\nchange-set, author any schema, or generate any code — that is the job of the\ndownstream dispatch / scale playbooks and the coding agents they run.\n\n## Read state first — what you read, the one artifact you write\n\nThis playbook is **idempotent** and, on a re-run, a *refinement*. Before decomposing\nanything:\n\n1. Read the current journey state and scope through the `journey-status` skill (it\n owns the read; do not re-derive it here). Confirm the domain plan is present and\n approved, and check whether a `build-plan` already exists from an earlier run\n (refine it, do not re-author — see below).\n2. Read the approved domain plan and the definition set. **Load-bearing** (these drive\n the decomposition): the **domain-plan** (`domain-plan` — the module decomposition +\n each module's `mainResources` / `supportingResources` inventory) and the\n **relationship drafts** (inside the domain-plan value — the inter-resource relationship\n intents, each with two ends + cardinality intent + ownership direction).\n **Contextual** (they shape ordering and task briefs, not the core decomposition):\n the **roadmap** (`roadmap` — the release phasing, so MVP-critical modules are\n sequenced before later ones) and the **requirements** + **feature-drafts** (the\n prose contracts each task's brief points the coding agent at).\n\n// TODO CLI COMMAND: wildo context journey-status\n// (read current journey scope + approved domain plan + any existing build plan)\n// TODO CLI COMMAND: wildo context domain-plan\n// (read the module decomposition + per-module resource inventory to decompose)\n\nYou **read** `domain-plan` (incl. its relationship drafts) + `roadmap` + `requirements` +\n`feature-drafts`; you **write** the `build-plan` family.\n\n3. Read the **current application workspace** section supplied with this brief (the real\n module ids and each resource's present schema fields). It is BINDING, in both directions:\n - Every task's `moduleRef` MUST be one of the listed module ids, exactly — a module id\n the workspace does not carry is an invented address the dispatcher cannot route.\n - A resource the workspace already lists exists as a **compose-born starter skeleton**\n (registered, typechecking, carrying the fields shown). Its stage tasks are\n **enrichment** tasks: their objective states what domain content to ADD or CHANGE.\n An objective that asks to \"create\" or \"scaffold\" such a resource describes work that\n is already done, and the dispatched coding run will correctly change nothing.\n\n## The two ordering axes\n\nEvery task you emit is placed on **two ordering axes**. They are **distinct** — the\nper-resource sequence deliberately *spans* topics and is not monotonic on the topic\nchain — so keep them separate and satisfy both:\n\n1. **The topic dependency edges** (across the whole app — from the taxonomy's\n `Depends On`): `configure_application_foundation` → `model_domain_graph` →\n `define_interaction_semantics` → app-level `shape_user_experience` →\n `extend_application` → `connect_runtime_and_external_capabilities` →\n `assemble_verify_and_iterate`. You author neither the foundation (a sibling\n playbook, Topic 1) nor the final assemble/verify (a sibling playbook, Topic 7) —\n you decompose the middle bands (Topics 2–6). The edges you must respect: an\n operation task after the resources it acts on; an **app-level** view / navigation\n task after the interaction semantics and resources it composes; an extension after\n the UX it extends; an integration after the resources it connects.\n2. **The per-resource inner stage order** (within one resource):\n **schema → config → ui-behavior → spec.** This is a *dependency* sequence (each\n stage needs the prior artifact) and it deliberately **crosses topics**: schema +\n config are `model_domain_graph`, ui-behavior is `shape_user_experience`, and the\n spec is the `model_domain_graph` documentation capstone authored last. Two\n consequences to get right:\n - A resource's **own** ui-behavior (its field displays / forms) depends only on\n that resource's schema + config — so it may be ordered **before** cross-resource\n operations. That is **not** a topic-chain violation; only *app-level* UX\n (views / navigation composing multiple resources or operations) waits on the\n interaction-semantics band.\n - The **spec** task is a documentation capstone: order it **after** the stages it\n documents (schema, config, ui-behavior), regardless of its `model_domain_graph`\n topic binding. Its topic says *what* it documents; its ordering says *after what*.\n\n**Sequencing tiebreaker — MVP first.** The two axes constrain *relative* order but leave\nfreedom in which module to build first. Break that tie with the **roadmap** — but note the\nroadmap is requirement-addressed, not module-addressed: a phase delivers\n`deliversRequirementRefs` / `deliversSuccessCriterionRefs`, not modules. So trace each\nmodule's requirements to the earliest roadmap phase that delivers them, then sequence the\nmodules whose requirements land in an earlier phase (NOW / MVP) before those whose\nrequirements land later (NEXT / LATER), so a partial build is a coherent MVP slice rather\nthan a scattered half of every module. This is a soft ordering preference, not a hard\nprerequisite — never let it override the two hard axes above.\n\n## Step 1 — Emit the module + resource tasks (the domain-graph band)\n\nWalk the domain plan module by module. For each **module**, first check whether the\n**foundation step** (a sibling playbook) already scaffolded its slice — it normally has,\nbecause foundation materialises every module in the domain plan. Emit a module task only\nwhere that is not guaranteed; then, for each **resource** in that module's inventory,\nemit the ordered per-resource stage tasks:\n\n| Task | Functional topic | Skill (the HOW) |\n|---|---|---|\n| **(only when needed)** Ensure module `<id>` slice exists + is registered across runtimes — **normally already done by the foundation step**; emit this only for a module the foundation step did NOT establish (e.g. one added to the plan after foundation ran). Idempotent, never a blind re-scaffold | `model_domain_graph` | `resource-add-module` + `module-registration` |\n| Resource `<name>` — domain schema (fields, enums, structural decorators). **Workspace-aware**: when the resource already exists as a compose-born starter (see the workspace section), the objective names the DOMAIN content to add to it; only a resource the workspace does not list gets a skeleton-creation objective | `model_domain_graph` | `resource-add-resource` (skeleton, only when the resource does not exist yet) + `resource-schema-authoring` (the persisted shape) |\n| Resource `<name>` — config (registry presence, core operation verbs, access / role scope — but NOT cross-resource relationships, which are the dedicated Step 2 tasks) | `model_domain_graph` | `resource-config-wiring` |\n| Resource `<name>` — ui-behavior (field displays / forms / enum chrome — the resource's own UX) | `shape_user_experience` | `resource-ui-behavior` |\n| Resource `<name>` — spec (canonical business semantics — the per-resource documentation capstone) | `model_domain_graph` | `spec-resource-update` |\n\n> **Two things this table is careful about.** (a) **`ui-behavior` is `shape_user_experience`,\n> not interaction semantics** — a resource's field-display / form chrome is UX (Topic 4's\n> \"resource displays / forms\"); the resource's *operations* (custom verbs, access, scope) are a\n> SEPARATE interaction-semantics band, Step 3. (b) The **`spec` task is a documentation\n> capstone**: it documents the resource's fields (domain), operations (interaction), and frontend\n> (UX), so its single topic binding is `model_domain_graph` (the spec's canonical role is business\n> semantics), but its *ordering* is \"after the stages it documents\", not a topic-chain position —\n> see the ordering axes below. (c) **Module scaffolding + registration is the foundation\n> step's job** (a sibling playbook that materialises every domain-plan module). Do NOT emit a\n> module-scaffold or module-registration task for a module foundation already established — that\n> double-counts foundation. The build loop's domain-graph band is per-**resource**; only ensure a\n> module slice where foundation genuinely did not (e.g. a module added to the plan after\n> foundation ran).\n\nRules for a buildable domain-graph band:\n\n- **Cover every module and every resource** in the inventory (both `mainResources`\n and `supportingResources`). A module or resource with no task is a coverage GAP (the\n build would not produce it).\n- **Not every resource needs every stage.** A `mainResource` (the entity the module is\n about) typically earns the full schema → config → ui-behavior → spec sequence. A\n `supportingResource` may not: a pure junction / lookup entity needs schema + config\n but no ui-behavior (it has no first-class UX surface). Emit the stages the resource\n genuinely needs, and say why a stage is omitted — do NOT pad every supporting\n resource with a UX task it will never use.\n- **Respect the per-resource stage order** (schema → config → ui-behavior → spec) as\n prose prerequisite references on each task (\"depends on: resource `<name>` — schema\").\n- **State objectives against workspace reality.** A task for a resource the workspace\n section already lists says what to ENRICH (\"author the deal-pipeline stage enum and\n amount/close-date fields the domain plan declares on `deals`\"), never \"create the\n `deals` resource\" — that file exists and a creation objective dispatches a no-op.\n `moduleRef` values come from the workspace section verbatim.\n- **Do not author fields or schemas here.** The task *names* the resource and its\n stage and points the coding agent at the skill; *what* fields the resource carries\n is resolved by the coding agent at dispatch time, from the domain plan + the skill.\n If you catch yourself writing a field list, stop — that is the coding agent's job.\n (Naming the domain CONCERN a stage must cover — \"the pipeline stages\", \"the follow-up\n reminder date\" — is objective-writing, not field authoring; listing concrete\n field-by-field types would be.)\n\n## Step 2 — Emit the relationship-wiring tasks\n\nFor each **relationship-draft**, emit one wiring task:\n\n| Task | Functional topic | Skill (the HOW) |\n|---|---|---|\n| Wire relationship `<A> <-> <B>` (`<cardinality>`, `<owner>` holds the ref) | `model_domain_graph` | `module-relationships` |\n\nRules:\n\n- **This is the single home for cross-resource relationships.** A relationship is wired\n ONCE, here, by the `module-relationships` skill (which coordinates the FK across the\n owner's schema + config, the target's relationship map, and both specs coherently). Do\n NOT also wire it inside the per-resource config task in Step 1 — that config task\n establishes the resource's registry presence and core verbs, not its cross-resource\n FKs. Emitting the relationship in both places double-counts the work.\n- **Order after both endpoints' schema tasks.** A relationship-wiring task references\n two resources; both must have a schema task ordered before it (a relationship wired\n before an endpoint exists is a GAP).\n- **Carry the intent, not the resolution.** The task states the two ends, the\n cardinality intent, and the ownership direction from the relationship-draft. The\n cardinality-to-FK-holder resolution (discriminator / conditional relationships, the\n physical FK placement) is the `module-relationships` skill's job **at dispatch\n time**, not decided here.\n\n## Step 3 — Emit the interaction, UX, extension, and integration tasks\n\nOnce the domain graph is decomposed, emit the tasks for the later topic bands, drawn\nfrom the requirements + feature-drafts. Bind each task to **one** functional topic and\nto the skill(s) that carry its HOW, resolved from the **skills router**\n(`.claude/skills/INDEX.md` in the app — the catalog index that routes a task to its\nskill folder). Do **not** guess a skill name; route through the index.\n\n- **`define_interaction_semantics`** — custom operations, lifecycle behaviour, access /\n role / scope rules, rate limits — interaction beyond the default resource verbs.\n- **`shape_user_experience`** — app-level composite views, navigation, layouts, the app\n shell, design-system application, charts (the cross-resource UX; a resource's own\n field-display ui-behavior was already emitted in Step 1).\n- **`extend_application`** — custom UI components / widgets, custom implementation\n logic, PDF templates / renderers, workers / minions and other auxiliary execution\n surfaces (the controlled extension points where the declarative model is not enough).\n- **`connect_runtime_and_external_capabilities`** — providers, external connectors,\n billing wiring, email / notification wiring, storage, infra / environment config.\n\n(Seed authoring and the label / email generation are companion-owned generation steps —\nsee Step 4 — not coding-agent extension tasks.)\n\nRules:\n\n- **Every task names a real topic + a real skill.** A task with an invented topic or a\n skill folder that does not exist is a GAP (the dispatch playbook would have nothing\n to run). Route through the skills index; do not invent.\n- **Respect the topic dependency edges.** An operation task after the resources it acts\n on; an app-level view / navigation task after the interaction semantics **and** every\n resource it composes; an extension after the UX it extends; an integration after the\n resources it connects. (A resource's own field-display ui-behavior was already emitted\n in Step 1 and needs only that resource's schema/config — see the ordering axes.)\n- **Draw tasks from the definition set, not a blank page.** A UX or operation task\n earns its existence from a requirement or feature-draft; a task justified by nothing\n in the definition set is a CONCERN (speculative work).\n\n## Step 4 — Interleave the companion-owned generation steps\n\nSome build steps are **companion-owned deterministic generation**, not coding-agent\nwork. Emit these as tasks too — `target.kind: COMPANION_GENERATION_STEP` with\n`generationStepRef` set to the EXACT step slug below (the companion executes only this\nclosed vocabulary; any other slug refuses at dispatch) — and **order them after the\nsurfaces whose output they consume**:\n\n- **`i18n-labels`** — label generation + translation to every enabled locale. Order it\n after the resources / ui-behavior / views whose labels it generates.\n- **`email-templates`** — email template + label generation and label translation.\n Order it after the notification/email surfaces it renders.\n\nSeed generation joins this vocabulary when its companion pipeline exists. Until then,\ndo **not** author a seeds generation step — an unknown `generationStepRef` refuses at\ndispatch instead of parking the build.\n\nYou **place** these steps in the order; you do **not** design how they run\nconcurrently with coding-agent tasks (that interleaving-at-scale concern is the scale\nplaybook's job — see the boundary below).\n\n## Refine, don't re-author\n\n- **Keep what still holds.** On a re-run, do not re-decompose modules or resources\n whose tasks are already correct. Only add a task, re-order where a prerequisite\n changed, or add/correct a relationship-wiring task where the domain plan genuinely\n changed.\n- **Reuse existing task refs.** A task that already exists keeps its ref — never mint a\n second ref for the same unit of work.\n- **Never orphan an ordering reference.** A task's prerequisite reference must name a\n task that is actually in the plan. If you remove or rename a task, follow it into\n every prerequisite reference.\n\n## Quality gate — `build-plan-coherent` (declarative at scaffold depth)\n\nThe build plan is checked against the `build-plan-coherent` **reviewer checklist** (see the end of this method):\nseven invariants (module + resource coverage, task well-formedness, per-resource stage\norder, topic dependency order, relationship coverage, companion-generation interleave,\nand decomposition-depth boundary discipline), each marked PASS / CONCERN / GAP.\n\nThis checklist is **declarative**: no runtime executes it (rubric-only judge gates were retired at the flexible-intelligence hard cut — judgment runs only through a compiled Evaluation Treatment, and this playbook has none yet), so it ships as the **creator's review checklist** — nothing runs it automatically. The **trust floor** for accepting the build plan today is the\ncreator's `approve_result` review of the produced task graph. There is intentionally\n**no deterministic gate**: no typed build-task-graph contract or collection validator\nexists at this phase (see the boundary below).\n\n## Scaffold-depth boundary (deferred to a later depth phase, or owned by a sibling)\n\nKeep this playbook at decomposition depth. Explicitly **out of scope here**:\n\n- **Dispatch execution.** You do NOT dispatch any task, spawn any coding agent, build a\n context pack, or run the coding-agent contract. That is the **dispatch-orchestration**\n playbook, downstream of this decomposition.\n- **Workspace-mutation safety.** Single-flight locking, clean-worktree preconditions,\n change-set capture (git baseline / diff), and the failure-policy revert/flag mechanics\n are the dispatch playbook's concern — NOT modelled here. A task that describes *how* it\n is captured or locked is out of this playbook's depth.\n- **Verify / quality-gate mechanics.** Running typecheck, validators, tests, or reviewer\n agents *around* a dispatched task is the dispatch playbook's verify step, and the app-wide\n assemble / verify phase (Topic 7) is its own sibling playbook — you emit **neither**. You\n decompose Topics 2–6 only.\n- **Multi-agent scale + interleaving.** Parallelising tasks across multiple coding\n agents, and interleaving the companion generation steps concurrently with coding-agent\n runs, is the **scale** playbook. You produce a linear-enough ordered graph with prose\n prerequisite intent; you do NOT solve the concurrency schedule.\n- **Schema / field authoring + code generation.** You name resources and stages; you do\n NOT author fields, enums, decorators, Zod schemas, or any code, and you do NOT resolve\n a cardinality intent into a concrete FK. That is the coding agent at dispatch time.\n- **A typed build-task-graph contract + a collection validator.** The `build-plan`\n family has **no schemaRef** because the framework ships no `_core` build-task-graph\n shape, and it has no deterministic gate because no task-graph validator exists. A typed\n task contract, a dependency-DAG solver, and a module-set coverage validator are all a\n filed depth-phase item — do **NOT** reshape `_core` here.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at\ndecomposition depth — depth is a dedicated later pass, and dispatch/scale are sibling\nplaybooks.\n\n## What you emit\n\nOne artifact for this journey:\n\n- The **build-plan** at `.wildo-saas/journey/<journeyId>/build-plan/` — an ordered task\n graph: the per-resource (schema / config / ui-behavior / spec) tasks, the\n relationship-wiring tasks, the interaction / UX / extension / integration tasks, any\n module-ensure tasks foundation did not cover, and the interleaved companion-generation\n steps — each carrying its target, its one functional topic, its skill(s), and its prose\n ordering intent.\n\nThe creator reviews the result (approval posture `approve_result`) before it is accepted\nas the journey's build plan, which the dispatch-orchestration and scale playbooks then\nturn into dispatched, verified coding-agent runs.\n\n## References\n\n- `.claude/skills/journey-status/SKILL.md` — read the current journey state and scope,\n and confirm the approved domain plan is in place to decompose the build from.\n- `.claude/skills/resource-add-module/SKILL.md` — the module-scaffolding vocabulary, for\n the conditional ensure-module task (only where the foundation step did not establish the\n module slice).\n- `.claude/skills/resource-add-resource/SKILL.md` — the resource vocabulary (the\n resource-skeleton task in the schema stage).\n- `.claude/skills/resource-schema-authoring/SKILL.md` — the schema stage (first\n per-resource task).\n- `.claude/skills/resource-config-wiring/SKILL.md` — the config stage (second\n per-resource task).\n- `.claude/skills/resource-ui-behavior/SKILL.md` — the ui-behavior stage (third\n per-resource task).\n- `.claude/skills/spec-resource-update/SKILL.md` — the spec stage (fourth per-resource\n task).\n- `.claude/skills/module-relationships/SKILL.md` — the relationship-wiring task's HOW\n (cardinality-to-FK-holder resolution, at dispatch time — named here, not performed).\n- `.claude/skills/module-registration/SKILL.md` — the cross-runtime module-registration\n task's HOW.\n- `.claude/skills/INDEX.md` — the skills router: consult it to bind each interaction /\n UX / extension / integration task to its real skill folder from the full catalog. Do\n not invent skill names; route through the index.\n\n## Reviewer checklist — `build-plan-coherent`\n\nFormerly authored as an `llm_judge` quality gate; the generic rubric-only gate kind was retired at the flexible-intelligence hard cut (judgment now runs only through a compiled Evaluation Treatment). The checklist itself is creator-facing review guidance and is kept here, verbatim, minus the retired runner's closing sentence:\n\nJudge whether the drafted build plan is a coherent, complete, correctly-ordered decomposition of the approved domain plan into coding-agent tasks — WITHOUT straying into how those tasks execute. Assess seven invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) MODULE + RESOURCE COVERAGE — every resource in every module's inventory (mainResources + supportingResources) has build tasks; a resource with no task is a GAP (the build would not produce it). Task `moduleRef` values must be module ids the workspace section lists (an invented module id is a GAP — the dispatcher cannot route it), and a task whose objective CREATES a resource the workspace section shows already exists — instead of enriching it — is a CONCERN (it dispatches a no-op). Module slices are scaffolded by the foundation step (a sibling playbook), so a module needs a dedicated ensure-module task ONLY where foundation did not establish it — a module whose resources have tasks but which carries no redundant scaffold task is NOT a GAP (do not flag the absence of a module-scaffold task foundation already owns); a module added to the plan after foundation with neither a foundation slice nor an ensure-module task IS a GAP. (2) TASK WELL-FORMEDNESS — every task names exactly ONE functional topic that is a real MetaWorkflow_FunctionalTopic value (configure_application_foundation / model_domain_graph / define_interaction_semantics / shape_user_experience / extend_application / connect_runtime_and_external_capabilities / assemble_verify_and_iterate) and at least one skill that is a real folder in the app-knowledge skill catalog; a task with an invented topic or a dangling skill is a GAP. (3) PER-RESOURCE STAGE ORDER — for each resource, its tasks respect the inner order schema -> config -> ui-behavior -> spec; a config task ordered before that resource's schema task, or a spec task before its ui-behavior task, is a GAP (the build stage would run against a missing prerequisite). A supportingResource (e.g. a pure junction / lookup entity) may legitimately OMIT stages it does not need — a junction with schema + config and no ui-behavior is fine; only an out-of-ORDER stage (or a mainResource missing schema/config) is a GAP, not an intentionally-omitted stage on a supporting resource. (4) TOPIC DEPENDENCY ORDER — tasks respect the topic dependency edges (model_domain_graph before define_interaction_semantics; app-level shape_user_experience [views / navigation composing multiple resources or operations] after the interaction semantics and resources it composes; extend_application after the UX it extends; connect_runtime_and_external_capabilities after the resources it connects). Note the deliberate exception: a resource's OWN ui-behavior (its field displays / forms, a shape_user_experience task) depends only on that resource's own schema + config and MAY precede cross-resource operations — that is NOT a violation. What IS a GAP: an app-level view composing resources/operations placed before they exist, an integration task before the resources it connects, or any user-experience task before that resource's schema task. The per-resource spec task is a documentation capstone (topic model_domain_graph) and must be ordered after the schema / config / ui-behavior stages it documents; a spec task before its ui-behavior stage is a GAP. (5) RELATIONSHIP COVERAGE — every relationship-draft has a wiring task (bound to the module-relationships skill) ordered AFTER both endpoint resources' schema tasks; a relationship with no wiring task, or one ordered before its endpoints exist, is a GAP. (6) COMPANION-GENERATION INTERLEAVE — the executable companion-owned generation steps (`i18n-labels`, `email-templates`) are present and placed AFTER the resources / modules whose output they consume; a labels-generation task ordered before the resources it labels, or a missing executable generation step for authored surfaces, is a CONCERN. Do NOT flag the absence of a seeds step — seed generation has no companion pipeline yet and must not be authored. (7) BOUNDARY DISCIPLINE — the plan stays at DECOMPOSITION depth: it names tasks, their topic, their skill(s), their target, and their ordering intent; it does NOT specify how a task is DISPATCHED (single-flight locking, change-set capture, git baseline, verify/quality-gate mechanics = the dispatch-orchestration playbook) and does NOT solve multi-agent SCALE or interleaving concurrency (= the scale playbook). Any task that describes how a task EXECUTES rather than WHAT it builds, or that authors a schema / resolves a cardinality into a concrete FK / generates code, is a CONCERN (scope creep out of the decomposition phase). (The checklist is declarative: nothing executes it; the deterministic gates and the creator's approval remain the floors.)\n",
68
+ "guidance": "# Build Decompose — Domain Plan → Ordered Coding-Agent Task Graph \n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\nThe output follows the existing `BuildPlanTaskGraph` contract. The host checks its\nshape and graph consistency, then uses `prerequisiteTaskRefs` to determine readiness.\nFunctional topics organize context; they do not create scheduling edges. Decompose\nthe work using the current contracts rather than designing a replacement planner.\n\n## Where you are in the journey\n\nThis is the **first build-execution playbook** — the pivot from **planning the\ndomain** (the domain-plan: modules, per-module resource inventory, relationship\nintents) to **decomposing the build** (the ordered set of buildable tasks). It runs\nin the **bottom-up phase**, after the domain plan exists (`artifact_exists\ndomain-plan`). You are not re-opening domain questions here — you are turning an\n*approved* domain plan into the *ordered work that builds it*.\n\nDownstream of this playbook, two further playbooks consume your output: the\n**dispatch-orchestration** playbook single-flight-dispatches each task through the\ncoding-agent contract, and the **scale** playbook parallelises and interleaves the\ncompanion generation steps. **You author neither of those concerns** — see the\nboundary section below.\n\n## What this playbook does\n\nYou are the **build planner**. This playbook reads the approved domain plan and the\ndefinition set and drafts the **build plan**: the answer to *\"what ordered sequence\nof coding-agent tasks turns this domain plan into a running app?\"* You produce **one\nartifact**: the **build-plan** family — an **ordered task graph**, each task bound\nonto the **7-topic functional taxonomy** and the **app-knowledge skill catalog**.\n\nThis is a **decomposition pass**. You name tasks, their target, **what each one\nproduces**, their topic, their skill(s), and their ordering intent. You do **not** dispatch any task, capture any\nchange-set, author any schema, or generate any code — that is the job of the\ndownstream dispatch / scale playbooks and the coding agents they run.\n\n## Read state first — what you read, the one artifact you write\n\nThis playbook is **idempotent** and, on a re-run, a *refinement*. Before decomposing\nanything:\n\n1. Read the current journey state and scope through the `journey-status` skill (it\n owns the read; do not re-derive it here). Confirm the domain plan is present and\n approved, and check whether a `build-plan` already exists from an earlier run\n (refine it, do not re-author — see below).\n2. Read the approved domain plan and the definition set. **Load-bearing** (these drive\n the decomposition): the **domain-plan** (`domain-plan` — the module decomposition +\n each module's `mainResources` / `supportingResources` inventory) and the\n **relationship drafts** (inside the domain-plan value — the inter-resource relationship\n intents, each with two ends + cardinality intent + ownership direction).\n **Contextual** (they shape ordering and task briefs, not the core decomposition):\n the **roadmap** (`roadmap` — the release phasing, so MVP-critical modules are\n sequenced before later ones) and the **requirements** + **feature-drafts** (the\n prose contracts each task's brief points the coding agent at).\n\n(Both are already in your brief: the domain plan renders under \"# Accepted application truth\", and\nthe real module/resource state arrives as the declared `workspace_truth` context section of your brief. There is no command to\nrun in this mode.)\n\nYou **read** `domain-plan` (incl. its relationship drafts) + `roadmap` + `requirements` +\n`feature-drafts`; you **write** the `build-plan` family.\n\n3. Read the **current application workspace** section supplied with this brief (the real\n module ids and each resource's present schema fields). It is BINDING, in both directions:\n - Every task's `moduleRef` MUST be one of the listed module ids, exactly — a module id\n the workspace does not carry is an invented address the dispatcher cannot route.\n - A resource the workspace already lists exists as a **compose-born starter skeleton**\n (registered, typechecking, carrying the fields shown). Its stage tasks are\n **enrichment** tasks: their objective states what domain content to ADD or CHANGE.\n An objective that asks to \"create\" or \"scaffold\" such a resource describes work that\n is already done, and the dispatched coding run will correctly change nothing.\n\n## Every task declares WHAT IT PRODUCES\n\nEach task carries `produces`: the artifacts the finished application will contain\n*because this task ran*. It is how the host answers **\"has this task landed?\"**, and\nit is not optional thinking: without declared products the host cannot probe the\nintended result. A COMPLETED durable run lets the loop advance, but the task remains\nexplicitly marked in `unverifiableLandedTaskRefs` as ran, not proven.\n\n**`target` and `produces` answer different questions, and a task needs both.**\n`target` is the WRITE SCOPE — which module tree this run may edit. Several tasks\nlegitimately share one. `produces` is the PRODUCT IDENTITY — what this task, and no\nother, is accountable for. Wonder CRM's plan proved they cannot be the same field:\nits pipeline-view task and its follow-through-operation task carry byte-identical\ntargets, so nothing derived from `target` could ever tell them apart, and 40 of its\n42 tasks were reported finished while none had run.\n\n**The one rule that makes a product real: name something the SCAFFOLD does not\nalready contain.** Every module, every resource file and every resource\nspecification is written by composition before any task exists. So \"the resource\nconfig file\" is not a product — it was there on day one. The VERBS it gains are.\nApply that test to every product you write.\n\n| product | you name | use it for |\n|---|---|---|\n| `RESOURCE_SCHEMA_FIELDS` | `resourceRef` + the `fieldRefs` the task adds | a schema stage. The FIELDS, never the file — the file is scaffolded. A `fieldRef` is the field's own IDENTIFIER as it will stand in the schema (`slug`, `archivedAt`, `completedAt`), never a description of what the fields express |\n| `RESOURCE_REGISTRATION` | `resourceRef` + the `operationRefs` it gains | a config stage |\n| `RESOURCE_UI_BEHAVIOR` | `resourceRef` | a ui-behavior stage — the one artifact composition never writes |\n| `RESOURCE_SPECIFICATION` | `resourceRef` + the `fieldRefs` it documents | a spec stage. The fields again: the spec file is scaffolded too |\n\n**A product ref is an ARTIFACT IDENTITY, not a concept.** Every `produces` entry is read back by a\nLANDING PROBE that searches the application's own source for that ref — in its plain, camelCase,\nPascalCase and SCREAMING_SNAKE spellings — and a task lands only when the probe finds it. So a ref\nnaming something that will never appear in the tree makes the task permanently unlandable, however\ncorrectly it is built.\n\nMeasured on the first end-to-end journey run (#1273): all sixteen schema tasks declared refs like\n`private-workspace-shape`, `membership-access-shape` and `one-sentence-rationale-shape` — eighteen\nrefs, not one of them a field. The schemas were authored correctly and committed; every task stayed\nunlanded, the loop guard then refused the whole band at task one, and the board read 9 of 94 while\nthe work was being done.\n\nName what a reader will find in the file. `slug`, `description`, `archivedAt` — not the idea they\nserve together. If you cannot name the fields yet, the task is not decomposed far enough to declare a\nproduct, and `TASK_DECLARES_NO_PRODUCT` is the honest answer rather than a placeholder concept.\n| `RESOURCE_RELATIONSHIP` | `relationshipRef` + `sourceResourceRef` + `targetResourceRef` | a relationship-wiring task. Both endpoints, because the scaffold already declares each resource's own edges |\n| `RESOURCE_OPERATION` | `resourceRef` + `operationRef` | a custom operation |\n| `APPLICATION_VIEW` | `viewRef` | an app-level view |\n| `APPLICATION_DOCUMENT` | `documentRef` | a governed document the engine catalog DEFINES — see the closed list below. Never a document you name yourself |\n| `APPLICATION_MODULE` | `moduleRef` | an ensure-module task. The REGISTRY entry, not the directory |\n| `APPLICATION_FRONTEND_CONFIG` | `configSurface` + the `declarationRefs` the file gains | composing ONE app-wide config file — `NAVIGATION`, `DESIGN_SYSTEM`, `APP_SHELL`, `GLOBAL_VIEWS`. The DECLARATIONS (a sidebar section ref, a zone, a token), never the file: `wildo init` writes all four |\n| `RESOURCE_COMPOSITE_VIEW` | `resourceRef` + `viewRef` | a composite view of one resource, bound in its ui-behavior's `compositeViews` |\n| `RESOURCE_CUSTOM_VIEW` | `resourceRef` + `viewRef` | a custom operation view or an execution view of one resource, bound in its ui-behavior |\n| `RESOURCE_CHART_VIEW` | `resourceRef` + `chartRef` | a chart view declared under the resource's `chartViews` |\n| `CUSTOM_COMPONENT` | `componentRef` | a custom frontend component, registered on the module's frontend index or in the engine registrations |\n| `APPLICATION_MILESTONE` | `milestoneRef` | a milestone the module declares — the experience plan's identifier, as a slug |\n| `APPLICATION_GUIDANCE` | `guidanceKind` + `guidanceRef` | an onboarding document or guidance flow the module declares — the experience plan's `kind` and ref |\n| `PDF_TEMPLATE` | `resourceRef` + `templateRef` | a PDF template BOUND to a resource's generated-file field (`generatedSummaryPdf`) |\n| `APPLICATION_WORKER` | `workerRef` + the `jobRefs` its entry file declares | a worker's behaviour. The JOBS, not the package: `add-worker-node` / `add-worker-rust` write the package |\n| `APPLICATION_MINION` | `minionRef` + the `behaviorRefs` its entry file declares | a minion's tick behaviour. Same rule: `add-minion` writes the package |\n| `PROVIDER_BINDING` | `providerRef` + `scope` (`BACKEND`, `COMPANION`, `FRONTEND_APP`, `WEBSITE`) | one provider declared in one runtime owner's scope — the SaaS config block, or the service's `provider-contributions.ts` |\n| `WEBSITE_PAGE` | `pageRef` | a marketing page, registered in `website-root.config.ts` by its manifest |\n| `WEBSITE_SECTION` | `pageRef` + `sectionRef` | one section of one page, declared in `<pageRef>.sections.tsx` |\n| `DOCUMENTATION_CHAPTER` | `chapterRef` | the chapter's authored body, keyed by its `chapterRef` in `specifications/src/technical-documentation/index.ts`, which `wildo docs publish` joins to the documentation plan and publishes under `/guides/<slug>` |\n\n**A GOVERNED DOCUMENT is chosen from a closed list, never invented.** There are six,\nand a `documentRef` names one of them in exactly this form:\n\n```\ndocument:public.privacy-notice document:governance.program-handbook\ndocument:public.service-terms document:governance.scope-system-description\n document:governance.roles-responsibilities\n document:governance.document-record-control\n```\n\nA document is drafted against a BLUEPRINT — the required sections, the required\nfacts, the claim guards — and the blueprint is what the catalog holds. A ref outside\nthis list resolves to no blueprint, so the only thing a coding agent could do is\nINVENT the document's structure, which its authoring skill forbids. The task is then\nunbuildable by any run, and the dispatcher skips it by name rather than spending an\nagent turn rediscovering that.\n\nThis is not a hypothetical constraint. A plan authored against the previous wording\nof the row above — \"a notice, a governance statement\" — declared\n`gdpr-data-handling-governance` and `terminal-access-governance`: two plausible\ngovernance statements, neither of which names anything. Both sat permanently ready,\nand the one that was dispatched spent a full turn establishing that the document does\nnot exist. **If the obligation you have in mind is not on this list, it belongs in a\ndocument that IS** — GDPR data-handling scope, retention and subject rights are\n`document:public.privacy-notice`'s subject matter — or it is not a build task at all.\n\n**A cross-resource FOREIGN KEY belongs to the RELATIONSHIP task, never to the schema\ntask of the resource that holds it.** The domain plan makes the FK derivable — an\n`ownershipIntent` of SOURCE_HOLDS_REFERENCE on `contact-company` says contact carries\n`companyId` — and that is exactly why the mistake is easy: the field is derivable, so\nit is tempting to declare it on the schema task that will contain it. Step 2 below\nmakes the relationship task the SINGLE home for cross-resource wiring, and the\n`module-relationships` skill coordinates that FK across the owner's schema and config.\nDeclaring it in both places attributes one artifact to two tasks — the ambiguity\n`produces` exists to remove, reintroduced through the field that removes it. A schema\ntask's products are the resource's OWN domain fields.\n\nTwo further rules the graph enforces, so authoring against them saves a rejection:\n\n- **No two tasks may claim the same artifact.** That is what makes landing decidable.\n Two tasks may both enrich one resource's schema — it is the FIELDS that must not\n overlap, so split by field, never by prose.\n- **A `COMPANION_GENERATION_STEP` declares NO products.** Its landing is the\n generation step's own condition, computed by the companion. A product declared\n beside one is refused.\n\nProducts stay SEMANTIC. You name a resource, a field, a relationship, a view — never\na path and never a command, exactly as with `target`. The host alone turns a product\ninto a question about the working tree.\n\nThe contract itself, so the vocabulary below is read from the source rather than\nfrom this prose:\n\n## Import Origins\n\n- `@wildo-ai/saas-specifications`\n\n## Source Excerpts\n\n### Origin Package: `@wildo-ai/saas-specifications`\n\n```typescript\n *\n * Versioning for the build-plan task-graph payload format itself. `V1` —\n * initial shape (one ordered `tasks` collection with typed targets and\n * declared prerequisites). The shape grows additively across versions; the\n * `version` field is the explicit marker for consumers that branch on era.\n */\nexport enum BuildPlanTaskGraphVersion {\n V1 = 'v1',\n}\n\n/** Stable prefix every build-plan task ref carries; the trusted runtime stamps it, a provider supplies only the slug. */\nexport const BUILD_PLAN_TASK_REF_PREFIX = 'build-task-';\n\n/**\n * WHAT a build task builds — a closed vocabulary, because the host derives\n * the physical mutation scope and verification policy from the target kind\n * and the model must never author those powers through free text.\n */\nexport enum BuildPlanTaskTargetKind {\n /** A whole application module (its shared-lib registration, backend module and frontend module skeletons). */\n MODULE = 'MODULE',\n /** One build stage of one resource: schema → config → ui-behavior → spec. */\n RESOURCE_STAGE = 'RESOURCE_STAGE',\n /** One relationship between two resources. */\n RELATIONSHIP = 'RELATIONSHIP',\n /** A companion-owned deterministic generation step (labels, email templates, logo or database migrations) interleaved by the build loop, never a coding-agent run. */\n COMPANION_GENERATION_STEP = 'COMPANION_GENERATION_STEP',\n /**\n * Authoring one SHELL SURFACE's placement configuration from the accepted\n * placement plan — the settings rail, the sidebar, the user menu or the\n * command palette.\n *\n * Its own kind rather than a reuse of the neighbours, because none of them is\n * true of it: it is not a MODULE or a RESOURCE_STAGE (it is application-wide\n * and belongs to no resource), not a RELATIONSHIP, and emphatically not a\n * COMPANION_GENERATION_STEP — that kind is documented as \"never a coding-agent\n * run\" and writing `settings-hub.config.ts` is exactly a coding-agent run.\n * Borrowing one would hand the host the wrong mutation scope and the wrong\n * verification, which is what the closed vocabulary exists to prevent.\n */\n SHELL_PLACEMENT = 'SHELL_PLACEMENT',\n /*\n * THE NON-RESOURCE SURFACES (#1490). Until 2026-09-22 the five kinds above were the whole\n * vocabulary, and every one of them is about a resource or the shell placement of one. The\n * decompose method meanwhile told the planner to emit tasks for views, navigation, the design\n * system, custom components, PDF templates, workers, minions, providers, the website and the\n * documentation — surfaces the framework's own composition scenarios and 85 of its 111 skills\n * already build. A task for any of them had no kind to declare, so it either declared none\n * (landing as RAN-not-PROVEN forever) or borrowed `MODULE` with a product the module scope could\n * not prove. The members below are those surfaces, one per write scope the host can derive.\n */\n /**\n * The FRONTEND and SPECIFICATION layers of one module — its composite, custom and chart views,\n * its custom components and their specifications.\n *\n * Narrower than `MODULE` on purpose: a view task never touches `shared-lib` or `backend-api`, so\n * handing it the four-layer scope also hands it four typechecks and the FK sweep for a change\n * that can only break the frontend and the specifications package.\n */\n MODULE_FRONTEND = 'MODULE_FRONTEND',\n /**\n * The BACKEND layer of one module beside its shared-lib declarations — PDF templates and their\n * bindings, backend addons (services, controllers, flows-actors), email definitions.\n *\n * Shared-lib is in scope because a PDF template is bound to a resource FIELD the config declares\n * (`generatedSummaryPdf`), and a backend addon usually declares its contract there first.\n */\n MODULE_BACKEND = 'MODULE_BACKEND',\n /**\n * ONE application-wide frontend configuration surface — navigation, the design system, the app\n * shell's composition, the global views — named by {@link FrontendConfigSurface}.\n *\n * Distinct from {@link SHELL_PLACEMENT}, which authors the placement plan's decisions into the\n * shell files: a placement puts a decided subject in a decided group, while this kind COMPOSES\n * the surface itself (which sidebar sections exist, which transitions the primary zone uses,\n * which palette the product carries). Same file for `APP_SHELL`, different question.\n */\n APPLICATION_FRONTEND_CONFIG = 'APPLICATION_FRONTEND_CONFIG',\n /** The marketing website workspace (`website/`), composed by the `add-website` scenario. Pages and sections are its products. */\n WEBSITE = 'WEBSITE',\n /**\n * The technical-documentation workspace (`technical-doc/`) and the specification package's\n * `technical-documentation/` declarations that feed it. Its generated tree is never written by a\n * task: the companion publishes into it, and the coding policy prohibits it by prefix.\n */\n TECHNICAL_DOCUMENTATION = 'TECHNICAL_DOCUMENTATION',\n /** One worker package (`workers/<workerRef>/`), Node or Rust, plus its declaration in the SaaS config. */\n WORKER = 'WORKER',\n /** One cron minion package (`minions/<minionRef>/`) plus its declaration in the SaaS config. */\n MINION = 'MINION',\n /**\n * Declaring one provider in the application — the SaaS config's provider scopes, the backend\n * package dependency, the frontend provider module and its companion contribution.\n *\n * Application-wide by construction: a provider binding names no module, and the four files it\n * may touch are the same for every provider.\n */\n PROVIDER_BINDING = 'PROVIDER_BINDING',\n}\n\n/**\n * WHICH application-wide frontend configuration surface a task composes — one file each, in\n * `frontend/src/config/`, and the coding policy resolves the member to that file exactly as\n * `SHELL_PLACEMENT` resolves a `PlacementSurface`.\n *\n * Its own vocabulary rather than a reuse of `PlacementSurface`: a placement surface is WHERE a\n * subject sits in the shell (settings hub, sidebar, user menu, command palette), and three of\n * those live in one file. A configuration surface is WHICH FILE a composition task authors, and\n * navigation and the design system are not places anything is placed.\n */\nexport enum FrontendConfigSurface {\n /** `frontend/src/config/navigation.config.ts` — zones, transitions, overlay appearance. */\n NAVIGATION = 'NAVIGATION',\n /** `frontend/src/config/design-system.config.ts` — palette, typography, shell appearance from the brand's visual tone. */\n DESIGN_SYSTEM = 'DESIGN_SYSTEM',\n /** `frontend/src/config/app-shell.config.ts` — top bar, sidebar sections, quick switcher: the shell's COMPOSITION, not a placement into it. */\n APP_SHELL = 'APP_SHELL',\n /** `frontend/src/config/global-views.config.ts` — the application-level launcher and view registrations. */\n GLOBAL_VIEWS = 'GLOBAL_VIEWS',\n}\n\n/**\n * The two shapes of guidance an application gives a person, and the file each is declared in.\n *\n * They are distinct because they are found differently: an onboarding DOCUMENT is embedded in a\n * screen (`EmbedOnboarding`) and is there whenever that screen is, while a guidance FLOW is started\n * by an event and shows once. Both are listed on the owning frontend module — `onboardingViews` and\n * `guidanceFlows`. Each kind has a CONVENTIONAL definitions file, which the authoring skill teaches\n * and a landing probe reads for the declared ref (alongside the module's `index.ts`, where a small\n * module may declare inline). A convention for generated applications: a hand-authored application\n * may keep its declarations elsewhere, and then simply is not probed by a build plan.\n */\nexport enum ApplicationGuidanceKind {\n /** `frontend/src/modules/<m>/app-level-views/onboarding-views.definitions.ts` — an embedded onboarding document. */\n ONBOARDING_DOCUMENT = 'ONBOARDING_DOCUMENT',\n /** `frontend/src/modules/<m>/app-level-views/guidance-flows.definitions.ts` — a triggered guidance flow. */\n GUIDANCE_FLOW = 'GUIDANCE_FLOW',\n}\n\n/**\n * The two worker runtimes the framework composes (`add-worker-node`, `add-worker-rust`). The\n * runtime decides the entry file a landing probe reads and whether a typecheck exists to run: a\n * Node worker is verified by its package typecheck, a Rust worker has no TypeScript to check and\n * the policy says so rather than inventing a command.\n *\n * Not the SaaS config's `WorkerRuntime`, which is a free-form `{ type, language }` pair an\n * application authors for deployment; this is the closed set a creation run can COMPOSE.\n */\nexport enum BuildPlanWorkerRuntime {\n NODE = 'NODE',\n RUST = 'RUST',\n}\n\n/**\n * WHERE a provider is bound — which runtime owner's scope its declaration lands in. Each member\n * is a different file, so a probe and a write grant both derive from it.\n *\n * Named after the SaaS config's own scope keys (`providers.scopes.backend`, `.companion`,\n * `.frontendServices.app`, `.frontendServices.website`), which the `add-provider` and\n * `add-file-picker-provider` scenarios write. Minion and worker scopes are deliberately absent:\n * a provider reaching a minion is declared on that minion's own `providers` block and belongs to\n * the {@link BuildPlanTaskTargetKind.MINION} task that builds it.\n */\nexport enum ProviderBindingScope {\n BACKEND = 'BACKEND',\n COMPANION = 'COMPANION',\n FRONTEND_APP = 'FRONTEND_APP',\n WEBSITE = 'WEBSITE',\n}\n\n/** The per-resource build stages, in their fixed order. */\nexport enum BuildPlanResourceStage {\n SCHEMA = 'SCHEMA',\n CONFIG = 'CONFIG',\n UI_BEHAVIOR = 'UI_BEHAVIOR',\n SPEC = 'SPEC',\n}\n\nconst SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\n\n/**\n * The governed document a task produces, named as a COMPLIANCE-DOCUMENT CANDIDATE names it:\n * `document:<namespace>.<id>`, e.g. `document:public.privacy-notice`.\n *\n * **This field was `SlugSchema`, and a slug cannot name a governed document — so until 2026-09-16 no\n * build plan in any application could declare a document the engine catalog defines.** A slug forbids\n * the colon and the dot, the catalog's definitions are `document-definition:public.privacy-notice`,\n * and `selectAssuranceDocumentBlueprintForDocumentRef` joins the two namespaces by exact suffix — so\n * every authored `documentRef` resolved to NO blueprint, and a blueprint is what says which sections,\n * facts and claim guards the document owes. The two vocabularies were disjoint by construction.\n *\n * The cost is measured rather than theoretical. Wonder CRM's plan declares two such products\n * (`gdpr-data-handling-governance`, `terminal-access-governance`), neither of which names anything;\n * the first was dispatched, and its agent spent a full turn establishing — with a positive control —\n * that the document does not exist and could only be invented, which the authoring skill forbids.\n *\n * The bare slug is STILL ACCEPTED, and that is deliberate rather than tidiness left undone: tightening\n * this to the namespaced form alone would make every already-accepted plan carrying one fail to parse,\n * and a build plan that cannot be READ stops the whole lane — the gate\n * `application-creation-directive.md` forbids, for a task nobody can fix by re-running anything. A slug\n * simply resolves to no blueprint, so the dispatcher skips that task with a message naming the ref,\n * and the rest of the plan proceeds.\n */\nconst DocumentProductRefSchema = z.union([\n z.string().regex(/^document:[a-z0-9]+(?:-[a-z0-9]+)*\\.[a-z0-9]+(?:-[a-z0-9]+)*$/),\n SlugSchema,\n]);\n/**\n * A skill ref is the skill's FOLDER id in the app-knowledge catalog, which is\n * also its `SKILL.md` frontmatter `name` — one id, kebab-case. The host refuses\n * any skill name outside `[a-z0-9-]+`, so a ref that does not match this shape\n * can never resolve to an installed skill.\n */\nconst SkillRefSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nconst NonEmptyStringSchema = z.string().trim().min(1);\n\n/**\n * WHAT a build task PRODUCES — the artifact whose presence in the application\n * proves the task is done.\n *\n * **This is not `target`, and the difference is the whole reason it exists.**\n * `target` is a WRITE SCOPE: the host turns it into the path prefixes a run may\n * mutate, and several tasks legitimately share one. `produces` is a PRODUCT\n * IDENTITY: it says which artifact this task, and no other, is accountable for.\n *\n * Measured 2026-09-10 on Wonder CRM (issue #597): `build-task-pipeline-view`\n * and `build-task-deal-follow-through-operation` carry BYTE-IDENTICAL targets\n * (`{ kind: MODULE, moduleRef: 'deals' }`), and 7 of that plan's 42 tasks share\n * 3 targets. Landing had been answered by narrowing the target to a module\n * DIRECTORY — which `wildo compose` commits on day one, and which cannot tell\n * two tasks apart even in principle. The loop reported 40 of 42 tasks landed\n * while no coding task had ever run, so `dispatch-next` skipped every one of\n * them and the phase-advance gate read a build that was all but complete.\n *\n * Like `target`, this stays SEMANTIC: a product names a resource, a field, a\n * relationship or a view — never a path, and never a command. The host owns the\n * translation from a product to the physical question it asks of the working\n * tree, exactly as it owns the translation from a target kind to path prefixes.\n * A model that could author the path could author its own mutation scope.\n */\nexport enum BuildPlanTaskProductKind {\n /**\n * Named fields on one resource's schema.\n *\n * The shape an ENRICHMENT task needs, and the reason a product cannot always\n * be \"a file\": every resource file already exists, written by the scaffold\n * with its self-described STARTER shape, so file presence answers nothing.\n * The FIELDS are what the task adds.\n */\n RESOURCE_SCHEMA_FIELDS = 'RESOURCE_SCHEMA_FIELDS',\n /**\n * One resource's declared operations — its registry presence, named by the verbs it gains.\n *\n * The VERBS, not the config file: `<r>.resources-config.ts` is written by the scaffold, so its\n * existence is satisfied before any task runs. That is the exact shape of the defect this\n * vocabulary replaces, and a kind that reproduced it would be worse than no kind at all.\n */\n RESOURCE_REGISTRATION = 'RESOURCE_REGISTRATION',\n /** One resource's frontend ui-behavior. */\n RESOURCE_UI_BEHAVIOR = 'RESOURCE_UI_BEHAVIOR',\n /**\n * One resource's specification, named by the fields it documents.\n *\n * The FIELDS, for the same reason as {@link RESOURCE_REGISTRATION}: every resource is scaffolded\n * with a `*.resource.specification.ts` documenting only the starter shape, so file existence\n * proves nothing about the task that was meant to enrich it.\n */\n RESOURCE_SPECIFICATION = 'RESOURCE_SPECIFICATION',\n /** One relationship edge between two resources, named by the domain plan's `relationshipRef`. */\n RESOURCE_RELATIONSHIP = 'RESOURCE_RELATIONSHIP',\n /** One named custom operation on one resource. */\n RESOURCE_OPERATION = 'RESOURCE_OPERATION',\n /** One named application-level view. */\n APPLICATION_VIEW = 'APPLICATION_VIEW',\n /** One named governed application document (a compliance notice, a governance statement). */\n APPLICATION_DOCUMENT = 'APPLICATION_DOCUMENT',\n /** One application module, registered across the layer registries under one module identity. */\n APPLICATION_MODULE = 'APPLICATION_MODULE',\n /*\n * THE NON-RESOURCE PRODUCTS (#1490). Each names an artifact of a surface the five target kinds\n * above `MODULE_FRONTEND` could not express, and each is probed by the host from committed bytes —\n * a declaration in the one file that registers it, never a directory a scenario already wrote.\n */\n /**\n * Named declarations in ONE application-wide frontend configuration file — a sidebar section\n * ref the app shell gains, a zone the navigation config declares, a token the design system sets.\n *\n * The DECLARATIONS, never the file: every `frontend/src/config/*.config.ts` is written by\n * `wildo init`, so its presence is true before any task runs. Same reasoning as\n * {@link RESOURCE_SCHEMA_FIELDS}, one level up.\n */\n APPLICATION_FRONTEND_CONFIG = 'APPLICATION_FRONTEND_CONFIG',\n /**\n * One composite view of one resource — the cross-resource surface a resource's ui-behavior\n * declares under `compositeViews`. Distinct from {@link APPLICATION_VIEW}, which is\n * application-level and owned by a module rather than a resource.\n */\n RESOURCE_COMPOSITE_VIEW = 'RESOURCE_COMPOSITE_VIEW',\n /** One custom operation or execution view of one resource, bound in its ui-behavior. */\n RESOURCE_CUSTOM_VIEW = 'RESOURCE_CUSTOM_VIEW',\n /** One chart view of one resource, declared under its ui-behavior's `chartViews`. */\n RESOURCE_CHART_VIEW = 'RESOURCE_CHART_VIEW',\n /** One custom frontend component, registered by `componentRef` in the module's or the engine's registrations. */\n CUSTOM_COMPONENT = 'CUSTOM_COMPONENT',\n /**\n * One milestone a module declares — the moment the application recognises and celebrates.\n *\n * Named by its identifier, which is what the module's `milestones.ts` declares\n * (`first-project-created` is spelled `FIRST_PROJECT_CREATED` there). The module FILE is not the\n * product: a module may carry milestones before this task runs, and only the identifier says this\n * one landed.\n */\n APPLICATION_MILESTONE = 'APPLICATION_MILESTONE',\n /** One onboarding document or guidance flow a module declares, named by its ref. */\n APPLICATION_GUIDANCE = 'APPLICATION_GUIDANCE',\n /** One PDF template bound to one resource's generated-file field. */\n PDF_TEMPLATE = 'PDF_TEMPLATE',\n /**\n * One worker's JOBS — the named handlers its entry file declares.\n *\n * The jobs, not the package: `add-worker-node` writes the package, so its directory proves\n * nothing. What a coding task adds is behaviour, and behaviour is a symbol in the entry file.\n */\n APPLICATION_WORKER = 'APPLICATION_WORKER',\n /** One minion's BEHAVIOURS — the named tick handlers its entry file declares. Same reasoning as the worker. */\n APPLICATION_MINION = 'APPLICATION_MINION',\n /** One provider declared in one runtime owner's scope. */\n PROVIDER_BINDING = 'PROVIDER_BINDING',\n /** One website page, registered in the website root config by its manifest. */\n WEBSITE_PAGE = 'WEBSITE_PAGE',\n /** One section of one website page, declared in that page's sections file. */\n WEBSITE_SECTION = 'WEBSITE_SECTION',\n /**\n * One authored documentation chapter — a consumer guide the specifications package declares\n * for the documentation portal to publish (#874's publication input).\n */\n DOCUMENTATION_CHAPTER = 'DOCUMENTATION_CHAPTER',\n}\n\n/**\n * One artifact a task is accountable for. Closed by construction: a product the\n * host cannot ask a question about is a product that can never be shown to have\n * landed, so the vocabulary only grows alongside the resolver that answers it.\n */\nexport const BuildPlanTaskProductSchema = z.discriminatedUnion('kind', [\n z.strictObject({\n kind: z.literal(BuildPlanTaskProductKind.RESOURCE_SCHEMA_FIELDS).systemEnum('BuildPlanTaskProductKind'),\n resourceRef: SlugSchema,\n /**\n * At least one field, because a task that enriches a schema with nothing is\n * the vacuity this whole field exists to stop: it would land the moment the\n * scaffold existed, which is the defect being fixed.\n */\n fieldRefs: z.array(NonEmptyStringSchema).min(1),\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_REGISTRATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, operationRefs: z.array(NonEmptyStringSchema).min(1) }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_UI_BEHAVIOR).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_SPECIFICATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, fieldRefs: z.array(NonEmptyStringSchema).min(1) }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskProductKind.RESOURCE_RELATIONSHIP).systemEnum('BuildPlanTaskProductKind'),\n relationshipRef: SlugSchema,\n /*\n * The two resources the edge relates, NAMED rather than parsed out of the ref.\n *\n * A ref is `<source>-<target>` by convention and that convention is not invertible:\n * `next-step-deal` splits as (`next`, `step-deal`) or (`next-step`, `deal`) and only the domain\n * plan knows which. The domain plan already carries both, so the plan passes them on instead of\n * making the host guess — a host that guesses wrong probes for a resource that does not exist\n * and reports the task permanently unlanded.\n */\n sourceResourceRef: SlugSchema,\n targetResourceRef: SlugSchema,\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_OPERATION).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, operationRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_VIEW).systemEnum('BuildPlanTaskProductKind'), viewRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_DOCUMENT).systemEnum('BuildPlanTaskProductKind'), documentRef: DocumentProductRefSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MODULE).systemEnum('BuildPlanTaskProductKind'), moduleRef: SlugSchema }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskProductKind.APPLICATION_FRONTEND_CONFIG).systemEnum('BuildPlanTaskProductKind'),\n configSurface: z.enum(FrontendConfigSurface).systemEnum('FrontendConfigSurface'),\n /** At least one, for the same vacuity reason as a schema's `fieldRefs`: the file exists on day one. */\n declarationRefs: z.array(NonEmptyStringSchema).min(1),\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_COMPOSITE_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, viewRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_CUSTOM_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, viewRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.RESOURCE_CHART_VIEW).systemEnum('BuildPlanTaskProductKind'), resourceRef: SlugSchema, chartRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.CUSTOM_COMPONENT).systemEnum('BuildPlanTaskProductKind'), componentRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MILESTONE).systemEnum('BuildPlanTaskProductKind'), milestoneRef: SlugSchema }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskProductKind.APPLICATION_GUIDANCE).systemEnum('BuildPlanTaskProductKind'),\n /** Which definitions file carries it — a document and a flow live in different ones. */\n guidanceKind: z.enum(ApplicationGuidanceKind).systemEnum('ApplicationGuidanceKind'),\n guidanceRef: SlugSchema,\n }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskProductKind.PDF_TEMPLATE).systemEnum('BuildPlanTaskProductKind'),\n resourceRef: SlugSchema,\n /** The generated-file FIELD the template is bound to (`generatedSummaryPdf`) — a symbol, so any spelling. */\n templateRef: NonEmptyStringSchema,\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_WORKER).systemEnum('BuildPlanTaskProductKind'), workerRef: SlugSchema, jobRefs: z.array(NonEmptyStringSchema).min(1) }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.APPLICATION_MINION).systemEnum('BuildPlanTaskProductKind'), minionRef: SlugSchema, behaviorRefs: z.array(NonEmptyStringSchema).min(1) }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskProductKind.PROVIDER_BINDING).systemEnum('BuildPlanTaskProductKind'),\n providerRef: SlugSchema,\n scope: z.enum(ProviderBindingScope).systemEnum('ProviderBindingScope'),\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_PAGE).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.WEBSITE_SECTION).systemEnum('BuildPlanTaskProductKind'), pageRef: SlugSchema, sectionRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER).systemEnum('BuildPlanTaskProductKind'), chapterRef: SlugSchema }),\n]);\nexport type BuildPlanTaskProduct = z.infer<typeof BuildPlanTaskProductSchema>;\n\n/**\n * Every artifact identity a product claims — one string per artifact, not one\n * per product, because a product may claim several.\n *\n * `RESOURCE_SCHEMA_FIELDS` is why this returns a list. Two tasks may both enrich\n * one resource's schema (a domain shape and a billing concern, say), and that is\n * legitimate; what must never overlap is the FIELDS. Comparing whole products\n * would refuse the legitimate pair, and comparing only the resource would let two\n * tasks claim one field and make landing ambiguous again.\n *\n * Derived from the product's own members rather than stored, and total over the\n * vocabulary, so a kind added tomorrow must state its identity here or fail to\n * compile — it cannot be silently treated as equal to its siblings.\n */\nexport function buildPlanTaskProductIdentities(product: BuildPlanTaskProduct): readonly string[] {\n switch (product.kind) {\n case BuildPlanTaskProductKind.RESOURCE_SCHEMA_FIELDS:\n return product.fieldRefs.map((fieldRef) => `${product.kind}:${product.resourceRef}:${fieldRef}`);\n case BuildPlanTaskProductKind.RESOURCE_REGISTRATION:\n return product.operationRefs.map((operationRef) => `${product.kind}:${product.resourceRef}:${operationRef}`);\n case BuildPlanTaskProductKind.RESOURCE_SPECIFICATION:\n return product.fieldRefs.map((fieldRef) => `${product.kind}:${product.resourceRef}:${fieldRef}`);\n case BuildPlanTaskProductKind.RESOURCE_UI_BEHAVIOR:\n return [`${product.kind}:${product.resourceRef}`];\n case BuildPlanTaskProductKind.RESOURCE_RELATIONSHIP:\n return [`${product.kind}:${product.relationshipRef}`];\n case BuildPlanTaskProductKind.RESOURCE_OPERATION:\n return [`${product.kind}:${product.resourceRef}:${product.operationRef}`];\n case BuildPlanTaskProductKind.APPLICATION_VIEW:\n return [`${product.kind}:${product.viewRef}`];\n case BuildPlanTaskProductKind.APPLICATION_DOCUMENT:\n /*\n * The ref AS AUTHORED, so a slug and a namespaced ref are different artifact identities even\n * where they mean the same document — the duplicate-artifact refusal cannot see two tasks\n * claiming one document if they spell it differently. Not normalisable: a slug carries no\n * namespace, so nothing can recover `public.` from `privacy-notice`. It costs nothing today\n * because a slug names no catalogued document at all, and the dispatcher skips such a task.\n */\n return [`${product.kind}:${product.documentRef}`];\n case BuildPlanTaskProductKind.APPLICATION_MODULE:\n return [`${product.kind}:${product.moduleRef}`];\n // One identity per DECLARATION, like schema fields: two tasks may compose one config file as\n // long as they declare different things in it.\n case BuildPlanTaskProductKind.APPLICATION_FRONTEND_CONFIG:\n return product.declarationRefs.map((declarationRef) => `${product.kind}:${product.configSurface}:${declarationRef}`);\n case BuildPlanTaskProductKind.RESOURCE_COMPOSITE_VIEW:\n case BuildPlanTaskProductKind.RESOURCE_CUSTOM_VIEW:\n return [`${product.kind}:${product.resourceRef}:${product.viewRef}`];\n case BuildPlanTaskProductKind.RESOURCE_CHART_VIEW:\n return [`${product.kind}:${product.resourceRef}:${product.chartRef}`];\n case BuildPlanTaskProductKind.CUSTOM_COMPONENT:\n return [`${product.kind}:${product.componentRef}`];\n case BuildPlanTaskProductKind.APPLICATION_MILESTONE:\n return [`${product.kind}:${product.milestoneRef}`];\n // The ref alone: a document and a flow sharing one ref is still one guidance identity, and the\n // runtime keys a person's saved state by it — two artifacts claiming it would collide there too.\n case BuildPlanTaskProductKind.APPLICATION_GUIDANCE:\n return [`${product.kind}:${product.guidanceRef}`];\n case BuildPlanTaskProductKind.PDF_TEMPLATE:\n return [`${product.kind}:${product.resourceRef}:${product.templateRef}`];\n case BuildPlanTaskProductKind.APPLICATION_WORKER:\n return product.jobRefs.map((jobRef) => `${product.kind}:${product.workerRef}:${jobRef}`);\n case BuildPlanTaskProductKind.APPLICATION_MINION:\n return product.behaviorRefs.map((behaviorRef) => `${product.kind}:${product.minionRef}:${behaviorRef}`);\n // The SCOPE is part of the identity: one provider bound on the backend and on the website is two artifacts.\n case BuildPlanTaskProductKind.PROVIDER_BINDING:\n return [`${product.kind}:${product.scope}:${product.providerRef}`];\n case BuildPlanTaskProductKind.WEBSITE_PAGE:\n return [`${product.kind}:${product.pageRef}`];\n case BuildPlanTaskProductKind.WEBSITE_SECTION:\n return [`${product.kind}:${product.pageRef}:${product.sectionRef}`];\n case BuildPlanTaskProductKind.DOCUMENTATION_CHAPTER:\n return [`${product.kind}:${product.chapterRef}`];\n default: {\n const unhandled: never = product;\n throw new Error(`Unhandled build-plan task product ${JSON.stringify(unhandled)}.`);\n }\n }\n}\n\nexport const BuildPlanTaskTargetSchema = z.discriminatedUnion('kind', [\n z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE), moduleRef: SlugSchema }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.RESOURCE_STAGE),\n moduleRef: SlugSchema,\n resourceRef: SlugSchema,\n stage: z.enum(BuildPlanResourceStage),\n }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.RELATIONSHIP),\n moduleRef: SlugSchema,\n relationshipRef: SlugSchema,\n }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.COMPANION_GENERATION_STEP),\n /** The companion generation step this task runs (e.g. i18n-labels, email-templates); resolved by the companion, never by a coding agent. */\n generationStepRef: SlugSchema,\n }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.SHELL_PLACEMENT),\n /**\n * Which shell surface this task authors — the placement family's OWN\n * `PlacementSurface`, deliberately not a build-plan copy of it.\n *\n * A copy was written first and was a defect, caught by probing the landing\n * renderer rather than by any test: `PlacementAddress` discriminates on\n * `surface` with `z.literal(...)` per option, so only the VALUES survive into\n * the schema, and the renderer resolves a discriminator by matching that value\n * SET against the exported enums. Two enums with identical values made the\n * match ambiguous, the renderer correctly refused to guess an owner, and the\n * address discriminator became unnameable — a landed placement plan would have\n * emitted `surface: \"SETTINGS_HUB\"` as a bare string instead of\n * `PlacementSurface.SETTINGS_HUB`. One concept, one named source.\n */\n surface: z.enum(PlacementSurface).systemEnum('PlacementSurface'),\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE_FRONTEND), moduleRef: SlugSchema }),\n z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.MODULE_BACKEND), moduleRef: SlugSchema }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.APPLICATION_FRONTEND_CONFIG),\n configSurface: z.enum(FrontendConfigSurface).systemEnum('FrontendConfigSurface'),\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.WEBSITE) }),\n z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.TECHNICAL_DOCUMENTATION) }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.WORKER),\n /** The worker's directory under `workers/` and its key in the SaaS config, in slug form. */\n workerRef: SlugSchema,\n runtime: z.enum(BuildPlanWorkerRuntime).systemEnum('BuildPlanWorkerRuntime'),\n }),\n z.strictObject({\n kind: z.literal(BuildPlanTaskTargetKind.MINION),\n /** The minion's directory under `minions/` and its key in the SaaS config, in slug form. */\n minionRef: SlugSchema,\n }),\n z.strictObject({ kind: z.literal(BuildPlanTaskTargetKind.PROVIDER_BINDING), providerRef: SlugSchema }),\n]);\nexport type BuildPlanTaskTarget = z.infer<typeof BuildPlanTaskTargetSchema>;\n\n/**\n * One ordered build task. It names WHAT to build and WHY; it never carries\n * HOW (no paths, commands, prompts, cwd, model, profile). The host resolves\n * the physical allowed/prohibited paths and the fixed verification from the\n * target kind, and the installed skills from `skillRefs` against the app\n * knowledge catalog.\n *\n * Dependency readiness is DECLARED as prerequisite task refs and RESOLVED by\n * the host (a prerequisite is satisfied when its task has landed), never a\n * solved DAG the model must get right.\n */\nexport const BuildPlanTaskSchema = z.strictObject({\n /** `build-task-<slug>`, stamped by the trusted runtime. */\n taskRef: z.string().regex(new RegExp(`^${BUILD_PLAN_TASK_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),\n /**\n * One sentence of intent: what this task delivers.\n *\n * Its OWN instance, not the file's shared leaf, which `templateRef` and the product ref lists also\n * hold. A display decorator mutates the instance it is applied to, and the workbench gives those\n * refs a receding identifier look, which the objective sentence then took too.\n */\n objective: z.string().trim().min(1),\n target: BuildPlanTaskTargetSchema,\n /**\n * The artifacts this task is accountable for — what proves it done.\n *\n * Coding tasks should declare at least one product that composition did not already\n * write. A target is a shared mutation scope; its scaffolded file is not evidence\n * that this task's intended work exists. Products identify the output to probe.\n *\n * Empty declarations remain representable and produce the advisory\n * `TASK_DECLARES_NO_PRODUCT`. The host may advance after a COMPLETED durable run,\n * while naming the task in `unverifiableLandedTaskRefs`: it ran, but its output\n * cannot be proven from a product declaration. An unexecuted task is not landed.\n * This distinction avoids repeatedly dispatching the same unprovable task without\n * presenting execution history as evidence that the intended product is correct.\n *\n * The ONE hard exception is a `COMPANION_GENERATION_STEP`, which must declare NONE.\n * That kind already carries its own typed landed condition, owned by the\n * generation-step service — a set computed asynchronously (planner units x\n * enabled locales), and for the migration step a STATE rather than files. A\n * product declared beside it would be read by nothing, which is the inert\n * declaration this field exists to avoid. Enforced on the graph below, in both\n * directions.\n */\n produces: z.array(BuildPlanTaskProductSchema).default([]),\n /**\n * Exactly ONE functional topic this task belongs to.\n *\n * **It does NOT drive ordering** — this said \"drives cross-app ordering\" until 2026-08-30 and\n * nothing ever ordered by it. Sequencing is `prerequisiteTaskRefs`, resolved by the host, and it\n * is the only thing that decides what may run next.\n *\n * What it DOES: the dispatch host stamps it into the coding-agent's task payload beside\n * `skillRefs`, so the agent is told which phase of building the application this task belongs to.\n * That is context an LLM reads, not a value the runtime branches on — the distinction matters,\n * because a reader who believes it orders will look here for a scheduling bug that lives in the\n * prerequisite graph. See issue #124.\n */\n functionalTopic: z.enum(MetaWorkflow_FunctionalTopic).systemEnum('MetaWorkflow_FunctionalTopic'),\n /** Installed app-knowledge skill folders that carry the technical HOW; resolved via the skills router at dispatch. */\n skillRefs: z.array(SkillRefSchema).min(1),\n /** Task refs that must have landed first; resolved by the host, not solved by the model. */\n prerequisiteTaskRefs: z.array(z.string()).default([]),\n /**\n * What this task is accountable to — traceability only, NEVER scope authority.\n *\n * The vocabulary is the five aspects `BUILD_PLAN_FAMILY_ASPECTS` declares as targets: functional\n * and non-functional requirements, roadmap phases, and the vision's success criteria and\n * constraints. It reads \"Requirement / roadmap refs\" until 2026-09-11, and the last two were added\n * because the producer had been writing them all along (#629) — the generation contract asks for a\n * plain string list, so nothing here has ever refused a key.\n *\n * A key outside those five is not rejected and must not be: this is traceability a human or a\n * model wrote down, and dropping it loses the intent. The workbench renders such a key as visibly\n * unresolved instead, which is what makes a producer drift legible rather than silent.\n */\n servesRefs: z.array(NonEmptyStringSchema).default([]),\n});\nexport type BuildPlanTask = z.infer<typeof BuildPlanTaskSchema>;\n\n/**\n * THE build-plan payload — a **single aggregate per product**: the ORDERED\n * task graph that turns the accepted domain plan into buildable units.\n *\n * **Artifact-family id: `build-plan`.** This schema is the shape of the\n * journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===\n * 'build-plan'` (the `family` vocabulary stays an open string owned by the\n * selector surface; this note is the single place tying the SHAPE to the\n * NAME). Produced by the build-decompose playbook, consumed one task at a\n * time by build-dispatch (single-flight coding dispatch) and by the scale\n * playbook.\n *\n * Invariants enforced here: unique task refs; every prerequisite names a task\n * in this graph; no self-prerequisite. Cycle detection and ordering\n * soundness are the deterministic validator's job (`validateBuildPlanTaskGraph`).\n */\nexport const BuildPlanTaskGraphSchema = z.object({\n version: z.enum(BuildPlanTaskGraphVersion).default(BuildPlanTaskGraphVersion.V1),\n /**\n * At least one task, at the SCHEMA — not merely as a validator warning. The first live playbook-loop\n * run (2026-08-24) proved why: build-decompose answered `tasks: []`, which was schema-valid, passed\n * `_core` validation as a mere warning, and LANDED — overwriting a completed 3-task plan with a\n * vacuous artifact. Decomposing to zero tasks is a refusal (\"nothing to decompose\"), never an\n * artifact: an empty plan carries no information a reader could act on, and the file it replaces\n * does. Same vacuity class already closed on the requirements family (`functional: min(1)`).\n */\n tasks: z.array(BuildPlanTaskSchema).min(1),\n}).superRefine((graph, context) => {\n const refs = new Set<string>();\n graph.tasks.forEach((task, index) => {\n if (refs.has(task.taskRef)) {\n context.addIssue({ code: 'custom', message: `duplicate build task ref \"${task.taskRef}\"`, path: ['tasks', index, 'taskRef'] });\n }\n refs.add(task.taskRef);\n });\n /*\n * No two tasks claim the same artifact.\n *\n * This is what makes landing DECIDABLE, not a tidiness rule. If two tasks name\n * one product, the host cannot tell which of them a present artifact proves —\n * exactly the ambiguity that shared `target`s created, arriving through the\n * field that replaced them. Enforced here rather than left to the validator\n * because a graph that cannot answer \"has this task landed?\" is not a graph\n * the loop may run at all.\n */\n graph.tasks.forEach((task, index) => {\n const isGenerationStep = task.target.kind === BuildPlanTaskTargetKind.COMPANION_GENERATION_STEP;\n if (isGenerationStep && task.produces.length > 0) {\n context.addIssue({\n code: 'custom',\n message: `build task \"${task.taskRef}\" is a companion generation step and must declare no products; its landing is the generation step's own condition`,\n path: ['tasks', index, 'produces'],\n });\n }\n });\n const productOwners = new Map<string, string>();\n graph.tasks.forEach((task, index) => {\n task.produces.forEach((product, productIndex) => {\n buildPlanTaskProductIdentities(product).forEach((identity) => {\n const owner = productOwners.get(identity);\n if (owner !== undefined) {\n context.addIssue({\n code: 'custom',\n message: `build task \"${task.taskRef}\" claims the same artifact as \"${owner}\" (${identity}); an artifact is produced by exactly one task`,\n path: ['tasks', index, 'produces', productIndex],\n });\n return;\n }\n productOwners.set(identity, task.taskRef);\n });\n });\n });\n graph.tasks.forEach((task, index) => {\n task.prerequisiteTaskRefs.forEach((prerequisite, prerequisiteIndex) => {\n if (prerequisite === task.taskRef) {\n context.addIssue({ code: 'custom', message: `build task \"${task.taskRef}\" cannot be its own prerequisite`, path: ['tasks', index, 'prerequisiteTaskRefs', prerequisiteIndex] });\n } else if (!refs.has(prerequisite)) {\n context.addIssue({ code: 'custom', message: `build task \"${task.taskRef}\" names an unknown prerequisite \"${prerequisite}\"`, path: ['tasks', index, 'prerequisiteTaskRefs', prerequisiteIndex] });\n }\n });\n });\n});\nexport type BuildPlanTaskGraph = z.infer<typeof BuildPlanTaskGraphSchema>;\n```\n\n## The two ordering axes\n\nEvery task you emit is placed on **two ordering axes**. They are **distinct** — the\nper-resource sequence deliberately *spans* topics and is not monotonic on the topic\nchain — so keep them separate and satisfy both:\n\n1. **The topic dependency edges** (across the whole app — from the taxonomy's\n `Depends On`): `configure_application_foundation` → `model_domain_graph` →\n `define_interaction_semantics` → app-level `shape_user_experience` →\n `extend_application` → `connect_runtime_and_external_capabilities` →\n `assemble_verify_and_iterate`. You author neither the foundation nor the final\n assemble/verify — you decompose the middle bands (Topics 2–6). Topic 1 IS a sibling\n playbook (`bottom_up.foundation`), and Topic 7 IS one again\n (`bottom_up.assemble-verify`, rebuilt under issue #147 after its producer was removed\n with the verification/digest demolition). You still emit no Topic 7 task, and the reason\n is structural rather than a delegation: `BuildPlanTaskTargetKind` has no verification\n member, so app-wide verification cannot be expressed as a build-plan task at all — see\n the verify/quality-gate exclusion below. The edges you must respect: an\n operation task after the resources it acts on; an **app-level** view / navigation\n task after the interaction semantics and resources it composes; an extension after\n the UX it extends; an integration after the resources it connects.\n2. **The per-resource inner stage order** (within one resource):\n **schema → config → ui-behavior → spec.** This is a *dependency* sequence (each\n stage needs the prior artifact) and it deliberately **crosses topics**: schema +\n config are `model_domain_graph`, ui-behavior is `shape_user_experience`, and the\n spec is the `model_domain_graph` documentation capstone authored last. Two\n consequences to get right:\n - A resource's **own** ui-behavior (its field displays / forms) depends only on\n that resource's schema + config — so it may be ordered **before** cross-resource\n operations. That is **not** a topic-chain violation; only *app-level* UX\n (views / navigation composing multiple resources or operations) waits on the\n interaction-semantics band.\n - The **spec** task is a documentation capstone: order it **after** the stages it\n documents (schema, config, ui-behavior), regardless of its `model_domain_graph`\n topic binding. Its topic says *what* it documents; its ordering says *after what*.\n\n**Sequencing tiebreaker — MVP first.** The two axes constrain *relative* order but leave\nfreedom in which module to build first. Break that tie with the **roadmap** — but note the\nroadmap is requirement-addressed, not module-addressed: a phase delivers\n`deliversRequirementRefs` / `deliversSuccessCriterionRefs`, not modules. So trace each\nmodule's requirements to the earliest roadmap phase that delivers them, then sequence the\nmodules whose requirements land in an earlier phase (NOW / MVP) before those whose\nrequirements land later (NEXT / LATER), so a partial build is a coherent MVP slice rather\nthan a scattered half of every module. This is a soft ordering preference, not a hard\nprerequisite — never let it override the two hard axes above.\n\n## Step 1 — Emit the module + resource tasks (the domain-graph band)\n\nWalk the domain plan module by module. For each **module**, first check whether the\n**foundation step** (a sibling playbook) already scaffolded its slice — it normally has,\nbecause foundation materialises every module in the domain plan. Emit a module task only\nwhere that is not guaranteed; then, for each **resource** in that module's inventory,\nemit the ordered per-resource stage tasks:\n\n| Task | Functional topic | Skill (the HOW) |\n|---|---|---|\n| **(only when needed)** Ensure module `<id>` slice exists + is registered across runtimes — **normally already done by the foundation step**; emit this only for a module the foundation step did NOT establish (e.g. one added to the plan after foundation ran). Idempotent, never a blind re-scaffold | `model_domain_graph` | `resource-add-module` + `module-registration` |\n| Resource `<name>` — domain schema (fields, enums, structural decorators). **Workspace-aware**: when the resource already exists as a compose-born starter (see the workspace section), the objective names the DOMAIN content to add to it; only a resource the workspace does not list gets a skeleton-creation objective | `model_domain_graph` | `resource-add-resource` (skeleton, only when the resource does not exist yet) + `resource-schema-authoring` (the persisted shape) + `application-database-migrations` (**PostgreSQL applications only** — see below) |\n| Resource `<name>` — config (registry presence, core operation verbs, access / role scope — but NOT cross-resource relationships, which are the dedicated Step 2 tasks) | `model_domain_graph` | `resource-config-wiring` |\n| Resource `<name>` — ui-behavior (its read, form, summary and header surfaces and field chrome, each decided and stated — the resource's own UX) | `shape_user_experience` | `resource-ui-behavior` |\n| Resource `<name>` — spec (canonical business semantics — the per-resource documentation capstone) | `model_domain_graph` | `spec-resource-update` |\n\n> **Two things this table is careful about.** (a) **`ui-behavior` is `shape_user_experience`,\n> not interaction semantics** — a resource's field-display / form chrome is UX (Topic 4's\n> \"resource displays / forms\"); the resource's *operations* (custom verbs, access, scope) are a\n> SEPARATE interaction-semantics band, Step 3. (b) The **`spec` task is a documentation\n> capstone**: it documents the resource's fields (domain), operations (interaction), and frontend\n> (UX), so its single topic binding is `model_domain_graph` (the spec's canonical role is business\n> semantics), but its *ordering* is \"after the stages it documents\", not a topic-chain position —\n> see the ordering axes below. (c) **Module scaffolding + registration is the foundation\n> step's job** (a sibling playbook that materialises every domain-plan module). Do NOT emit a\n> module-scaffold or module-registration task for a module foundation already established — that\n> double-counts foundation. The build loop's domain-graph band is per-**resource**; only ensure a\n> module slice where foundation genuinely did not (e.g. a module added to the plan after\n> foundation ran).\n\n### The schema stage owes a migration on PostgreSQL\n\nThe workspace-truth section above ends with **\"Where this application STORES its data\"**, computed\nfrom the accepted schema plan and the authored store declaration. Read it, and follow what it says\nabout binding `application-database-migrations` to the schema stage.\n\nDo not try to find this out yourself. You have no shell and no file access: this method used to\ninstruct you to run `rg -n \"applicationDatabase\"`, which you could not do, and what you answered\ninstead was unanchored. If the section reports the store as UNKNOWN, say so in the plan and bind\nnothing — a wrong guess either way costs more than a stated gap.\n\n**Do not emit a separate coding task for the migration.** Generating one is deterministic work —\n`wildo db generate` writes it — so it is not a coding-agent objective at all. It is a\n`COMPANION_GENERATION_STEP`, and Step 4 below carries its slug.\n\nThe application-wide backstop is the assemble/verify playbook, whose check set includes\n`check:schema-plan-in-sync`. That gate catches a missed migration; it is not a licence to omit\nthe obligation here, because a build that fails at the capstone has already spent every task.\n\nRules for a buildable domain-graph band:\n\n- **Cover every module and every resource** in the inventory (both `mainResources`\n and `supportingResources`). A module or resource with no task is a coverage GAP (the\n build would not produce it).\n- **Not every resource needs every stage.** A `mainResource` (the entity the module is\n about) typically earns the full schema → config → ui-behavior → spec sequence. A\n `supportingResource` may not: a pure junction / lookup entity needs schema + config\n but no ui-behavior (it has no first-class UX surface). Emit the stages the resource\n genuinely needs, and say why a stage is omitted — do NOT pad every supporting\n resource with a UX task it will never use.\n- **Respect the per-resource stage order** (schema → config → ui-behavior → spec) through\n `prerequisiteTaskRefs` naming the actual predecessor task refs.\n This is checked, and it is a REFUSAL rather than a note: dispatch order is computed\n from the declared prerequisites and from nothing else, so a config task that names a\n schema task in the same plan without depending on it may be dispatched first — the\n agent would author a resources-config for a schema that has not landed. Declaring\n the edge indirectly is fine (config → module → schema); leaving it out is not.\n- **State objectives against workspace reality.** A task for a resource the workspace\n section already lists says what to ENRICH (\"author the deal-pipeline stage enum and\n amount/close-date fields the domain plan declares on `deals`\"), never \"create the\n `deals` resource\" — that file exists and a creation objective dispatches a no-op.\n `moduleRef` values come from the workspace section verbatim.\n- **Do not author fields or schemas here.** The task *names* the resource and its\n stage and points the coding agent at the skill; *what* fields the resource carries\n is resolved by the coding agent at dispatch time, from the domain plan + the skill.\n If you catch yourself writing a field list, stop — that is the coding agent's job.\n (Naming the domain CONCERN a stage must cover — \"the pipeline stages\", \"the follow-up\n reminder date\" — is objective-writing, not field authoring; listing concrete\n field-by-field types would be.)\n\n## Step 1b — Emit the shell-placement tasks (when a placement plan exists)\n\nThe **placement plan** decides WHERE every settings destination, resource operation\nand view sits in the shell, and why. It runs before you — it depends on the domain\nplan, not on your output, which is what keeps the two from forming a cycle. You do\nnot re-decide any of it; you turn it into buildable work.\n\nEmit **one task per SURFACE the plan actually places something on**, never one per\ndecision — the config files are per-surface, so a task per decision would have N\ntasks editing one file:\n\n| Task | Functional topic | Skill (the HOW) |\n|---|---|---|\n| Author the `<surface>` placement config from the accepted placement plan | `shape_user_experience` | `settings-placement-authoring` |\n\nAny task whose HOW includes **writing JSX for a bespoke surface** — a ui-behavior\nstage, a custom or composite view, an app-level screen — binds\n`frontend-component-catalog` alongside its own skill. It is what tells the coding\nagent which components the framework exports and how to spell their props; without\nit the agent builds the surface from raw `div`s and hand-written utility classes,\nbypassing the theme, the surface policy and the accessibility behaviour every\npreset carries. Do NOT bind it to a task that writes no markup (a schema stage, a\nconfig stage, a migration).\n\nRules:\n\n- **Target kind is `SHELL_PLACEMENT`, carrying the surface.** Not\n `COMPANION_GENERATION_STEP` — that kind is \"never a coding-agent run\" and this is\n one. The host derives the mutation scope from the kind, so borrowing a neighbour's\n gives the task the wrong permissions.\n- **A surface the plan places nothing on gets no task.** An empty settings rail is\n not something to author.\n- **Order after the resources and views a surface references.** Placing a resource's\n LIST in the sidebar before that resource exists is a task that cannot verify.\n- **Carry the decision, not the config.** The task names the surface and points at\n the skill; which category a destination lands in and in what order is IN the plan,\n read by the coding agent at dispatch. Do not restate placements in the objective.\n- **No placement plan? Emit nothing here and say so.** Do not invent placement — a\n guessed arrangement is exactly what the plan exists to replace, and it would be\n invisible to the reader who assumes a placement task came from a decision.\n\n## Step 2 — Emit the relationship-wiring tasks\n\nFor each **relationship-draft**, emit one wiring task:\n\n| Task | Functional topic | Skill (the HOW) |\n|---|---|---|\n| Wire relationship `<A> <-> <B>` (`<cardinality>`, `<owner>` holds the ref) | `model_domain_graph` | `module-relationships` |\n\nRules:\n\n- **This is the single home for cross-resource relationships.** A relationship is wired\n ONCE, here, by the `module-relationships` skill (which coordinates the FK across the\n owner's schema + config, the target's relationship map, and both specs coherently). Do\n NOT also wire it inside the per-resource config task in Step 1 — that config task\n establishes the resource's registry presence and core verbs, not its cross-resource\n FKs. Emitting the relationship in both places double-counts the work.\n- **Order after both endpoints' schema tasks.** A relationship-wiring task references\n two resources; both must have a schema task ordered before it (a relationship wired\n before an endpoint exists is a GAP).\n- **Carry the intent, not the resolution.** The task states the two ends, the\n cardinality intent, and the ownership direction from the relationship-draft. The\n cardinality-to-FK-holder resolution (discriminator / conditional relationships, the\n physical FK placement) is the `module-relationships` skill's job **at dispatch\n time**, not decided here.\n\n## Step 3 — Emit the interaction, UX, extension, and integration tasks\n\nOnce the domain graph is decomposed, emit the tasks for the later topic bands, drawn\nfrom the requirements + feature-drafts. Bind each task to **one** functional topic and\nto the skill(s) that carry its HOW, resolved from the **skills catalog your brief\ncarries** — every installed skill's name and what it does, under \"Application-knowledge\nskills\". Every skill name you emit MUST appear there, spelled exactly. Do **not** guess a\nskill name and do not recall one: a name that is not in that list addresses no skill\nfolder, and the task bound to it cannot be dispatched.\n\n**Every surface below has its own target kind and its own product kind. Use them.**\nUntil 2026-09-22 only resources had a vocabulary, so a task for any of these surfaces\neither declared no product (and could never be proven landed) or borrowed `MODULE`\nwith a product its scope could not prove. A task that squeezes a website page into a\n`MODULE` target, or declares a view with no product, is the defect this vocabulary\nreplaced — the judge reports it as a gap.\n\n- **`define_interaction_semantics`** — custom operations, lifecycle behaviour, access /\n role / scope rules, rate limits — interaction beyond the default resource verbs.\n Target `RESOURCE_STAGE` (CONFIG), product `RESOURCE_OPERATION`. Skills: the Backend and\n Resources domains of the router (`backend-custom-operation`, `rate-limit-authoring`,\n `authorization-unit-narrowing`).\n- **`shape_user_experience`** — the cross-resource UX, and you do NOT decide it here. The\n **experience plan** (`bottom_up.experience-plan`) already did: which surfaces exist, what\n each is for, which presets it reuses, and how the shell, navigation, design system and\n global views are composed. Read it and emit:\n - one task per VIEW, target `MODULE_FRONTEND` on the view's own module, product matching\n its kind (`RESOURCE_COMPOSITE_VIEW`, `RESOURCE_CUSTOM_VIEW`, `RESOURCE_CHART_VIEW`,\n `APPLICATION_VIEW`, `CUSTOM_COMPONENT`; an execution view is a `RESOURCE_CUSTOM_VIEW`\n product, which is what its file is), and its skill taken from the kind through\n `EXPERIENCE_VIEW_SKILL_REF`. Carry the view's `reusesComponentRefs` into the task's\n objective — the presets are the decision, and an objective that drops them hands the\n agent a blank surface;\n - one task per CONFIGURATION, target `APPLICATION_FRONTEND_CONFIG` with that surface,\n product `APPLICATION_FRONTEND_CONFIG` naming the surface's own `declarationRefs`, and\n its skill from `EXPERIENCE_CONFIGURATION_SKILL_REF`.\n - one task per planned MILESTONE, target `MODULE_BACKEND` on the milestone's module,\n product `APPLICATION_MILESTONE` naming its `milestoneRef`, skill\n `milestones-and-celebrations` (`EXPERIENCE_MILESTONE_SKILL_REF`). It depends on the config stage of its\n `triggerResourceRef` — the operation that earns it must exist before it can be counted.\n Carry the planned moment into the objective;\n - one task per planned piece of GUIDANCE, target `MODULE_FRONTEND` on its module, product\n `APPLICATION_GUIDANCE` naming its `guidanceKind` (the plan's `kind`) and `guidanceRef`,\n skill `guidance-onboarding-authoring` (`EXPERIENCE_GUIDANCE_SKILL_REF`, the same for both\n kinds). It depends on the milestone tasks its `gatedByMilestoneRefs` name, and on the\n resources whose operations it responds to. Carry the planned purpose and gate into the\n objective — the gate is what makes it appear at the right moment. For an\n `ONBOARDING_DOCUMENT`, also carry its `hostViewRef` — the objective must say which view\n embeds it with `EmbedOnboarding` (a view of the document's own module, so inside the task's\n scope) — and depend on that view's task when the plan builds it:\n landing proves the document is declared, not that anything shows it.\n Do not choose any of these skills yourself: every map is total over its vocabulary, which\n is what makes the view, configuration, milestone and guidance skills reachable. With no experience plan,\n emit nothing here — an improvised surface is the state this family replaced.\n (A placement DECIDED by the placement plan is Step 1b's `SHELL_PLACEMENT`, not this.)\n- **`extend_application`** — the controlled extension points where the declarative model\n is not enough:\n - a custom UI component / widget → target `MODULE_FRONTEND`, product `CUSTOM_COMPONENT`;\n skills `engine-component-registration`, `frontend-component-catalog`;\n - a PDF template / renderer → target `MODULE_BACKEND`, product `PDF_TEMPLATE`; skill\n `pdf-template-authoring`;\n - custom backend implementation logic → target `MODULE_BACKEND`, product the\n `RESOURCE_OPERATION` it serves; skill `backend-addon-wiring`;\n - workers and minions → you do NOT decide them here. The **integration plan**\n (`bottom_up.integration-plan`) already did: which surfaces run beside the backend, on\n which runtime, and exactly which resources a minion's tick may read and write. Read it\n and emit one task per WORKER (target `WORKER` with its `runtime`, product\n `APPLICATION_WORKER` naming its `jobRefs`, skill `worker-authoring` — both `NODE` and\n `RUST`, which is what `INTEGRATION_WORKER_SKILL_REF` holds) and one per MINION (target\n `MINION`, product `APPLICATION_MINION` naming its `behaviorRefs`, skill\n `minion-authoring`). Carry the minion's\n `readsResourceRefs` / `writesResourceRefs` into the task's objective: the whitelist\n starts DENY-ALL and an empty one keeps running, so an objective that drops them hands\n the agent a minion that looks healthy and touches nothing. The PACKAGE is composed by\n the foundation, one scenario per surface, so the task authors the BEHAVIOUR. With no\n integration plan, emit nothing here.\n- **`connect_runtime_and_external_capabilities`** — providers and external connectors,\n and the **integration plan** decided these too: one task per PROVIDER BINDING it\n declares, target `PROVIDER_BINDING`, product `PROVIDER_BINDING` with the binding's own\n `scope`, and its skill taken from that scope through\n `INTEGRATION_PROVIDER_BINDING_SKILL_REF` — do not choose it yourself, the map is total\n over the scope vocabulary. The binding's `rationale` is the task's objective. Reach for\n `provider-operation-calls` and `configure-billing` as the task's further reading when the\n binding is one an application then CALLS. Environment and infra config are the\n foundation's, not a build task's.\n- **The website** — target `WEBSITE`, and you do NOT decide its content here. The\n **website plan** (`bottom_up.website-plan`) already decided it: which pages, what each\n is for, and the sections that carry each page's argument in reading order. Read it and\n emit, in this order:\n - one `WEBSITE_PAGE` task per page (`produces: { kind: WEBSITE_PAGE, pageRef }`), skill\n `website-page-authoring`, its objective the page's own purpose;\n - one `WEBSITE_SECTION` task per section (`produces: { kind: WEBSITE_SECTION, pageRef,\n sectionRef }`), **with its page's task as a prerequisite** — a section is declared in\n its page's sections file, so the page must exist first — and its skill taken from the\n section's KIND through `WEBSITE_SECTION_SKILL_REF` (`HERO` →\n `website-section-hero`, `PRICING` → `website-section-pricing`, and so on). Do not\n choose that skill yourself: the map is total over the section vocabulary, which is what\n makes all nine section skills reachable.\n A plan whose disposition is `NOT_APPLICABLE`, or no plan at all, emits NOTHING here — the\n application has no `website/` workspace for a task to write in.\n- **Technical documentation** — target `TECHNICAL_DOCUMENTATION`, and you do not choose\n the chapters here either. The **documentation plan** (`bottom_up.documentation-plan`)\n decided them: read it and emit one task per chapter, product\n `DOCUMENTATION_CHAPTER` with its `chapterRef`, skill\n `application-consumer-documentation-authoring`, and an objective carrying the chapter's\n own purpose, audiences and the specifications it documents. A `NOT_APPLICABLE` plan, or\n none, emits nothing. The portal's generated tree is never written by a task — the\n target's own policy prohibits it, because the companion publishes there.\n\n## Posture constraints are work, not commentary\n\nThe vision family's compliance posture and constraints are INPUT on equal footing with the\nrequirements: an obligation the posture states — a retention/erasure rule over customer data, a\nterminal-access (cookie/telemetry) posture, an operational-vs-marketing email distinction — needs a\ntask that lands it, serving the nfr it substantiates. Do not compress a posture into an adjective\ninside another task's objective (\"GDPR-appropriate handling\"): an adjective is not schedulable,\nreviewable or landable. If the posture states an obligation and no task expresses it, the\ndecomposition is incomplete.\n\n(Label and email generation are companion-owned generation steps —\nsee Step 4 — not coding-agent extension tasks.)\n\nRules:\n\n- **Every task names a real topic + a real skill.** A task with an invented topic or a\n skill folder that does not exist is a GAP (the dispatch playbook would have nothing\n to run). Route through the declared `skill_catalog` context section of your brief; do not invent.\n- **Respect the topic dependency edges.** An operation task after the resources it acts\n on; an app-level view / navigation task after the interaction semantics **and** every\n resource it composes; an extension after the UX it extends; an integration after the\n resources it connects. (A resource's own field-display ui-behavior was already emitted\n in Step 1 and needs only that resource's schema/config — see the ordering axes.)\n- **Draw tasks from the definition set, not a blank page.** A UX or operation task\n earns its existence from a requirement or feature-draft; a task justified by nothing\n in the definition set is a CONCERN (speculative work).\n\n## Step 4 — Interleave the companion-owned generation steps\n\nSome build steps are **companion-owned deterministic generation**, not coding-agent\nwork. Emit these as tasks too — `target.kind: COMPANION_GENERATION_STEP` with\n`generationStepRef` set to the EXACT step slug below (the companion executes only this\nclosed vocabulary; any other slug refuses at dispatch) — and **order them after the\nsurfaces whose output they consume**:\n\n- **`i18n-labels`** — label generation + translation to every enabled locale. Order it\n after the resources / ui-behavior / views / milestones / guidance whose labels it\n generates — a milestone's title and a flow's words are generated from their declarations.\n- **`email-templates`** — email template + label generation and label translation.\n Order it after the notification/email surfaces it renders.\n- **`logo`** — the brand mark: an expert panel derives creative directions, marks are\n generated, a vision judge scores them, and the winner is promoted into the\n specifications brand SSOT. Author it only when the brand brief appears in your\n inputs (it is declared as a map: what the brand holds, not its content), and order\n it after that brief exists; it depends on no\n code surface, so it may run early and in parallel with resource work. Author it at\n most once — an application has one accepted mark, and the step skips itself without\n calling a model when one is already accepted.\n\n- **`database-migrations`** — `wildo db generate`: turns the drift the schema stages created into a\n committed migration, and advances the accepted plan with it. **PostgreSQL-backed applications\n ONLY** (`applicationDatabase: { engine: DatabaseEngine.POSTGRESQL }`); on MongoDB a collection\n appears on first write and this step must not be authored at all — it REFUSES on an application\n whose declared store is not PostgreSQL (or cannot be read), because generating there would author\n a table set nothing uses. A PostgreSQL application with no accepted plan yet is the opposite case:\n the step renders the whole model as the INITIAL migration and writes the baseline beside it, and\n the dispatch host derives that step itself when the plan omits it.\n\n Order it **after the schema stages whose drift it migrates** — practically, after the last\n resource's schema stage in the band. Author it ONCE: one step migrates all accumulated drift, and\n re-running it over a clean plan reports \"nothing to generate\" rather than writing an empty\n migration. It needs a BUILT `backend-api`, because the plan is computed by importing the compiled\n registry; it refuses on an unbuilt tree instead of authoring a migration for a model nobody has.\n\nSeed generation joins this vocabulary when its companion pipeline exists. Until then,\ndo **not** author a seeds generation step — an unknown `generationStepRef` refuses at\ndispatch instead of parking the build.\n\nYou **place** these steps in the order; you do **not** design how they run\nconcurrently with coding-agent tasks (that interleaving-at-scale concern is the scale\nplaybook's job — see the boundary below).\n\n## Refine, don't re-author\n\n- **Keep what still holds.** On a re-run, do not re-decompose modules or resources\n whose tasks are already correct. Only add a task, re-order where a prerequisite\n changed, or add/correct a relationship-wiring task where the domain plan genuinely\n changed.\n- **Reuse existing task refs.** A task that already exists keeps its ref — never mint a\n second ref for the same unit of work.\n- **Never orphan an ordering reference.** A task's prerequisite reference must name a\n task that is actually in the plan. If you remove or rename a task, follow it into\n every prerequisite reference.\n\n## Validation and product review\n\n`BuildPlanTaskGraphGeneration` constrains the generated shape. The runtime normalizes\nit into `BuildPlanTaskGraph` and runs `validateBuildPlanTaskGraph`. Cycles and missing\nrequired prerequisite edges between stages present in the graph are hard failures;\na stage absent from the graph and a coding task without products produce warnings.\nSchema checks also reject unknown prerequisite refs and duplicate product ownership.\n\nThe `build-plan-coherent` checklist below complements those structural checks with\nproduct review: resource coverage, useful objectives, meaningful products and suitable\nmethods. Since 2026-09-22 it is also this playbook's compiled evaluation treatment: the\nADVISORY judge reads its invariants against the landed build plan and the domain plan\nafter every run, and its per-criterion verdicts reach the creator's review. A verdict is\na note, never a refusal. The method declares `approve_result`; neither shape validation,\nthe judge nor approval proves the application behavior that the plan intends to deliver.\n\n## Decomposition boundary\n\nKeep this playbook at decomposition depth. Explicitly **out of scope here**:\n\n- **Dispatch execution.** You do NOT dispatch any task, spawn any coding agent, build a\n context pack, or run the coding-agent contract. That is the **dispatch-orchestration**\n playbook, downstream of this decomposition.\n- **Workspace-mutation safety.** Single-flight locking, clean-worktree preconditions,\n change-set capture (git baseline / diff), and the failure-policy revert/flag mechanics\n are the dispatch playbook's concern — NOT modelled here. A task that describes *how* it\n is captured or locked is out of this playbook's depth.\n- **Verify / quality-gate mechanics.** Running typecheck, validators, tests, or reviewer\n agents *around* a dispatched task is the dispatch playbook's verify step — you do not model it.\n The app-wide assemble / verify phase (Topic 7) you also do not emit, and the reason is\n STRUCTURAL rather than delegation: a build-plan task's `target.kind` is one of `MODULE`,\n `RESOURCE_STAGE`, `RELATIONSHIP`, `SHELL_PLACEMENT` or `COMPANION_GENERATION_STEP`, and none of them can express\n \"verify the assembled application\". There is no vocabulary for it, so a task claiming to do it\n would be a task no executor could run.\n The `bottom_up.assemble-verify` method owns application-wide verification.\n Keep its work separate from the build targets decomposed here.\n- **Multi-agent scale + interleaving.** Parallelising tasks across multiple coding\n agents, and interleaving the companion generation steps concurrently with coding-agent\n runs, is the **scale** playbook. You produce a linear-enough ordered graph with explicit\n `prerequisiteTaskRefs`; you do NOT solve the concurrency schedule.\n- **Schema / field authoring + code generation.** You name resources and stages; you do\n NOT author fields, enums, decorators, Zod schemas, or any code, and you do NOT resolve\n a cardinality intent into a concrete FK. That is the coding agent at dispatch time.\n- **Framework contract design.** Use the existing `BuildPlanTaskGraph` schema and\n validator. This method authors an application plan; it does not reshape the\n framework's `_core` contracts or implement a new scheduling engine.\n\nKeep the output at decomposition depth. The dispatch and verification methods consume\nit and perform their own work; a task graph is not evidence that those runs succeeded.\n\n## What you emit\n\nOne artifact for this journey:\n\n- The **build-plan** at `specifications/src/build-plan/index.ts` — an ordered task\n graph: the per-resource (schema / config / ui-behavior / spec) tasks, the\n relationship-wiring tasks, the interaction / UX / extension / integration tasks (views,\n frontend configuration, components, PDF templates, workers, minions, provider bindings,\n website pages and sections, documentation chapters — each over its own target and\n product kind), any module-ensure tasks foundation did not cover, and the interleaved\n companion-generation steps — each carrying its target, **the artifacts it produces**,\n its one functional topic, its skill(s), and explicit `prerequisiteTaskRefs`.\n\nThe creator reviews the result (approval posture `approve_result`) before it is accepted\nas the journey's build plan, which the dispatch-orchestration and scale playbooks then\nturn into dispatched, verified coding-agent runs.\n\n## References\n\nThese are skill FOLDERS installed in the application, named so each piece of work has an\nauthoring contract a later coding agent can open. This step has no tools and does not open them;\nwhat reaches you is this method, your declared inputs, and the brief's own sections.\n\n- `journey-status` — read the current journey state and scope,\n and confirm the approved domain plan is in place to decompose the build from.\n- `resource-add-module` — the module-scaffolding vocabulary, for\n the conditional ensure-module task (only where the foundation step did not establish the\n module slice).\n- `resource-add-resource` — the resource vocabulary (the\n resource-skeleton task in the schema stage).\n- `resource-schema-authoring` — the schema stage (first\n per-resource task).\n- `resource-config-wiring` — the config stage (second\n per-resource task).\n- `resource-ui-behavior` — the ui-behavior stage (third\n per-resource task).\n- `spec-resource-update` — the spec stage (fourth per-resource\n task).\n- `module-relationships` — the relationship-wiring task's HOW\n (cardinality-to-FK-holder resolution, at dispatch time — named here, not performed).\n- `module-registration` — the cross-runtime module-registration\n task's HOW.\n- the skills CATALOG, which your brief carries as its own section — the skills router: consult it to bind each interaction /\n UX / extension / integration task to its real skill folder from the full catalog. Do\n not invent skill names; route through the index.\n\n## Reviewer checklist — `build-plan-coherent`\n\nThese eight invariants are the criteria of this playbook's compiled evaluation treatment (`application-creation:evaluation-treatment/build-plan-coherent`, one criterion per invariant, invariants 2 and 2b sharing one), which the advisory judge runs after every landing. They are kept here as creator-facing review guidance too, so a reviewer and the judge read the same words:\n\nJudge whether the drafted build plan is a coherent, complete, correctly-ordered decomposition of the approved domain plan into coding-agent tasks — WITHOUT straying into how those tasks execute. Assess eight invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) MODULE + RESOURCE COVERAGE — every resource in every module's inventory (mainResources + supportingResources) has build tasks; a resource with no task is a GAP (the build would not produce it). Task `moduleRef` values must be module ids the workspace section lists (an invented module id is a GAP — the dispatcher cannot route it), and a task whose objective CREATES a resource the workspace section shows already exists — instead of enriching it — is a CONCERN (it dispatches a no-op). Module slices are scaffolded by the foundation step (a sibling playbook), so a module needs a dedicated ensure-module task ONLY where foundation did not establish it — a module whose resources have tasks but which carries no redundant scaffold task is NOT a GAP (do not flag the absence of a module-scaffold task foundation already owns); a module added to the plan after foundation with neither a foundation slice nor an ensure-module task IS a GAP. (2) TASK WELL-FORMEDNESS — every task names exactly ONE functional topic that is a real MetaWorkflow_FunctionalTopic value (configure_application_foundation / model_domain_graph / define_interaction_semantics / shape_user_experience / extend_application / connect_runtime_and_external_capabilities / assemble_verify_and_iterate) and at least one skill that is a real folder in the app-knowledge skill catalog; a task with an invented topic or a dangling skill is a GAP. (2b) PRODUCT DECLARATION — every task except a COMPANION_GENERATION_STEP declares at least one product in `produces`, and a generation step declares none; a coding task with an empty `produces` is a GAP, because it has no declared output to probe. The host can advance after a COMPLETED durable run, but carries the task in `unverifiableLandedTaskRefs`; that means ran, not proven. Repair the product declaration rather than treating this fallback as evidence of correct output. A product must name something COMPOSITION DOES NOT ALREADY WRITE — the fields a schema gains rather than its file, the verbs a config gains rather than its file, both endpoints of a relationship rather than one — so a product naming only a scaffolded artifact is a GAP wearing a declaration. Two tasks claiming the SAME artifact is a GAP as well (landing becomes undecidable); two tasks enriching one resource with DIFFERENT fields is correct and not a finding. A cross-resource FOREIGN KEY declared on a schema task's `produces` is a GAP — the relationship task is its single home (Step 2), and declaring it twice attributes one artifact to two tasks; a schema task's products are the resource's OWN domain fields. (3) PER-RESOURCE STAGE ORDER — for each resource, its tasks respect the inner order schema -> config -> ui-behavior -> spec; a config task ordered before that resource's schema task, or a spec task before its ui-behavior task, is a GAP (the build stage would run against a missing prerequisite). A supportingResource (e.g. a pure junction / lookup entity) may legitimately OMIT stages it does not need — a junction with schema + config and no ui-behavior is fine; only an out-of-ORDER stage (or a mainResource missing schema/config) is a GAP, not an intentionally-omitted stage on a supporting resource. (4) TOPIC DEPENDENCY ORDER — tasks respect the topic dependency edges (model_domain_graph before define_interaction_semantics; app-level shape_user_experience [views / navigation composing multiple resources or operations] after the interaction semantics and resources it composes; extend_application after the UX it extends; connect_runtime_and_external_capabilities after the resources it connects). Note the deliberate exception: a resource's OWN ui-behavior (its field displays / forms, a shape_user_experience task) depends only on that resource's own schema + config and MAY precede cross-resource operations — that is NOT a violation. What IS a GAP: an app-level view composing resources/operations placed before they exist, an integration task before the resources it connects, or any user-experience task before that resource's schema task. The per-resource spec task is a documentation capstone (topic model_domain_graph) and must be ordered after the schema / config / ui-behavior stages it documents; a spec task before its ui-behavior stage is a GAP. (5) RELATIONSHIP COVERAGE — every relationship-draft has a wiring task (bound to the module-relationships skill) ordered AFTER both endpoint resources' schema tasks; a relationship with no wiring task, or one ordered before its endpoints exist, is a GAP. (6) COMPANION-GENERATION INTERLEAVE — the executable companion-owned generation steps (`i18n-labels`, `email-templates`, `logo`, plus `database-migrations` for a PostgreSQL-backed application) are present and placed AFTER the resources / modules whose output they consume; a labels-generation task ordered before the resources it labels, or a missing executable generation step for authored surfaces, is a CONCERN. `logo` is the exception to the ordering half — it consumes the brand brief rather than any code surface, so it is unordered with respect to resource work and only its ABSENCE (on an application with a brand brief) is a CONCERN. The migration step follows the schema stages whose drift it migrates and is not authored for MongoDB. Do NOT flag the absence of a seeds step — seed generation has no companion pipeline yet and must not be authored. (7) BOUNDARY DISCIPLINE — the plan stays at DECOMPOSITION depth: it names tasks, their topic, their skill(s), their target, and their ordering intent; it does NOT specify how a task is DISPATCHED (single-flight locking, change-set capture, git baseline, verify/quality-gate mechanics = the dispatch-orchestration playbook) and does NOT solve multi-agent SCALE or interleaving concurrency (= the scale playbook). Any task that describes how a task EXECUTES rather than WHAT it builds, or that authors a schema / resolves a cardinality into a concrete FK / generates code, is a CONCERN (scope creep out of the decomposition phase). (The deterministic gates and the creator's approval remain the floors; the judge's verdicts are advisory notes beside them.)\n",
43
69
  "skillRefs": [
44
70
  "journey-status",
45
71
  "resource-add-module",
@@ -47,13 +73,23 @@
47
73
  "resource-schema-authoring",
48
74
  "resource-config-wiring",
49
75
  "resource-ui-behavior",
76
+ "frontend-component-catalog",
50
77
  "spec-resource-update",
51
78
  "module-relationships",
52
- "module-registration"
53
- ]
79
+ "module-registration",
80
+ "application-database-migrations"
81
+ ],
82
+ "skillBodyRefs": [],
83
+ "contextSources": [
84
+ "workspace_truth",
85
+ "skill_catalog"
86
+ ],
87
+ "draftableDocumentDefinitionRefs": [],
88
+ "suspendsForClarification": false,
89
+ "briefAdequacyGate": false,
90
+ "briefAdequacyExcludedSources": []
54
91
  },
55
92
  "executor": "companion_agent",
56
- "qualityGates": [],
57
93
  "approval": "approve_result",
58
94
  "budget": {
59
95
  "maxRuns": 3
@@ -1 +1 @@
1
- {"aggregationPolicyRef":"application-creation:aggregation/worst-build-task-dispatch-verdict","aggregationStrategy":"WORST_VERDICT_PRECEDENCE_V1","criteria":[{"criterionRef":"application-creation:criterion/build-task-accomplished-in-scope","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1}],"instruction":"Assess whether the attributed change-set actually implements the dispatched task's target and stage (a schema task adds the persisted shape, a ui-behavior task adds field displays, a spec task documents the resource), stays within the task's module/resource/stage, and is cleanly attributable to the run (RUN_EXCLUSIVE / APPEARED_DURING_RUN). Files that were already dirty at the dispatch baseline are review-required and must not be counted against the run. Do not re-decompose the plan, do not author code yourself, and do not reward edits sprawling into unrelated modules.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The task is advanced but the change-set sprawls beyond its module/resource/stage or its attribution is partly ambiguous.","GAP":"The change-set does not advance the dispatched target, or is empty on a task that should have authored files.","INDETERMINATE":"The dispatched task or its change-set cannot be identified from the evidence.","PASS":"The change-set advances exactly the dispatched target/stage, inside its scope, with clean attribution."}},{"criterionRef":"application-creation:criterion/build-task-verified-change-set","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2}],"instruction":"Verify the sealed worktree change-set evidence of the dispatched build task. PASS only when the coding host recorded a working result, the mutation-scope assessment allowed every attributed path, and every required verification check succeeded. Never infer verification from the agent's own narrative, and never treat an absent change-set as a passed task.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The gate passed, but the evidence shows a verification check the reviewer cannot independently confirm.","GAP":"No change-set was recorded, the run failed, a path escaped the mutation scope, or a required verification check failed.","INDETERMINATE":"The change-set evidence is absent, malformed or does not bind the dispatched task.","PASS":"A working result was recorded, the change-set stayed inside the declared mutation scope and the verification gate passed."}}],"promptAssemblyStrategy":"CANONICAL_PROTOCOL_EVIDENCE_V1","protocolRef":"application-creation:evaluation-protocol/build-task-dispatch","protocolVersion":1,"provenance":{"compilerRef":"meta-workflow:compiler/evaluation-treatment","compilerVersion":1,"sourcePlaybookRef":"playbook:bottom_up.build-dispatch"},"schemaVersion":1,"verdictPrecedence":["GAP","INDETERMINATE","CONCERN","PASS"]}
1
+ {"aggregationPolicyRef":"application-creation:aggregation/worst-build-task-dispatch-verdict","aggregationStrategy":"WORST_VERDICT_PRECEDENCE_V1","criteria":[{"criterionRef":"application-creation:criterion/build-task-accomplished-in-scope","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1}],"instruction":"Assess whether the attributed change-set actually implements the dispatched task's target and stage (a schema task adds the persisted shape, a ui-behavior task adds field displays, a spec task documents the resource), stays within the task's module/resource/stage, and is cleanly attributable to the run (RUN_EXCLUSIVE / APPEARED_DURING_RUN). Files that were already dirty at the dispatch baseline are review-required and must not be counted against the run. Do not re-decompose the plan, do not author code yourself, and do not reward edits sprawling into unrelated modules.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The task is advanced but the change-set sprawls beyond its module/resource/stage or its attribution is partly ambiguous.","GAP":"The change-set does not advance the dispatched target, or is empty on a task that should have authored files.","INDETERMINATE":"The dispatched task or its change-set cannot be identified from the evidence.","PASS":"The change-set advances exactly the dispatched target/stage, inside its scope, with clean attribution."}},{"criterionRef":"application-creation:criterion/build-task-verified-change-set","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2}],"instruction":"Verify the sealed worktree change-set evidence of the dispatched build task. PASS only when the coding host recorded a working result, every required verification check succeeded, and every changed path outside the declared scope (`outOfScopePaths`, which may include a parallel session's edits) is accounted for; an unresolved out-of-scope path is a CONCERN, not an absence of evidence. Never infer verification from the agent's own narrative, and never treat an absent change-set as a passed task.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The gate passed, but the evidence shows a verification check the reviewer cannot independently confirm, or the result records out-of-scope paths (`outOfScopePaths`) whose authorship is unresolved — the change set cannot tell the run's edits from a parallel session's.","GAP":"No change-set was recorded, the run failed, or a required verification check failed.","INDETERMINATE":"The change-set evidence is absent, malformed or does not bind the dispatched task.","PASS":"A working result was recorded, the verification gate passed, and every changed path outside the declared mutation scope is accounted for."}}],"promptAssemblyStrategy":"CANONICAL_PROTOCOL_EVIDENCE_V1","protocolRef":"application-creation:evaluation-protocol/build-task-dispatch","protocolVersion":1,"provenance":{"compilerRef":"meta-workflow:compiler/evaluation-treatment","compilerVersion":1,"sourcePlaybookRef":"playbook:bottom_up.build-dispatch"},"schemaVersion":1,"verdictPrecedence":["GAP","INDETERMINATE","CONCERN","PASS"]}
@@ -1 +1 @@
1
- {"authorityRequirement":{"admittedChannels":["INTERFACE_RELAY"],"assurancePolicyRef":"application-creation:authority-policy/local-single-operator","channelPolicyRef":"application-creation:authority-policy/interface-relay","consequenceClassRef":"application-creation:authority-consequence/accept-build-task-change-set","decisionModePolicyRef":"application-creation:authority-policy/explicit-operator-confirmation","expiryPolicyRef":"application-creation:authority-expiry/current-interface-session","hardFloorOverrideAllowed":false,"hardFloorPosture":"NON_WAIVABLE","minimumAssurance":"LOCAL_OS_SESSION","noncePolicyRef":"application-creation:authority-nonce/random-per-request","principalPolicyRef":null,"requiredDecisionMode":"EXPLICIT_OPERATOR_CONFIRMATION","requiredEvidenceRequirementRefs":["application-creation:evidence-requirement/build-task-verified-change-set","application-creation:evidence-requirement/build-task-serves-requirements"],"requirementRef":"application-creation:authority-requirement/build-task-dispatch-result","requirementVersion":1,"riskClassRef":"application-creation:risk/application-worktree-horizon-acceptance","schemaVersion":1},"continuationPolicy":{"fallbackAction":"BLOCK","mappings":[{"action":"CONTINUE","decisionConsequence":"CONTINUE"},{"action":"REVISE","decisionConsequence":"REVISE"},{"action":"REQUEST_EVIDENCE","decisionConsequence":"REQUEST_EVIDENCE"},{"action":"REQUEST_AUTHORITY","decisionConsequence":"REQUEST_AUTHORITY"},{"action":"BLOCK","decisionConsequence":"BLOCK"}],"maximumAuthorityReviews":1,"maximumEvidenceRequests":2,"maximumRevisionAttempts":3,"policyRef":"application-creation:continuation-policy/build-task-dispatch","policyVersion":1,"schemaVersion":1},"decisionPointDefinition":{"authorityRequirement":{"requirementRef":"application-creation:authority-requirement/build-task-dispatch-result","requirementVersion":1},"continuationPolicy":{"policyRef":"application-creation:continuation-policy/build-task-dispatch","policyVersion":1},"decisionPointRef":"application-creation:decision-point/build-task-dispatch","decisionPointVersion":1,"decisionRule":{"ruleRef":"application-creation:decision-rule/build-task-dispatch","ruleVersion":1},"evaluatorBindingPolicy":{"policyRef":"application-creation:evaluator-binding-policy/build-task-dispatch","policyVersion":1},"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1},{"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2}],"hardFloorRefs":["application-creation:hard-floor/build-task-verified-change-set"],"riskPolicyRef":"application-creation:risk-policy/scoped-application-and-execution-context","schemaVersion":1,"significancePolicyRef":"application-creation:significance-policy/application-worktree-change","triggerRefs":["application-creation:trigger/build-task-change-set-recorded"]},"decisionRule":{"boundaryClass":"QUALITY_INTERPRETATION","evaluatorFailureConsequence":"BLOCK","evidenceAggregationRef":"application-creation:aggregation/worst-build-task-dispatch-verdict","hardFloorBindings":[{"evidenceRequirementRefs":["application-creation:evidence-requirement/build-task-verified-change-set"],"hardFloorRef":"application-creation:hard-floor/build-task-verified-change-set"}],"hardFloorFailureConsequence":"BLOCK","hardFloorShortcutAllowed":false,"resultMappings":[{"consequence":"REQUEST_AUTHORITY","verdict":"PASS"},{"consequence":"REVISE","verdict":"CONCERN"},{"consequence":"REVISE","verdict":"GAP"},{"consequence":"REQUEST_EVIDENCE","verdict":"INDETERMINATE"}],"ruleRef":"application-creation:decision-rule/build-task-dispatch","ruleVersion":1,"schemaVersion":1,"unresolvedConsequence":"REQUEST_EVIDENCE"},"definitionRef":"application-creation:evaluation-treatment/build-task-dispatch","definitionVersion":2,"evaluationProtocol":{"aggregationPolicyRef":"application-creation:aggregation/worst-build-task-dispatch-verdict","aggregationStrategy":"WORST_VERDICT_PRECEDENCE_V1","criteria":[{"criterionRef":"application-creation:criterion/build-task-accomplished-in-scope","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1}],"instruction":"Assess whether the attributed change-set actually implements the dispatched task's target and stage (a schema task adds the persisted shape, a ui-behavior task adds field displays, a spec task documents the resource), stays within the task's module/resource/stage, and is cleanly attributable to the run (RUN_EXCLUSIVE / APPEARED_DURING_RUN). Files that were already dirty at the dispatch baseline are review-required and must not be counted against the run. Do not re-decompose the plan, do not author code yourself, and do not reward edits sprawling into unrelated modules.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The task is advanced but the change-set sprawls beyond its module/resource/stage or its attribution is partly ambiguous.","GAP":"The change-set does not advance the dispatched target, or is empty on a task that should have authored files.","INDETERMINATE":"The dispatched task or its change-set cannot be identified from the evidence.","PASS":"The change-set advances exactly the dispatched target/stage, inside its scope, with clean attribution."}},{"criterionRef":"application-creation:criterion/build-task-verified-change-set","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2}],"instruction":"Verify the sealed worktree change-set evidence of the dispatched build task. PASS only when the coding host recorded a working result, the mutation-scope assessment allowed every attributed path, and every required verification check succeeded. Never infer verification from the agent's own narrative, and never treat an absent change-set as a passed task.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The gate passed, but the evidence shows a verification check the reviewer cannot independently confirm.","GAP":"No change-set was recorded, the run failed, a path escaped the mutation scope, or a required verification check failed.","INDETERMINATE":"The change-set evidence is absent, malformed or does not bind the dispatched task.","PASS":"A working result was recorded, the change-set stayed inside the declared mutation scope and the verification gate passed."}}],"promptAssemblyStrategy":"CANONICAL_PROTOCOL_EVIDENCE_V1","protocolRef":"application-creation:evaluation-protocol/build-task-dispatch","protocolVersion":1,"provenance":{"compilerRef":"meta-workflow:compiler/evaluation-treatment","compilerVersion":1,"sourcePlaybookRef":"playbook:bottom_up.build-dispatch"},"schemaVersion":1,"verdictPrecedence":["GAP","INDETERMINATE","CONCERN","PASS"]},"evaluatorBindingPolicy":{"admissibleEvaluatorDescriptors":[{"descriptorRef":"meta-workflow:evaluator/structured-semantic-coherence","descriptorVersion":1}],"budgetPolicyRef":"application-creation:evaluator-policy/current-work-cycle-budget","defaultEvaluatorDescriptor":{"descriptorRef":"meta-workflow:evaluator/structured-semantic-coherence","descriptorVersion":1},"escalationPolicyRef":"application-creation:evaluator-policy/request-explicit-review","fallbackPolicyRef":"application-creation:evaluator-policy/fail-closed","maximumAttempts":2,"outputSchemaRef":"meta-workflow:schema/structured-semantic-evaluation-candidate","policyRef":"application-creation:evaluator-binding-policy/build-task-dispatch","policyVersion":1,"schemaVersion":1,"selectionPolicyRef":"application-creation:evaluator-policy/scoped-risk-and-evidence","timeoutPolicyRef":"application-creation:evaluator-policy/bounded-semantic-evaluation"},"evidenceRequirements":[{"aggregationPolicyRef":null,"conditionRef":null,"coveragePolicyRef":"application-creation:evidence-policy/all-current-horizon-requirements","criterionRef":"application-creation:criterion/build-task-accomplished-in-scope","diversityPolicyRef":null,"freshnessPolicyRef":"application-creation:evidence-policy/current-accepted-family-heads","independencePolicyRef":null,"kind":"MANDATORY","maxCount":2,"minCount":1,"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1,"schemaVersion":1,"subjectRef":"application-creation:definition-set/requirements-vision-market"},{"aggregationPolicyRef":null,"conditionRef":null,"coveragePolicyRef":"application-creation:evidence-policy/current-horizon-requirements","criterionRef":"application-creation:criterion/build-task-verified-change-set","diversityPolicyRef":null,"freshnessPolicyRef":"application-creation:evidence-policy/current-accepted-family-heads","independencePolicyRef":null,"kind":"MANDATORY","maxCount":1,"minCount":1,"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2,"schemaVersion":1,"subjectRef":"application-creation:definition-set/requirements-current-horizon"}],"schemaVersion":1}
1
+ {"authorityRequirement":{"admittedChannels":["INTERFACE_RELAY"],"assurancePolicyRef":"application-creation:authority-policy/local-single-operator","channelPolicyRef":"application-creation:authority-policy/interface-relay","consequenceClassRef":"application-creation:authority-consequence/accept-build-task-change-set","decisionModePolicyRef":"application-creation:authority-policy/explicit-operator-confirmation","expiryPolicyRef":"application-creation:authority-expiry/current-interface-session","hardFloorOverrideAllowed":false,"hardFloorPosture":"NON_WAIVABLE","minimumAssurance":"LOCAL_OS_SESSION","noncePolicyRef":"application-creation:authority-nonce/random-per-request","principalPolicyRef":null,"requiredDecisionMode":"EXPLICIT_OPERATOR_CONFIRMATION","requiredEvidenceRequirementRefs":["application-creation:evidence-requirement/build-task-verified-change-set","application-creation:evidence-requirement/build-task-serves-requirements"],"requirementRef":"application-creation:authority-requirement/build-task-dispatch-result","requirementVersion":1,"riskClassRef":"application-creation:risk/application-worktree-horizon-acceptance","schemaVersion":1},"continuationPolicy":{"fallbackAction":"BLOCK","mappings":[{"action":"CONTINUE","decisionConsequence":"CONTINUE"},{"action":"REVISE","decisionConsequence":"REVISE"},{"action":"REQUEST_EVIDENCE","decisionConsequence":"REQUEST_EVIDENCE"},{"action":"REQUEST_AUTHORITY","decisionConsequence":"REQUEST_AUTHORITY"},{"action":"BLOCK","decisionConsequence":"BLOCK"}],"maximumAuthorityReviews":1,"maximumEvidenceRequests":2,"maximumRevisionAttempts":3,"policyRef":"application-creation:continuation-policy/build-task-dispatch","policyVersion":1,"schemaVersion":1},"decisionPointDefinition":{"authorityRequirement":{"requirementRef":"application-creation:authority-requirement/build-task-dispatch-result","requirementVersion":1},"continuationPolicy":{"policyRef":"application-creation:continuation-policy/build-task-dispatch","policyVersion":1},"decisionPointRef":"application-creation:decision-point/build-task-dispatch","decisionPointVersion":1,"decisionRule":{"ruleRef":"application-creation:decision-rule/build-task-dispatch","ruleVersion":1},"evaluatorBindingPolicy":{"policyRef":"application-creation:evaluator-binding-policy/build-task-dispatch","policyVersion":1},"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1},{"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2}],"hardFloorRefs":["application-creation:hard-floor/build-task-verified-change-set"],"riskPolicyRef":"application-creation:risk-policy/scoped-application-and-execution-context","schemaVersion":1,"significancePolicyRef":"application-creation:significance-policy/application-worktree-change","triggerRefs":["application-creation:trigger/build-task-change-set-recorded"]},"decisionRule":{"boundaryClass":"QUALITY_INTERPRETATION","evaluatorFailureConsequence":"BLOCK","evidenceAggregationRef":"application-creation:aggregation/worst-build-task-dispatch-verdict","hardFloorBindings":[{"evidenceRequirementRefs":["application-creation:evidence-requirement/build-task-verified-change-set"],"hardFloorRef":"application-creation:hard-floor/build-task-verified-change-set"}],"hardFloorFailureConsequence":"BLOCK","hardFloorShortcutAllowed":false,"resultMappings":[{"consequence":"REQUEST_AUTHORITY","verdict":"PASS"},{"consequence":"REVISE","verdict":"CONCERN"},{"consequence":"REVISE","verdict":"GAP"},{"consequence":"REQUEST_EVIDENCE","verdict":"INDETERMINATE"}],"ruleRef":"application-creation:decision-rule/build-task-dispatch","ruleVersion":1,"schemaVersion":1,"unresolvedConsequence":"REQUEST_EVIDENCE"},"definitionRef":"application-creation:evaluation-treatment/build-task-dispatch","definitionVersion":2,"evaluationProtocol":{"aggregationPolicyRef":"application-creation:aggregation/worst-build-task-dispatch-verdict","aggregationStrategy":"WORST_VERDICT_PRECEDENCE_V1","criteria":[{"criterionRef":"application-creation:criterion/build-task-accomplished-in-scope","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1}],"instruction":"Assess whether the attributed change-set actually implements the dispatched task's target and stage (a schema task adds the persisted shape, a ui-behavior task adds field displays, a spec task documents the resource), stays within the task's module/resource/stage, and is cleanly attributable to the run (RUN_EXCLUSIVE / APPEARED_DURING_RUN). Files that were already dirty at the dispatch baseline are review-required and must not be counted against the run. Do not re-decompose the plan, do not author code yourself, and do not reward edits sprawling into unrelated modules.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The task is advanced but the change-set sprawls beyond its module/resource/stage or its attribution is partly ambiguous.","GAP":"The change-set does not advance the dispatched target, or is empty on a task that should have authored files.","INDETERMINATE":"The dispatched task or its change-set cannot be identified from the evidence.","PASS":"The change-set advances exactly the dispatched target/stage, inside its scope, with clean attribution."}},{"criterionRef":"application-creation:criterion/build-task-verified-change-set","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2}],"instruction":"Verify the sealed worktree change-set evidence of the dispatched build task. PASS only when the coding host recorded a working result, every required verification check succeeded, and every changed path outside the declared scope (`outOfScopePaths`, which may include a parallel session's edits) is accounted for; an unresolved out-of-scope path is a CONCERN, not an absence of evidence. Never infer verification from the agent's own narrative, and never treat an absent change-set as a passed task.","schemaVersion":1,"verdictGuidance":{"CONCERN":"The gate passed, but the evidence shows a verification check the reviewer cannot independently confirm, or the result records out-of-scope paths (`outOfScopePaths`) whose authorship is unresolved — the change set cannot tell the run's edits from a parallel session's.","GAP":"No change-set was recorded, the run failed, or a required verification check failed.","INDETERMINATE":"The change-set evidence is absent, malformed or does not bind the dispatched task.","PASS":"A working result was recorded, the verification gate passed, and every changed path outside the declared mutation scope is accounted for."}}],"promptAssemblyStrategy":"CANONICAL_PROTOCOL_EVIDENCE_V1","protocolRef":"application-creation:evaluation-protocol/build-task-dispatch","protocolVersion":1,"provenance":{"compilerRef":"meta-workflow:compiler/evaluation-treatment","compilerVersion":1,"sourcePlaybookRef":"playbook:bottom_up.build-dispatch"},"schemaVersion":1,"verdictPrecedence":["GAP","INDETERMINATE","CONCERN","PASS"]},"evaluatorBindingPolicy":{"admissibleEvaluatorDescriptors":[{"descriptorRef":"meta-workflow:evaluator/structured-semantic-coherence","descriptorVersion":1}],"budgetPolicyRef":"application-creation:evaluator-policy/current-work-cycle-budget","defaultEvaluatorDescriptor":{"descriptorRef":"meta-workflow:evaluator/structured-semantic-coherence","descriptorVersion":1},"escalationPolicyRef":"application-creation:evaluator-policy/request-explicit-review","fallbackPolicyRef":"application-creation:evaluator-policy/fail-closed","maximumAttempts":2,"outputSchemaRef":"meta-workflow:schema/structured-semantic-evaluation-candidate","policyRef":"application-creation:evaluator-binding-policy/build-task-dispatch","policyVersion":1,"schemaVersion":1,"selectionPolicyRef":"application-creation:evaluator-policy/scoped-risk-and-evidence","timeoutPolicyRef":"application-creation:evaluator-policy/bounded-semantic-evaluation"},"evidenceRequirements":[{"aggregationPolicyRef":null,"conditionRef":null,"coveragePolicyRef":"application-creation:evidence-policy/all-current-horizon-requirements","criterionRef":"application-creation:criterion/build-task-accomplished-in-scope","diversityPolicyRef":null,"freshnessPolicyRef":"application-creation:evidence-policy/current-accepted-family-heads","independencePolicyRef":null,"kind":"MANDATORY","maxCount":2,"minCount":1,"requirementRef":"application-creation:evidence-requirement/build-task-serves-requirements","requirementVersion":1,"schemaVersion":1,"subjectRef":"application-creation:definition-set/requirements-vision-market"},{"aggregationPolicyRef":null,"conditionRef":null,"coveragePolicyRef":"application-creation:evidence-policy/current-horizon-requirements","criterionRef":"application-creation:criterion/build-task-verified-change-set","diversityPolicyRef":null,"freshnessPolicyRef":"application-creation:evidence-policy/current-accepted-family-heads","independencePolicyRef":null,"kind":"MANDATORY","maxCount":1,"minCount":1,"requirementRef":"application-creation:evidence-requirement/build-task-verified-change-set","requirementVersion":2,"schemaVersion":1,"subjectRef":"application-creation:definition-set/requirements-current-horizon"}],"schemaVersion":1}