@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

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 (1167) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  21. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  22. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  23. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  24. package/dist/esm/framework-knowledge.definitions.js +547 -17
  25. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  26. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  27. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  28. package/dist/esm/framework-knowledge.loader.js +47 -1
  29. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  30. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  31. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  32. package/dist/esm/index.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  34. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
  36. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
  38. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
  40. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
  42. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
  44. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
  46. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
  48. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  52. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  54. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  55. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
  56. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  57. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  58. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  59. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
  60. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
  62. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  63. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
  64. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  65. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  66. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
  68. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  70. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  71. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
  72. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  73. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
  74. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
  76. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
  78. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  79. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
  80. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  81. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  82. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
  84. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  86. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  88. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
  90. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
  94. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
  96. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  98. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  99. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  100. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  101. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  102. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  103. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  104. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  105. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  106. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  107. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  108. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  109. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  110. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  111. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  112. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
  114. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  115. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
  116. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  118. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  120. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  122. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  123. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  124. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  125. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
  126. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  127. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
  128. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
  130. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
  132. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  134. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  135. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
  136. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
  138. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
  140. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
  142. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
  144. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
  146. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
  148. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
  150. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
  152. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  153. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
  154. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  155. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
  156. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
  158. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  159. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
  160. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  161. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  162. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  163. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  164. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  165. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  166. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  167. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  168. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  169. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  170. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  171. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
  172. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  173. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  174. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  175. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
  176. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  177. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  178. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  179. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
  180. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  181. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  182. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  183. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
  184. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  185. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
  186. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  187. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
  188. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  189. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
  190. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  191. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
  192. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  193. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  194. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  195. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  196. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  197. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
  198. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  199. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
  200. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  201. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
  202. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  203. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
  204. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  205. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
  206. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  207. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
  208. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  209. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  210. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  211. package/dist/knowledge/manifest.json +9 -8
  212. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  213. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
  214. package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
  215. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
  216. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
  219. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
  220. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  221. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  222. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
  223. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
  224. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
  225. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
  226. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
  227. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
  228. package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
  229. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
  230. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
  231. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
  232. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
  233. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
  234. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
  235. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
  236. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
  237. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
  238. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
  239. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  240. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  241. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
  244. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
  245. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
  246. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  247. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
  248. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  249. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
  250. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  251. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  252. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  253. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  254. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  255. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  256. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
  257. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  258. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  259. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  260. package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
  261. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
  262. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  263. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  264. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
  267. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  268. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  269. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  270. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
  271. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
  272. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
  273. package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
  274. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
  275. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  276. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
  277. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  278. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  279. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
  280. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
  281. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  282. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
  283. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  284. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  285. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
  286. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
  287. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  288. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
  289. package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
  290. package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
  291. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  292. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
  293. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  294. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  295. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  296. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
  297. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  298. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
  299. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  300. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
  301. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  302. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  303. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
  304. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
  305. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  306. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  307. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  308. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
  309. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
  310. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
  311. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  312. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  313. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  314. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
  315. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
  316. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
  317. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  318. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  319. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
  320. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
  321. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
  322. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
  323. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  324. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  325. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  326. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  327. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  328. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  329. package/dist/knowledge/references/application-maturity.config.md +319 -0
  330. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  331. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  332. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  333. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  334. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  335. package/dist/knowledge/references/brand.asset.config.md +8 -16
  336. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  337. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  338. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  339. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  340. package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
  341. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  342. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  343. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/capability-composition.config.md +174 -0
  345. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  346. package/dist/knowledge/references/cli.market.utils.md +1 -0
  347. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  348. package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
  349. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  350. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  351. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  352. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  353. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  354. package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
  355. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  356. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  357. package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
  358. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  359. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  360. package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
  361. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  362. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  363. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  364. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  365. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  366. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  367. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  368. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  369. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  370. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  371. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
  372. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
  373. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  374. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  375. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  376. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  377. package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
  378. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  379. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  380. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  381. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  382. package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
  383. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  384. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  385. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  386. package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
  387. package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
  388. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  389. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
  390. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
  391. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  392. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
  393. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
  394. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  395. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  396. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
  397. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
  398. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  399. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  400. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  401. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  402. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  403. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  404. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  405. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  406. package/dist/knowledge/references/experience-plan.config.md +318 -0
  407. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
  408. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  409. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  410. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  411. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  412. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  413. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  414. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  415. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  416. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
  417. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  418. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  419. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  420. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  421. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  422. package/dist/knowledge/references/integration-plan.config.md +217 -0
  423. package/dist/knowledge/references/market.alternative.config.md +2 -2
  424. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  425. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  426. package/dist/knowledge/references/market.category.config.md +1 -1
  427. package/dist/knowledge/references/market.channel.config.md +4 -4
  428. package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
  429. package/dist/knowledge/references/market.gain.config.md +2 -2
  430. package/dist/knowledge/references/market.icp.config.md +3 -3
  431. package/dist/knowledge/references/market.job.config.md +2 -2
  432. package/dist/knowledge/references/market.message-template.config.md +3 -3
  433. package/dist/knowledge/references/market.objection.config.md +2 -2
  434. package/dist/knowledge/references/market.pain.config.md +2 -2
  435. package/dist/knowledge/references/market.persona.config.md +3 -3
  436. package/dist/knowledge/references/market.positioning.config.md +1 -1
  437. package/dist/knowledge/references/market.proof.config.md +2 -2
  438. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  439. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  440. package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
  441. package/dist/knowledge/references/market.trigger.config.md +2 -2
  442. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  443. package/dist/knowledge/references/placement-plan.config.md +375 -0
  444. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  445. package/dist/knowledge/references/platform.config.backing-services.md +15 -36
  446. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  447. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  448. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  449. package/dist/knowledge/references/platform.config.saas.md +261 -9
  450. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  451. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  452. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  453. package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
  454. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  455. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  456. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  457. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  458. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  459. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  460. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  461. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  462. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  463. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  464. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  465. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  466. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
  467. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  468. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  469. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  470. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
  471. package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
  472. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  473. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  479. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  480. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  481. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
  482. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  483. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  484. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  485. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  486. package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
  487. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  488. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  489. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  490. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  491. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  492. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  493. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  494. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  495. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  496. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  497. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  498. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  499. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
  500. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  501. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  502. package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
  503. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  504. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  505. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  506. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  507. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  508. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  509. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  510. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  511. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  513. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  514. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  515. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  516. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  517. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
  518. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  519. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  520. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
  521. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  522. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  523. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  524. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  525. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
  526. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
  527. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  528. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
  529. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  530. package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
  531. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  532. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  533. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  534. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  535. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  536. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  537. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  538. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  539. package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
  540. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  541. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  542. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
  543. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
  544. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  545. package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
  546. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  547. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
  548. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  549. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  550. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  551. package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
  552. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
  553. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  554. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  555. package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
  556. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  557. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  558. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  559. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  560. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  561. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  562. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  563. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  564. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  565. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  566. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  567. package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
  568. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  569. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  570. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  571. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  572. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  573. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  574. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  575. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  576. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  577. package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
  578. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
  579. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
  580. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
  581. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
  582. package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
  583. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
  584. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  585. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  586. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
  587. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  588. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  589. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  590. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  591. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  592. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  593. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  594. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  595. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  596. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  597. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  598. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  599. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  600. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  601. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  602. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  603. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  604. package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
  605. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  606. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  607. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
  608. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  609. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  610. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
  611. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  612. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  613. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  614. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  615. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
  616. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  617. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  618. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  619. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  620. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  621. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  622. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  623. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  624. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  625. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  626. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  627. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  628. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  629. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  630. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  631. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
  632. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
  633. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  634. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  635. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  636. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  637. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  638. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  639. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  640. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  641. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  642. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  643. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  644. package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
  645. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  646. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  647. package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
  648. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  649. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  650. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  651. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  652. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  653. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  654. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  655. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
  656. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
  657. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  658. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  659. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  660. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  661. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  662. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
  663. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  664. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  665. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
  666. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  667. package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
  668. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  669. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  670. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
  671. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
  672. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  673. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  674. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  675. package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
  676. package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
  677. package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
  678. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
  679. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  680. package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
  681. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  682. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  683. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  684. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  685. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  686. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  687. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  688. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  689. package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
  690. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  691. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  692. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  693. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  694. package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
  695. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  696. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  697. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  698. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  699. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  700. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  701. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  702. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  703. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  704. package/dist/knowledge/references/website-plan.config.md +238 -0
  705. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  706. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  707. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  708. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
  709. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
  710. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
  711. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  712. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  713. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  714. package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
  715. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
  716. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
  717. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  718. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  719. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  720. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  721. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
  722. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
  723. package/dist/knowledge/references/zod.factories.address.md +118 -0
  724. package/dist/knowledge/references/zod.factories.code.md +4 -2
  725. package/dist/knowledge/references/zod.factories.duration.md +6 -4
  726. package/dist/knowledge/references/zod.factories.money.md +5 -3
  727. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  728. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  729. package/dist/knowledge/registries/framework-topics.json +2602 -214
  730. package/dist/knowledge/registries/playbooks.json +468 -92
  731. package/dist/knowledge/registries/source-tags.json +6171 -1996
  732. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  733. package/dist/knowledge/rules/live-context-door.md +137 -0
  734. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  735. package/dist/knowledge/skills/INDEX.md +67 -29
  736. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  737. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  738. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  739. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  740. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  741. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  742. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  743. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  744. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  745. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
  746. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  747. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  748. package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
  749. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  750. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  751. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
  752. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
  753. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
  754. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
  755. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  756. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
  757. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  758. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  759. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  760. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
  761. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
  762. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  763. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  764. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
  765. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  766. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
  767. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  768. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  769. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  770. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
  771. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
  772. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
  773. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
  774. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  775. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  776. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  777. package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
  778. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
  779. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  780. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  781. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  782. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  783. package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
  784. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  785. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  786. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  787. package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
  788. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  789. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  790. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
  791. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
  792. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
  793. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
  794. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
  795. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  796. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  797. package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
  798. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
  799. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
  800. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  801. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
  802. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
  803. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  804. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
  805. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
  806. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  807. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  808. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  809. package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
  810. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  811. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  812. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  813. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  814. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
  815. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  816. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
  817. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  818. package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
  819. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
  820. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
  821. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
  822. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  823. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
  824. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  825. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
  826. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  827. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
  828. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
  829. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
  830. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  831. package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
  832. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  833. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
  834. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  835. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  836. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  837. package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
  838. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
  839. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  840. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  841. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  842. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  843. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
  844. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  845. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  846. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  847. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  848. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  849. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  850. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  851. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
  852. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
  853. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  854. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  855. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
  856. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
  857. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
  858. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
  859. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  860. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  861. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  862. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
  863. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  864. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
  865. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
  866. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  867. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  868. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  869. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  870. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
  871. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
  872. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  873. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
  874. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
  875. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
  876. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  877. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  878. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  879. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  880. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  881. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  882. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  883. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  884. package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
  885. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  886. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
  887. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  888. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  889. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  890. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  891. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  892. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  893. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  894. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  895. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  896. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  897. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
  898. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  899. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  900. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  901. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
  902. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
  903. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
  904. package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
  905. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  906. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  907. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  908. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  909. package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
  910. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
  911. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
  912. package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
  913. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
  914. package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
  915. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
  916. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
  917. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
  918. package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
  919. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  920. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  921. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
  922. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  923. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
  924. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  925. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
  926. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
  927. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
  928. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  929. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  930. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  931. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  932. package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
  933. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  934. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  935. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  936. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  937. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  938. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  939. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  940. package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
  941. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
  942. package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
  943. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
  944. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
  945. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  946. package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
  947. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  948. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  949. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  950. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  951. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  952. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  953. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  954. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  955. package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
  956. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  957. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  958. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  959. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  960. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  961. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  962. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  963. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  964. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  965. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
  966. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  967. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  968. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
  969. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  970. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  971. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  972. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  973. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  974. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
  975. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  976. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
  977. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  978. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
  979. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
  980. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  981. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
  982. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
  983. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  984. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  985. package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
  986. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  987. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
  988. package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
  989. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
  990. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  991. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  992. package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
  993. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
  994. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
  995. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
  996. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
  997. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
  998. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  999. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  1000. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  1001. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
  1002. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  1003. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
  1004. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  1005. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
  1006. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  1007. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
  1008. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
  1009. package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
  1010. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
  1011. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  1012. package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
  1013. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  1014. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  1015. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  1016. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
  1017. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
  1018. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
  1019. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  1020. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  1021. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  1022. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  1023. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  1024. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  1025. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  1026. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  1027. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  1028. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  1029. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
  1030. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  1031. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  1032. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  1033. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
  1034. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
  1035. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  1036. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  1037. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  1038. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  1039. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  1040. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  1041. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  1042. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  1043. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  1044. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
  1045. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  1046. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  1047. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  1048. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  1049. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
  1050. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
  1051. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  1052. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  1053. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
  1054. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
  1055. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  1056. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
  1057. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  1058. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  1059. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  1060. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  1061. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
  1062. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
  1063. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
  1064. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
  1065. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
  1066. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  1067. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  1068. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
  1069. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
  1070. package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
  1071. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  1072. package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
  1073. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  1074. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  1075. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  1076. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  1077. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  1078. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  1079. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  1080. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  1081. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  1082. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
  1083. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
  1084. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  1085. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  1086. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  1087. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
  1088. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
  1089. package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
  1090. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  1091. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  1092. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  1093. package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
  1094. package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
  1095. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  1096. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
  1097. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  1098. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  1099. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  1100. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
  1101. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  1102. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1103. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  1104. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
  1105. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  1106. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
  1107. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  1108. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  1109. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
  1110. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  1111. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  1112. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
  1113. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  1114. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
  1115. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
  1116. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
  1117. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
  1118. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  1119. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
  1120. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  1121. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  1122. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
  1123. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
  1124. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
  1125. package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
  1126. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  1127. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  1128. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  1129. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  1130. package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
  1131. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
  1132. package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
  1133. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
  1134. package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
  1135. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
  1136. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
  1137. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
  1138. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
  1139. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
  1140. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
  1141. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
  1142. package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
  1143. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
  1144. package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
  1145. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
  1146. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  1147. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
  1148. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
  1149. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  1150. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  1151. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
  1152. package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
  1153. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  1154. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  1155. package/dist/knowledge/topic-index.json +12659 -4142
  1156. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1157. package/dist/tsconfig.tsbuildinfo +1 -1
  1158. package/package.json +4 -4
  1159. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  1160. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  1161. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
  1162. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
  1163. package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
  1164. package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
  1165. package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
  1166. package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
  1167. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -3,12 +3,7 @@
3
3
  "version": "0.1.0",
4
4
  "phase": "bottom_up",
5
5
  "intent": "Bottom-up build scale — the THIRD and final build-execution playbook, the pivot from dispatching ONE task safely (the single-flight dispatch contract) to running the build at SCALE: parallelism across several coding agents, the concurrency schedule, and interleaving the companion-owned generation steps concurrently with coding runs. Reads the approved build-plan (the ordered coding-agent task graph, each task carrying a target, ONE MetaWorkflow_FunctionalTopic, its skill(s), and prose prerequisite ordering) and the current journey state, and answers the SCALE questions the single-flight dispatch playbook deliberately left open: (1) derive the ready-SET (a wave / frontier of tasks whose prose prerequisites have ALL SUCCEEDED — not merely been attempted); (2) decide the parallelism degree (how many coding agents run at once) and the worktree-isolation model that keeps each concurrent run's change-set cleanly attributable; (3) schedule the waves respecting the DEPENDS_ON ordering the build-plan encodes; (4) interleave the deterministic companion-owned generation steps (labels / i18n, email templates, seeds) concurrently with coding runs at the points their inputs exist — those steps run through their deterministic companion endpoints, NOT the coding-agent single-flight lock, so they genuinely overlap coding runs; (5) reconcile wave completion across the concurrent runs (all tasks in the frontier SUCCEEDED before the next wave opens) and apply onFailure across siblings + downstream. Then advance to the next wave and loop. Each parallel slot INVOKES the single-flight dispatch contract (the build-dispatch playbook, upstream — select-next / context-pack / one ACP prompt turn / change-set capture / verify-outside / record + onFailure); this playbook does NOT re-specify those per-task mechanics and does NOT re-decompose the plan (the build-decompose playbook owns the task graph) and authors no schemas / no code. IMPORTANT HONESTY: the companion runner HARD-ENFORCES single-flight today (a run plan carries at most ONE coding-agent task; a concurrent dispatch is refused; the workspace-mutation lock + the lock-free cursor + the missing run-outcome observation loop all assume one dispatch at a time). So this v1 scale METHOD is the DECLARATIVE TARGET a runner-serializer slice will realize — on the current runner the waves DEGRADE to sequential single-flight dispatch. And even the deterministic companion-generation steps, though they do not take the coding single-flight lock, cannot SAFELY overlap an active coding run today: the coding run's change-set is captured as a whole-worktree time-window diff, so a generation step writing files inside that window is misattributed to the coding run (the same whole-worktree pollution that forbids two concurrent coding agents) — so the generation steps also serialize outside an active coding-capture window today, and genuine concurrency (coding-parallel OR generation-overlap) both arrive only with the git worktree-per-agent isolation runner task. v1 scaffold: a multi-CODING_AGENT run-completion serializer, git worktree-per-agent isolation, a run-outcome reconciler, and a cursor lock are companion-runner mechanism filed as runner tasks, NOT built here; a priority/work-stealing scheduler and cost-optimal packing are a later depth phase.",
6
- "functionalTopics": [],
7
6
  "preconditions": [
8
- {
9
- "kind": "phase_is",
10
- "phase": "bottom_up"
11
- },
12
7
  {
13
8
  "kind": "artifact_exists",
14
9
  "selector": {
@@ -22,24 +17,18 @@
22
17
  }
23
18
  ],
24
19
  "outputs": [],
20
+ "stepOutputs": [],
25
21
  "method": {
26
- "guidance": "# Build Scale — Run the Build at Scale: Waves, Parallelism, Interleaved Generation (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, and a deliberately honest one.** It is a\n> working first cut of the *scale* orchestration — derive a wave of ready tasks,\n> run several coding agents in parallel under an isolation model, interleave the\n> deterministic companion-generation steps, and reconcile wave completion. But\n> the companion runner **hard-enforces single-flight today**: it refuses a run\n> plan with more than one coding-agent task, refuses a second dispatch while one\n> is active, holds one workspace-mutation lock per run, and has no run-outcome\n> reconciler. So the concurrency described below is the **declarative target** a\n> runner-serializer slice will realize. **On the current runner the waves\n> degrade to sequential single-flight dispatch** — read the \"What the runner\n> actually does today\" section before you assume anything ran in parallel. Do\n> not overclaim concurrency the runner cannot do.\n\n## Where you are in the journey\n\nThis is the **third and final build-execution playbook** — the pivot from\n**dispatching one task safely** (the build-dispatch playbook's single-flight\ncontract) to **running the build at scale**. It runs in the **bottom-up phase**,\nafter the build plan exists (`artifact_exists build-plan`) and the foundation\nstep has authored the app's config and skeleton. You\nare not re-opening the decomposition here, and you are not re-specifying how one\ntask dispatches — you are deciding **how many** tasks run **concurrently** and\n**safely**, in **what order**, with the companion-generation steps interleaved.\n\nUpstream: the **build-decompose** playbook produced the ordered task graph you\nschedule; the **build-dispatch** playbook defined how ONE task dispatches\nsafely — you **invoke that contract per parallel slot**, you do not re-author\nit. **You author neither of those concerns** — see the boundary section.\n\n## What this playbook does\n\nYou are the **scale orchestrator**. This playbook reads the approved build plan\nand the current journey state and answers, across the *whole* build: *\"which set\nof tasks is ready to run now, how many run at once and on what isolation, when\ndo the deterministic generation steps run, and when has a wave actually\nfinished?\"* You do **not** produce a new journey artifact — the observable\nresult of the build is the per-task change-sets + task statuses the runner\nrecords on the task rows (the build-dispatch playbook's mechanism), not a\nschedule artifact authored here (see \"What you emit\"). You do **not** decompose\nthe plan, re-specify the per-task dispatch mechanics, author any schema, or\nwrite any code.\n\n## The scale contract — you sequence waves, the dispatch playbook runs each slot\n\nMost of the *per-task* mechanism is **not yours**: selecting one task,\ncomposing its context pack, running one prompt turn against the coding agent over\nthe Agent Client Protocol (answering its permission requests within the declared\nceiling), capturing the change-set, running the verify hook, holding the\nsingle-flight lock, enforcing the budget floor — all of that is the **build-dispatch** contract, which each\nparallel slot invokes. Your method here is the **declarative concurrency\nrecipe** the runner (or a future runner-serializer) interprets: *which set* of\ntasks is ready, *how many* run at once, *how* they are isolated, *when* the\ndeterministic generation steps interleave, and *when* a wave is done. Do not\nhand-drive git, do not compose a dispatch prompt, do not re-implement the\nsingle-flight capture — invoke the dispatch contract per slot and let it own\nthose.\n\n## Read state first — no artifact to write\n\nThis playbook is **idempotent** and, on a re-run, *advances the schedule by one\nwave* (and, on today's single-flight runner, by one task within that wave).\nBefore scheduling anything:\n\n1. Read the current journey state and scope through the `journey-status` skill\n (it owns the read; do not re-derive it here). Confirm the **build plan** is\n present and approved and the **foundation** ran. For each build-plan task,\n read its dispatch state from its task row — **not yet dispatched**,\n **dispatched-and-succeeded** (a captured change-set + a passed verify),\n **dispatched-and-failed** (a captured change-set but a failed/timed-out run\n or a failed verify), or **in-flight**. This full state — not just \"has a\n change-set\" — is what the wave derivation keys on (under `keep_and_flag` a\n *failed* task also has a captured change-set, so presence of a change-set\n alone never means \"done\").\n2. Read the approved **build plan** (`build-plan` — the ordered task graph, with\n each task's prose prerequisite references). It is your work list.\n\n That there is an application to dispatch into is answered by the committed\n `./wildo.saas.config.ts` and skeleton, not by a journey artifact. (A\n `foundation-manifest` played that role until 2026-08-25 and was retired with the\n app-creation verification/digest aspect.) The honest limitation the foundation step\n carries still applies: on-disk skeleton materialization depends on greenfield\n bring-up tooling (deferred); the dogfood app already has a skeleton, so the scale\n contract runs against an existing workspace.\n\n// TODO CLI COMMAND: wildo journey status\n// (read journey scope + the approved build plan + every task's dispatch state)\n\nYou **read** `build-plan`; you **write** no journey\nartifact — the runner records each dispatched task's change-set + status on its\nrow.\n\n## Step 1 — Derive the ready-set (the wave / frontier)\n\nWalk the build plan and compute the **frontier**: the set of tasks that are\n**not yet dispatched** (or previously-**failed** tasks cleared for retry) and\nwhose prose prerequisites have **all SUCCEEDED**. That set is the next **wave**.\n\n- **A prerequisite must have SUCCEEDED, not merely been attempted.** A task\n enters the frontier only when every task it depends on is\n dispatched-and-succeeded (verify passed). A prerequisite that is\n dispatched-and-**failed** (its change-set flagged for triage under\n `keep_and_flag`), still **in-flight**, or un-run does **not** satisfy the\n dependency — its dependents stay **out of the frontier** until it succeeds.\n This is the U13b readiness discipline, lifted to a set: do not open a wave on\n a schema whose run has not verified.\n- **The wave respects the build-plan ordering.** The build-decompose playbook\n encoded the DEPENDS_ON edges (the per-resource stage order schema → config →\n ui-behavior → spec, the cross-topic edges, relationship-after-endpoints); the\n frontier is exactly the tasks with no unsatisfied edge remaining. You do not\n re-derive or re-order those edges — you read them and compute the ready-set.\n- **An empty frontier is a terminal state.** If no task is ready — every task\n has succeeded, or the only undispatched tasks are blocked behind an\n unresolved failure — the build is done (or blocked on a flagged failure):\n report it and stop. An empty build plan is the same.\n\n## Step 2 — Decide the parallelism degree + the worktree-isolation model\n\nFor the frontier, decide **how many** coding agents run at once and **on what\nisolation**. This is the core scale decision, and it is bounded by a hard\nsafety constraint, not just throughput:\n\n- **Change-set attribution requires isolation.** The dispatch contract captures\n each run's change-set by diffing the worktree around the run and attributing\n every file as `RUN_EXCLUSIVE`, `APPEARED_DURING_RUN`, or\n `BASELINE_DIRTY_AMBIGUOUS`. **Two coding agents mutating the SAME worktree\n concurrently make every touched file `BASELINE_DIRTY_AMBIGUOUS`** — each run\n looks like it started against a tree the other was dirtying — which\n **destroys per-run attribution**. So real parallelism needs one of:\n - **git worktree-per-agent isolation** — each concurrent coding agent runs in\n its own git worktree (a disjoint checkout of the same repo), so each run's\n change-set is captured against a tree only it mutates; the worktrees are\n reconciled/merged after the wave. This is the general answer.\n - **module / resource partitioning** — schedule concurrent agents only onto\n tasks whose targets touch **disjoint file sets** (different modules /\n resources), so even on one shared worktree no two runs collide. This is the\n cheaper answer when the frontier naturally partitions by module.\n - **or keep coding single-flight** and only parallelise the deterministic\n companion-generation steps (Step 3), which are not coding-locked.\n- **Pick the degree deliberately, not maximally.** At scaffold depth prefer a\n small degree (or a module partition) over max fan-out — cost-optimal packing,\n a priority / work-stealing scheduler, and backoff are a later depth phase, not\n this scaffold. State the isolation model you chose; a wave with degree > 1 and\n **no** isolation answer is unsafe (the reviewer rubric flags it as a GAP).\n\n## Step 3 — Interleave the deterministic companion-generation steps\n\nThe build plan carries **companion-owned generation steps** — labels / i18n,\nemail templates, seeds — as tasks. These are **deterministic companion\nendpoints**, not coding-agent dispatches: they do **not** contend for the\ncoding single-flight lock. It is tempting to conclude they can freely run\n*alongside* a coding run — but there is a subtlety that makes that unsafe on\ntoday's runner, see the caveat below.\n\n- **Run each generation step at its input-ready point.** A labels/i18n step runs\n after the resources it labels exist; an email step after its templates'\n definition surfaces exist; a seed step after the resources it seeds exist.\n Schedule each at its input-ready point in the wave sequence — do not block a\n coding wave on them and do not run them before their inputs exist. (The\n *ordering* is what matters here; the *concurrency* is deferred — see the\n caveat.)\n- **Route them to their deterministic endpoint, not the coding lane.** Do not\n dispatch a coding agent for a labels/email/seed step — it has a deterministic\n companion generator. Treating a generation step as a coding dispatch is scope\n creep the reviewer flags.\n- **CAVEAT — no attribution-safe overlap with an active coding run today.** The\n coding run's change-set is captured as a **whole-worktree time-window diff**\n (every tracked-dirty + untracked file in the window). So a generation step\n writing label / email / seed files **while a coding dispatch is capturing** is\n misattributed to that coding run — its files show up as the coding run's own\n edits. This is the *same* whole-worktree pollution that forbids two concurrent\n coding agents (Step 2), and it applies identically to coding + generation. So\n on today's runner the generation steps must **also** be serialized to run\n **outside** an active coding-capture window (i.e. between coding runs). Genuine\n overlap — generation alongside coding, and coding alongside coding — both\n arrive only with git worktree-per-agent isolation (the runner task in Step 5's\n gap note). Until then, keep the input-ready *ordering* and serialize.\n\n// TODO CLI COMMAND: wildo journey run <playbookRef>\n// (trigger the scheduled wave; each coding slot invokes the single-flight dispatch contract, each generation step runs its deterministic endpoint)\n\n## Step 4 — Authorize the fan-out (approve_before)\n\nFanning out **several** coding agents that **mutate the application workspace**\nis the highest-stakes action in the journey. This playbook's approval posture is\n`approve_before`: the scale run is authorized **before** it touches the tree.\nSettle the exact pending Authority Request through the `journey-approve` skill; never start\nthe fan-out on your own judgment.\n\n- Under the **GUIDED** autonomy preset the gate is verbatim; under\n **YOLO_LIGHT** it downgrades to a post-hoc result review; under **YOLO** it is\n auto (the non-bypassable **budget floor** — per-playbook and per-journey\n run/wall-time ceilings — is the guardrail no preset can lift).\n- **v1 gate granularity (be honest about the floor's reach).** The approval gate\n is currently **playbook-scoped for the journey**, not scoped to a single wave:\n the first authorization of this scale playbook admits its subsequent runs too\n (bounded by the run-count budget floor), rather than re-prompting per wave. So\n `approve_before` here means \"the creator authorizes the **scale loop** before\n any task mutates the workspace\" — a real pre-fan-out floor. A per-wave,\n single-use gate is a deferred runner posture; until it lands, the budget\n ceiling + the per-task change-set capture + the verify gate bound the\n authorized loop.\n\n## Step 5 — Reconcile wave completion, then advance\n\nA wave is done only when **every task in the frontier reached a terminal\nSUCCEEDED outcome** (change-set captured + verify passed) or is explicitly held\nas a blocked / flagged failure. Only then does the next frontier open (Step 1).\n\n- **Do not open the next wave on an unfinished one.** Advancing while a wave's\n tasks are still in-flight, or with an unreconciled failure, risks a downstream\n task building on an unfinished prerequisite. Reconcile first.\n- **Failure disposition across siblings + downstream** — this playbook's\n `onFailure` is **`keep_and_flag`**: a failed/timed-out task keeps its captured\n change-set flagged for human triage (never silently reverted, never an\n un-recorded half-applied state). Its already-dispatched **siblings** in the\n same wave are left to complete; its **dependents** in later waves stay\n **blocked** (Step 1) until it is triaged and re-dispatched successfully.\n Triage is a human decision: keep + fix forward, unwind the flagged change-set\n by hand, or re-dispatch once the blocker is resolved. This playbook does not\n auto-retry a failed task (automated retry / backoff is a deferred build-loop\n resilience concern).\n\n> **Why keep_and_flag, not revert_changeset (a v1 boundary).** Reverting a\n> failed run's edits is a *mutating* git op, deliberately **outside** the\n> read-only change-set carve-out the dispatch lane observes. So `keep_and_flag`\n> is both the correct F-5 workspace-safety posture and the behavior the runner\n> enforces today; a `revert_changeset` path is a deliberate later boundary.\n\nThen **loop**: on the next run, `journey-status` reflects the just-completed\nwave's outcomes, and you derive the next frontier (Step 1). Close a significant\nstretch of the build with a `journey-report` summary — which waves ran, which\nchange-sets landed, what verify said, which generation steps interleaved, and\nany failed task left flagged for triage.\n\n## What the runner actually does today (do not overclaim)\n\nBe honest with the creator about the gap between this method and the runner:\n\n- **The runner enforces single-flight.** It refuses a run plan carrying more\n than one coding-agent task, refuses a second dispatch while one is active, and\n holds one workspace-mutation lock per background run. So a wave with\n parallelism degree > 1 is **not** realizable on today's runner — the wave\n **degrades to sequential single-flight dispatch** (repeated invocation of the\n build-dispatch contract, one task at a time, in frontier order). The frontier\n math, the readiness discipline, and the reconciliation are all still correct\n and useful sequentially — you just do not get concurrency yet.\n- **No overlap is attribution-safe today — not even a companion-generation\n step.** The generation endpoints are not coding-locked, but the coding\n change-set capture is a whole-worktree time-window diff, so a generation step\n writing files while a coding dispatch is capturing is misattributed to that\n run (Step 3's caveat). So the generation steps **also** serialize outside an\n active coding-capture window: their input-ready *ordering* holds, only the\n *concurrency* is deferred. Safe overlap of generation-with-coding, and\n coding-with-coding, both require git worktree-per-agent isolation.\n- **The concurrency this method describes is the declarative target** for a\n runner-serializer slice (multi-coding-agent run-completion serialization,\n git worktree-per-agent isolation, a run-outcome reconciler, and a cursor lock)\n — filed as runner tasks, **not** built by this scaffold playbook. Until they\n land, run the waves sequentially and do not claim a parallel run (or a\n generation-alongside-coding overlap) happened when it did not.\n\n## Scaffold-depth boundary (owned by a sibling, or deferred to a later phase)\n\nKeep this playbook at **scale-orchestration depth**. Explicitly **out of scope\nhere**:\n\n- **Re-decomposition.** You do NOT split modules/resources into tasks, re-order\n the graph, or add tasks — the **build-decompose** playbook owns the task\n graph. You read it and schedule from it.\n- **The per-task dispatch contract.** You do NOT re-specify single-flight\n locking, context-pack composition, change-set capture, or the verify hook —\n the **build-dispatch** playbook owns \"how ONE task dispatches safely\", and\n each parallel slot **invokes** that contract. If you catch yourself describing\n how a single task captures its change-set, stop — that is the dispatch\n playbook.\n- **The runner-serializer mechanism.** The multi-coding-agent serializer, git\n worktree-per-agent provisioning, the run-outcome reconciler, and the cursor\n lock are **companion-runner mechanism**, filed as runner tasks — this\n declarative method does not build them.\n- **A priority / work-stealing scheduler + cost-optimal packing.** Deciding an\n optimal task ordering within a band, work-stealing across idle slots, backoff,\n and cost-optimal packing are a later depth phase — the v1 scaffold picks a\n small parallelism degree (or a module partition) and a simple frontier order.\n- **A `revert_changeset` failure path.** Deferred; `keep_and_flag` is the v1\n disposition.\n- **Auto-executed reviewer checklist.** The scale-soundness checklist ships\n **declarative** — the deterministic typecheck gate runs automatically; nothing\n executes the checklist prose (rubric-only judge gates were retired at the\n flexible-intelligence hard cut). Do not assume it auto-ran.\n- **Schema / field authoring + code generation.** The **coding agents** author\n fields, schemas, ui-behavior, and code at dispatch time — never the\n orchestrator.\n\nIf you find yourself designing how ONE task dispatches safely rather than how\nMANY tasks are scheduled + reconciled, stop — that is the build-dispatch\nplaybook.\n\n## What you emit\n\n**No journey artifact.** This is a pure-orchestration playbook: the observable\nresult of the build — each task's **change-set** (files touched, attributed,\nsummarized) and **status** — is materialized by the runner on the dispatched\ntask rows (the build-dispatch playbook's mechanism), not authored here. A\nseparate schedule / wave-log artifact family is deliberately not added: the task\nrows already *are* the dispatch record and a second home for the same record\nwould drift (a typed wave-schedule / run-ledger contract is a filed later-phase\nitem). The creator authorizes the scale run (`approve_before`) before it fans\nout, and reviews the recorded change-sets + verify outcomes after — wave by\nwave, until the build plan is fully dispatched.\n\n## References\n\n- `.claude/skills/journey-status/SKILL.md` — read the current journey state,\n scope, and budget; confirm the build plan is approved and the foundation ran,\n and read every task's dispatch state to compute the frontier.\n- `.claude/skills/journey-approve/SKILL.md` — relay the exact pre-fan-out Authority Request\n gate decision that authorizes the workspace-mutating fan-out (never\n self-approve).\n- `.claude/skills/journey-run/SKILL.md` — trigger a scheduled wave; each coding\n slot invokes the single-flight dispatch contract and each deterministic\n generation step runs its companion endpoint.\n- `.claude/skills/journey-report/SKILL.md` — summarize a stretch of the build:\n which waves ran, which change-sets landed, what verify said, and any failed\n task left flagged for triage.\n\n## Reviewer checklist — `scale-schedule-sound`\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 SCALE orchestration ran the build soundly — the trust-but-verify reviewer pass over how MANY tasks were scheduled, parallelised, and reconciled, WITHOUT straying into how ONE task dispatches (that is the build-dispatch playbook's rubric) or how the plan was decomposed (the build-decompose playbook's). Assess six invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) WAVE READINESS — every task dispatched in a wave had ALL its prose prerequisites already SUCCEEDED (dispatched-and-verified), not merely attempted; a task dispatched while a prerequisite was un-run, in-flight, or dispatched-and-FAILED is a GAP (the build stage ran against a missing prerequisite). A prerequisite whose run FAILED (its change-set flagged under keep_and_flag) does NOT satisfy the dependency — its dependents must stay blocked, and dispatching them anyway is a GAP. (2) PARALLELISM SAFETY / ATTRIBUTION — the concurrent coding runs in a wave were isolated so each run's change-set is cleanly attributable (files RUN_EXCLUSIVE / APPEARED_DURING_RUN per run), via git worktree-per-agent isolation OR a module/resource partition that puts every concurrent agent on a DISJOINT file set. Two concurrent coding agents mutating the SAME worktree — which makes every touched file BASELINE_DIRTY_AMBIGUOUS and destroys per-run attribution — is a GAP (the single-flight floor was bypassed without an isolation answer). Note the honest floor: the runner enforces single-flight today, so on the current runner a 'wave' degrades to SEQUENTIAL single-flight dispatch and this invariant reads whether the METHOD declared a sound isolation model, not whether concurrency actually ran. (3) COMPANION-GENERATION INTERLEAVE — the deterministic companion-owned generation steps (labels / i18n, email templates, seeds) ran through their deterministic companion endpoints AFTER the resources / modules whose output they consume existed, at the right point in the schedule order; a generation step ordered before its inputs exist, or a missing generation step for authored surfaces, is a CONCERN; treating a deterministic generation step as a coding-agent dispatch (dispatching an agent for it) is a CONCERN. Note the honest floor: the generation steps do NOT take the coding single-flight lock, but the coding change-set capture is a whole-worktree time-window diff, so a generation step writing files WHILE a coding dispatch is capturing is misattributed to that coding run — so on today's runner the generation steps also serialize outside an active coding-capture window, and this invariant reads whether they ran at the right point in the ORDER, not whether they truly overlapped a coding run (safe overlap needs worktree isolation). (4) WAVE-COMPLETION RECONCILIATION — the next wave opened only after every task in the current frontier reached a terminal SUCCEEDED outcome (or was explicitly held as a blocked / flagged failure); advancing the schedule while a wave's tasks were still in-flight or with an unreconciled failure is a GAP (a downstream task could build on an unfinished prerequisite). (5) FAILURE DISPOSITION ACROSS SIBLINGS + DOWNSTREAM — a failed / timed-out task in a wave kept its captured change-set flagged for human triage (keep_and_flag), its already-dispatched siblings in the same wave were left to complete, and its DEPENDENTS in later waves stayed blocked until it was triaged and re-dispatched successfully; a failed task whose dependents were dispatched anyway, or a failure silently reverted / left un-recorded, is a GAP (F-5 workspace-safety violation). (6) BOUNDARY DISCIPLINE — the orchestration stays at SCALE depth: it derives ready-sets, schedules waves, sets the parallelism + isolation model, interleaves the companion-generation steps, and reconciles completion. It does NOT re-decompose the plan (the build-decompose playbook owns the task graph), does NOT re-specify the per-task dispatch mechanics (single-flight lock / context-pack / change-set capture / verify — the build-dispatch playbook owns those; the scale orchestrator INVOKES that contract per slot), and does NOT itself author schemas / fields / code (the coding agents do that at dispatch time). Evidence of re-decomposition, re-authoring the single-task dispatch contract, or the orchestrator authoring code itself is a CONCERN (scope creep out of the scale lane). (The checklist is declarative: nothing executes it; the deterministic gates and the creator's approval remain the floors.)\n",
27
- "skillRefs": [
28
- "journey-status",
29
- "journey-approve",
30
- "journey-run",
31
- "journey-report"
32
- ]
22
+ "guidance": "# Build Scale — Run the Build at Scale: Waves, Parallelism, Interleaved Generation (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, and a deliberately honest one.** It is a\n> working first cut of the *scale* orchestration — derive a wave of ready tasks,\n> run several coding agents in parallel under an isolation model, interleave the\n> deterministic companion-generation steps, and reconcile wave completion. But\n> the companion runner **hard-enforces single-flight today**: it refuses a run\n> plan with more than one coding-agent task, refuses a second dispatch while one\n> is active, holds one workspace-mutation lock per run, and has no run-outcome\n> reconciler. So the concurrency described below is the **declarative target** a\n> runner-serializer slice will realize. **On the current runner the waves\n> degrade to sequential single-flight dispatch** — read the \"What the runner\n> actually does today\" section before you assume anything ran in parallel. Do\n> not overclaim concurrency the runner cannot do.\n\n## Where you are in the journey\n\nThis is the **third and final build-execution playbook** — the pivot from\n**dispatching one task safely** (the build-dispatch playbook's single-flight\ncontract) to **running the build at scale**. It runs in the **bottom-up phase**,\nafter the build plan exists (`artifact_exists build-plan`) and the foundation\nstep has authored the app's config and skeleton. You\nare not re-opening the decomposition here, and you are not re-specifying how one\ntask dispatches — you are deciding **how many** tasks run **concurrently** and\n**safely**, in **what order**, with the companion-generation steps interleaved.\n\nUpstream: the **build-decompose** playbook produced the ordered task graph you\nschedule; the **build-dispatch** playbook defined how ONE task dispatches\nsafely — you **invoke that contract per parallel slot**, you do not re-author\nit. **You author neither of those concerns** — see the boundary section.\n\n## What this playbook does\n\nYou are the **scale orchestrator**. This playbook reads the approved build plan\nand the current journey state and answers, across the *whole* build: *\"which set\nof tasks is ready to run now, how many run at once and on what isolation, when\ndo the deterministic generation steps run, and when has a wave actually\nfinished?\"* You do **not** produce a new journey artifact — the observable\nresult of the build is the per-task change-sets + task statuses the runner\nrecords on the task rows (the build-dispatch playbook's mechanism), not a\nschedule artifact authored here (see \"What you emit\"). You do **not** decompose\nthe plan, re-specify the per-task dispatch mechanics, author any schema, or\nwrite any code.\n\n## The scale contract — you sequence waves, the dispatch playbook runs each slot\n\nMost of the *per-task* mechanism is **not yours**: selecting one task,\ncomposing its context pack, running one prompt turn against the coding agent over\nthe Agent Client Protocol (answering its permission requests within the declared\nceiling), capturing the change-set, running the verify hook, holding the\nsingle-flight lock, applying the host's actual execution limits — all of that is the **build-dispatch** contract, which each\nparallel slot invokes. Your method here is the **declarative concurrency\nrecipe** the runner (or a future runner-serializer) interprets: *which set* of\ntasks is ready, *how many* run at once, *how* they are isolated, *when* the\ndeterministic generation steps interleave, and *when* a wave is done. Do not\nhand-drive git, do not compose a dispatch prompt, do not re-implement the\nsingle-flight capture — invoke the dispatch contract per slot and let it own\nthose.\n\n## Read state first — no artifact to write\n\nThis playbook is **idempotent** and, on a re-run, *advances the schedule by one\nwave* (and, on today's single-flight runner, by one task within that wave).\nBefore scheduling anything:\n\n1. Read the current journey state and scope from what this run is given — the loaded\n specifications and the workspace sections of your brief — and do not re-derive it. Confirm the **build plan** is\n present and approved and the **foundation** ran. For each build-plan task,\n read its dispatch state from its task row — **not yet dispatched**,\n **dispatched-and-succeeded** (a captured change-set + a passed verify),\n **dispatched-and-failed** (a captured change-set but a failed/timed-out run\n or a failed verify), or **in-flight**. This full state — not just \"has a\n change-set\" — is what the wave derivation keys on (under `keep_and_flag` a\n *failed* task also has a captured change-set, so presence of a change-set\n alone never means \"done\").\n2. Read the approved **build plan** (`build-plan` — the ordered task graph, with\n each task's prose prerequisite references). It is your work list.\n\n That there is an application to dispatch into is answered by the committed\n `./wildo.saas.config.ts` and skeleton, not by a journey artifact. (A\n `foundation-manifest` played that role until 2026-08-25 and was retired with the\n app-creation verification/digest aspect.) The honest limitation the foundation step\n carries still applies: on-disk skeleton materialization depends on greenfield\n bring-up tooling (deferred); the dogfood app already has a skeleton, so the scale\n contract runs against an existing workspace.\n\n// Operator status: `wildo context journey` (eligibility board + runs in flight); per-task landed\n// state is read from git by the runner.\n\nYou **read** `build-plan`; you **write** no journey\nartifact — the runner records each dispatched task's change-set + status on its\nrow.\n\n## Step 1 — Derive the ready-set (the wave / frontier)\n\nWalk the build plan and compute the **frontier**: the set of tasks that are\n**not yet dispatched** (or previously-**failed** tasks cleared for retry) and\nwhose prose prerequisites have **all SUCCEEDED**. That set is the next **wave**.\n\n- **A prerequisite must have SUCCEEDED, not merely been attempted.** A task\n enters the frontier only when every task it depends on is\n dispatched-and-succeeded (verify passed). A prerequisite that is\n dispatched-and-**failed** (its change-set flagged for triage under\n `keep_and_flag`), still **in-flight**, or un-run does **not** satisfy the\n dependency — its dependents stay **out of the frontier** until it succeeds.\n This is the U13b readiness discipline, lifted to a set: do not open a wave on\n a schema whose run has not verified.\n- **The wave respects the build-plan ordering.** The build-decompose playbook\n encoded the DEPENDS_ON edges (the per-resource stage order schema → config →\n ui-behavior → spec, the cross-topic edges, relationship-after-endpoints); the\n frontier is exactly the tasks with no unsatisfied edge remaining. You do not\n re-derive or re-order those edges — you read them and compute the ready-set.\n- **An empty frontier is a terminal state.** If no task is ready — every task\n has succeeded, or the only undispatched tasks are blocked behind an\n unresolved failure — the build is done (or blocked on a flagged failure):\n report it and stop. An empty build plan is the same.\n\n## Step 2 — Decide the parallelism degree + the worktree-isolation model\n\nFor the frontier, decide **how many** coding agents run at once and **on what\nisolation**. This is the core scale decision, and it is bounded by a hard\nsafety constraint, not just throughput:\n\n- **Change-set attribution requires isolation.** The dispatch contract captures\n each run's change-set by diffing the worktree around the run and attributing\n every file as `RUN_EXCLUSIVE`, `APPEARED_DURING_RUN`, or\n `BASELINE_DIRTY_AMBIGUOUS`. **Two coding agents mutating the SAME worktree\n concurrently make every touched file `BASELINE_DIRTY_AMBIGUOUS`** — each run\n looks like it started against a tree the other was dirtying — which\n **destroys per-run attribution**. So real parallelism needs one of:\n - **git worktree-per-agent isolation** — each concurrent coding agent runs in\n its own git worktree (a disjoint checkout of the same repo), so each run's\n change-set is captured against a tree only it mutates; the worktrees are\n reconciled/merged after the wave. This is the general answer.\n - **module / resource partitioning** — schedule concurrent agents only onto\n tasks whose targets touch **disjoint file sets** (different modules /\n resources), so even on one shared worktree no two runs collide. This is the\n cheaper answer when the frontier naturally partitions by module.\n - **or keep coding single-flight** and only parallelise the deterministic\n companion-generation steps (Step 3), which are not coding-locked.\n- **Pick the degree deliberately, not maximally.** At scaffold depth prefer a\n small degree (or a module partition) over max fan-out — cost-optimal packing,\n a priority / work-stealing scheduler, and backoff are a later depth phase, not\n this scaffold. State the isolation model you chose; a wave with degree > 1 and\n **no** isolation answer is unsafe (the reviewer rubric flags it as a GAP).\n\n## Step 3 — Interleave the deterministic companion-generation steps\n\nThe build plan carries **companion-owned generation steps** — labels / i18n,\nemail templates, seeds — as tasks. These are **deterministic companion\nendpoints**, not coding-agent dispatches: they do **not** contend for the\ncoding single-flight lock. It is tempting to conclude they can freely run\n*alongside* a coding run — but there is a subtlety that makes that unsafe on\ntoday's runner, see the caveat below.\n\n- **Run each generation step at its input-ready point.** A labels/i18n step runs\n after the resources it labels exist; an email step after its templates'\n definition surfaces exist; a seed step after the resources it seeds exist.\n Schedule each at its input-ready point in the wave sequence — do not block a\n coding wave on them and do not run them before their inputs exist. (The\n *ordering* is what matters here; the *concurrency* is deferred — see the\n caveat.)\n- **Route them to their deterministic endpoint, not the coding lane.** Do not\n dispatch a coding agent for a labels/email/seed step — it has a deterministic\n companion generator. Treating a generation step as a coding dispatch is scope\n creep the reviewer flags.\n- **CAVEAT — no attribution-safe overlap with an active coding run today.** The\n coding run's change-set is captured as a **whole-worktree time-window diff**\n (every tracked-dirty + untracked file in the window). So a generation step\n writing label / email / seed files **while a coding dispatch is capturing** is\n misattributed to that coding run — its files show up as the coding run's own\n edits. This is the *same* whole-worktree pollution that forbids two concurrent\n coding agents (Step 2), and it applies identically to coding + generation. So\n on today's runner the generation steps must **also** be serialized to run\n **outside** an active coding-capture window (i.e. between coding runs). Genuine\n overlap — generation alongside coding, and coding alongside coding — both\n arrive only with git worktree-per-agent isolation (the runner task in Step 5's\n gap note). Until then, keep the input-ready *ordering* and serialize.\n\n// The trigger is `wildo creation run <playbookRef>` (or `/wildo:run` from a Claude Code session),\n// which reaches the companion's run route with the local token attached. Each coding slot invokes the\n// single-flight dispatch contract; each generation step runs its deterministic endpoint.\n\n## Step 4 — Check the actual host authorization boundary\n\nA coding dispatch writes the application workspace. Read its selected task, readiness,\nmutation scope and the configured coding host's authorization policy before invoking it.\nThe single-flight mutation lock still applies to the current shared workspace.\n\nThe playbook's `approval` declaration and the journey autonomy presets express policy\nintent. The current playbook runner does not interpret them as pre-dispatch gates,\nautomatic authorization, or a GUIDED/YOLO mapping. A declared `approve_before` does\nnot create a pending Authority Request, and no authority workflow exists to create one —\nnever invent one from an enum.\n\nLikewise, do not infer enforced per-playbook or per-journey run ceilings from declared\nbudget fields. Respect the limits actually reported by the execution host. Inspect the\nrecorded changes and verification result after each task; no preset commits or accepts them.\n\n## Step 5 — Reconcile wave completion, then advance\n\nA wave is done only when **every task in the frontier reached a terminal\nSUCCEEDED outcome** (change-set captured + verify passed) or is explicitly held\nas a blocked / flagged failure. Only then does the next frontier open (Step 1).\n\n- **Do not open the next wave on an unfinished one.** Advancing while a wave's\n tasks are still in-flight, or with an unreconciled failure, risks a downstream\n task building on an unfinished prerequisite. Reconcile first.\n- **Failure disposition across siblings + downstream** — this playbook's\n declared `onFailure` describes **`keep_and_flag`**; the current host retains changes for review. A failed/timed-out task keeps its captured\n change-set flagged for human triage (never silently reverted, never an\n un-recorded half-applied state). Its already-dispatched **siblings** in the\n same wave are left to complete; its **dependents** in later waves stay\n **blocked** (Step 1) until it is triaged and re-dispatched successfully.\n Triage is a human decision: keep + fix forward, unwind the flagged change-set\n by hand, or re-dispatch once the blocker is resolved. This playbook does not\n auto-retry a failed task (automated retry / backoff is a deferred build-loop\n resilience concern).\n\n> **Why keep_and_flag, not revert_changeset (a v1 boundary).** Reverting a\n> failed run's edits is a *mutating* git op, deliberately **outside** the\n> read-only change-set carve-out the dispatch lane observes. So `keep_and_flag`\n> is both the correct F-5 workspace-safety posture and the behavior the runner\n> enforces today; a `revert_changeset` path is a deliberate later boundary.\n\nThen **loop**: on the next run, the build plan's task records reflect the just-completed\nwave's outcomes (`wildo build tasks`), and you derive the next frontier (Step 1). Close a\nsignificant stretch of the build with a progress summary — which waves ran, which\nchange-sets landed, what verify said, which generation steps interleaved, and\nany failed task left flagged for triage.\n\n## What the runner actually does today (do not overclaim)\n\nBe honest with the creator about the gap between this method and the runner:\n\n- **The runner enforces single-flight.** It refuses a run plan carrying more\n than one coding-agent task, refuses a second dispatch while one is active, and\n holds one workspace-mutation lock per background run. So a wave with\n parallelism degree > 1 is **not** realizable on today's runner — the wave\n **degrades to sequential single-flight dispatch** (repeated invocation of the\n build-dispatch contract, one task at a time, in frontier order). The frontier\n math, the readiness discipline, and the reconciliation are all still correct\n and useful sequentially — you just do not get concurrency yet.\n- **No overlap is attribution-safe today — not even a companion-generation\n step.** The generation endpoints are not coding-locked, but the coding\n change-set capture is a whole-worktree time-window diff, so a generation step\n writing files while a coding dispatch is capturing is misattributed to that\n run (Step 3's caveat). So the generation steps **also** serialize outside an\n active coding-capture window: their input-ready *ordering* holds, only the\n *concurrency* is deferred. Safe overlap of generation-with-coding, and\n coding-with-coding, both require git worktree-per-agent isolation.\n- **The concurrency this method describes is the declarative target** for a\n runner-serializer slice (multi-coding-agent run-completion serialization,\n git worktree-per-agent isolation, a run-outcome reconciler, and a cursor lock)\n — filed as runner tasks, **not** built by this scaffold playbook. Until they\n land, run the waves sequentially and do not claim a parallel run (or a\n generation-alongside-coding overlap) happened when it did not.\n\n## Scaffold-depth boundary (owned by a sibling, or deferred to a later phase)\n\nKeep this playbook at **scale-orchestration depth**. Explicitly **out of scope\nhere**:\n\n- **Re-decomposition.** You do NOT split modules/resources into tasks, re-order\n the graph, or add tasks — the **build-decompose** playbook owns the task\n graph. You read it and schedule from it.\n- **The per-task dispatch contract.** You do NOT re-specify single-flight\n locking, context-pack composition, change-set capture, or the verify hook —\n the **build-dispatch** playbook owns \"how ONE task dispatches safely\", and\n each parallel slot **invokes** that contract. If you catch yourself describing\n how a single task captures its change-set, stop — that is the dispatch\n playbook.\n- **The runner-serializer mechanism.** The multi-coding-agent serializer, git\n worktree-per-agent provisioning, the run-outcome reconciler, and the cursor\n lock are **companion-runner mechanism**, filed as runner tasks — this\n declarative method does not build them.\n- **A priority / work-stealing scheduler + cost-optimal packing.** Deciding an\n optimal task ordering within a band, work-stealing across idle slots, backoff,\n and cost-optimal packing are a later depth phase — the v1 scaffold picks a\n small parallelism degree (or a module partition) and a simple frontier order.\n- **A `revert_changeset` failure path.** Deferred; `keep_and_flag` is the v1\n disposition.\n- **Auto-executed reviewer checklist.** The scale-soundness checklist ships\n **declarative** — the deterministic typecheck gate runs automatically; nothing\n executes the checklist prose (rubric-only judge gates were retired at the\n flexible-intelligence hard cut). Do not assume it auto-ran.\n- **Schema / field authoring + code generation.** The **coding agents** author\n fields, schemas, ui-behavior, and code at dispatch time — never the\n orchestrator.\n\nIf you find yourself designing how ONE task dispatches safely rather than how\nMANY tasks are scheduled + reconciled, stop — that is the build-dispatch\nplaybook.\n\n## What you emit\n\n**No journey artifact.** This is a pure-orchestration playbook: the observable\nresult of the build — each task's **change-set** (files touched, attributed,\nsummarized) and **status** — is materialized by the runner on the dispatched\ntask rows (the build-dispatch playbook's mechanism), not authored here. A\nseparate schedule / wave-log artifact family is deliberately not added: the task\nrows already *are* the dispatch record and a second home for the same record\nwould drift (a typed wave-schedule / run-ledger contract is a filed later-phase\nitem). Use the configured host's actual authorization boundary and review its\nrecorded changes and verification outcomes. The approval declaration alone does\nnot authorize or gate dispatch.\n\n## References\n\n- A playbook's declared `approval` and failure policy gate nothing on a leaf run; they are read only\n at a composite lane's boundary, where they frame a decision for the person and revert nothing.\n\n## Reviewer checklist — `scale-schedule-sound`\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 SCALE orchestration ran the build soundly — the trust-but-verify reviewer pass over how MANY tasks were scheduled, parallelised, and reconciled, WITHOUT straying into how ONE task dispatches (that is the build-dispatch playbook's rubric) or how the plan was decomposed (the build-decompose playbook's). Assess six invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) WAVE READINESS — every task dispatched in a wave had ALL its prose prerequisites already SUCCEEDED (dispatched-and-verified), not merely attempted; a task dispatched while a prerequisite was un-run, in-flight, or dispatched-and-FAILED is a GAP (the build stage ran against a missing prerequisite). A prerequisite whose run FAILED (its change-set flagged under keep_and_flag) does NOT satisfy the dependency — its dependents must stay blocked, and dispatching them anyway is a GAP. (2) PARALLELISM SAFETY / ATTRIBUTION — the concurrent coding runs in a wave were isolated so each run's change-set is cleanly attributable (files RUN_EXCLUSIVE / APPEARED_DURING_RUN per run), via git worktree-per-agent isolation OR a module/resource partition that puts every concurrent agent on a DISJOINT file set. Two concurrent coding agents mutating the SAME worktree — which makes every touched file BASELINE_DIRTY_AMBIGUOUS and destroys per-run attribution — is a GAP (the single-flight floor was bypassed without an isolation answer). Note the honest floor: the runner enforces single-flight today, so on the current runner a 'wave' degrades to SEQUENTIAL single-flight dispatch and this invariant reads whether the METHOD declared a sound isolation model, not whether concurrency actually ran. (3) COMPANION-GENERATION INTERLEAVE — the deterministic companion-owned generation steps (labels / i18n, email templates, seeds) ran through their deterministic companion endpoints AFTER the resources / modules whose output they consume existed, at the right point in the schedule order; a generation step ordered before its inputs exist, or a missing generation step for authored surfaces, is a CONCERN; treating a deterministic generation step as a coding-agent dispatch (dispatching an agent for it) is a CONCERN. Note the honest floor: the generation steps do NOT take the coding single-flight lock, but the coding change-set capture is a whole-worktree time-window diff, so a generation step writing files WHILE a coding dispatch is capturing is misattributed to that coding run — so on today's runner the generation steps also serialize outside an active coding-capture window, and this invariant reads whether they ran at the right point in the ORDER, not whether they truly overlapped a coding run (safe overlap needs worktree isolation). (4) WAVE-COMPLETION RECONCILIATION — the next wave opened only after every task in the current frontier reached a terminal SUCCEEDED outcome (or was explicitly held as a blocked / flagged failure); advancing the schedule while a wave's tasks were still in-flight or with an unreconciled failure is a GAP (a downstream task could build on an unfinished prerequisite). (5) FAILURE DISPOSITION ACROSS SIBLINGS + DOWNSTREAM — a failed / timed-out task in a wave kept its captured change-set flagged for human triage (keep_and_flag), its already-dispatched siblings in the same wave were left to complete, and its DEPENDENTS in later waves stayed blocked until it was triaged and re-dispatched successfully; a failed task whose dependents were dispatched anyway, or a failure silently reverted / left un-recorded, is a GAP (F-5 workspace-safety violation). (6) BOUNDARY DISCIPLINE — the orchestration stays at SCALE depth: it derives ready-sets, schedules waves, sets the parallelism + isolation model, interleaves the companion-generation steps, and reconciles completion. It does NOT re-decompose the plan (the build-decompose playbook owns the task graph), does NOT re-specify the per-task dispatch mechanics (single-flight lock / context-pack / change-set capture / verify — the build-dispatch playbook owns those; the scale orchestrator INVOKES that contract per slot), and does NOT itself author schemas / fields / code (the coding agents do that at dispatch time). Evidence of re-decomposition, re-authoring the single-task dispatch contract, or the orchestrator authoring code itself is a CONCERN (scope creep out of the scale lane). (The checklist is declarative: nothing executes it; the current host's deterministic checks apply; the approval enum alone adds no gate.)\n",
23
+ "skillRefs": [],
24
+ "skillBodyRefs": [],
25
+ "contextSources": [],
26
+ "draftableDocumentDefinitionRefs": [],
27
+ "suspendsForClarification": false,
28
+ "briefAdequacyGate": false,
29
+ "briefAdequacyExcludedSources": []
33
30
  },
34
- "executor": "composite",
35
- "qualityGates": [
36
- {
37
- "ref": "scale-typecheck",
38
- "kind": "deterministic_validator",
39
- "validatorRef": "typecheck",
40
- "required": true
41
- }
42
- ],
31
+ "executor": "coding_agent",
43
32
  "approval": "approve_before",
44
33
  "budget": {
45
34
  "maxRuns": 30
@@ -0,0 +1,93 @@
1
+ # Capability Composition — Which Scenarios This Application Needs
2
+
3
+ ### Target Application Framing
4
+
5
+ This knowledge is for configuring behavior in the target application.
6
+ Wildo is the framework surface being used, not the product being built.
7
+
8
+ Read and apply these patterns from the application-developer point of view:
9
+
10
+ - how the application should configure the relevant app-level file
11
+ - how the application should use framework-provided factories, enums, and helpers
12
+ - how the application should avoid mixing frontend, backend, and infrastructure concerns
13
+
14
+
15
+ ## What this step does
16
+
17
+ The framework ships one composition scenario per folder under `templates/saas/scenarios/`. Two of
18
+ them — `add-module` and `add-resource` — are applied by the foundation from the domain plan. The
19
+ others give an application a marketing website, a documentation portal, a cron minion, a worker, a
20
+ provider, a file-picker provider, a second website locale, another deployment environment or the
21
+ optional 3D layout, and until this step existed nothing in the journey decided whether an
22
+ application needed any of them: they were reachable only by a person running `wildo compose`.
23
+
24
+ This step records that decision as the `capability-composition` family: **one decision per
25
+ scenario the framework ships**, each with a disposition, the closed basis it was derived from,
26
+ and a one-sentence detail naming the declaring entries.
27
+
28
+ ## It is derived, never asked
29
+
30
+ Nothing here is an interview. Every decision is read off what the application's own families
31
+ DECLARE:
32
+
33
+ | scenario | NEEDED when | read from |
34
+ |---|---|---|
35
+ | `add-website` | the market declares an inbound web channel (organic or paid search, content, owned or paid social); else a brand brief has landed; else the business model declares pricing plans | `market-snapshot.channels`, `brand-brief`, `business-model.plans` |
36
+ | `add-technical-doc` | a targeted ICP (CORE or EXPANSION) is a legal entity; else a non-functional requirement declares PORTABILITY | `market-snapshot.icps`, `requirements.nonFunctional` |
37
+ | `add-locale` | a website is composed and the application configuration serves more than one language — one locale per language beyond the primary | `appPreferences.languages` in the application configuration (a host fact: no family declares languages, and the configuration already does) |
38
+
39
+ Where no typed declaration can decide a scenario, the record says **DECLINED with the basis
40
+ `NO_DECLARATION_DECIDES_IT` and names the declaration that would decide it** — a field for
41
+ somebody to add, never a question for somebody to answer. Today the only such case is `add-locale`
42
+ when a website is composed but the host could not read the configuration's languages.
43
+
44
+ Scenarios another step applies are recorded as **OWNED_BY_ANOTHER_STEP**, naming the owner, so
45
+ the record stays total without claiming the application lacks them:
46
+
47
+ | scenario | owner |
48
+ |---|---|
49
+ | `add-module`, `add-resource` | `bottom_up.foundation` — the domain composition |
50
+ | `add-minion`, `add-worker-node`, `add-worker-rust` | `bottom_up.foundation` — one per surface the integration plan declares |
51
+ | `add-custom-operation`, `add-website-section`, `add-marketing-page`, `add-file-picker-provider` | the build tasks that produce those artifacts (`bottom_up.build-decompose`) |
52
+ | `add-provider` | the foundation's provider decision |
53
+ | `add-environment` | the operator, at deployment (`wildo compose add-environment`) |
54
+ | `add-3d-layout` | the operator's opt-in (`wildo compose add-3d-layout`): nothing a product declares decides a rendering style, so the journey never adopts the optional 3D layout |
55
+
56
+ ## Where it lands, and who reads it
57
+
58
+ The family lands at `specifications/src/capability-composition/index.ts` and is wired onto the
59
+ `capabilityComposition` companion-exports slot. `bottom_up.foundation` reads it there: the NEEDED
60
+ scenarios are applied after the domain scenarios, with the application's own host facts (slug,
61
+ display name, public domain from its infrastructure environments, its port block), and the
62
+ foundation record names **every scenario applied and every scenario declined with the declaration
63
+ each came from**. A package that already exists (`website/`, `technical-doc/`) is left alone and
64
+ reported as already composed.
65
+
66
+ ## Read state first
67
+
68
+ A composition landed before the market, the brand or the business model exists declines what
69
+ nothing yet implies, and says so in each decision's detail. That is the honest first record, not a
70
+ mistake: derived staleness marks the composition stale when any input family lands or changes, and
71
+ re-running this step refines it. Nothing is re-asked because nothing was asked.
72
+
73
+ ## What you emit
74
+
75
+ - The **capability-composition** at `specifications/src/capability-composition/index.ts` —
76
+ one decision per scenario, total over the scenarios the framework ships.
77
+
78
+ ## Verification
79
+
80
+ - The record is total: `validateCapabilityComposition` reports `SCENARIO_NOT_DECIDED` for any
81
+ scenario the framework ships that the record never decided about, and
82
+ `DISPOSITION_BASIS_MISMATCH` for a disposition whose basis contradicts it.
83
+ - `rg -n "disposition: CompositionDisposition.NEEDED" specifications/src/capability-composition/index.ts`
84
+ lists what the foundation will apply.
85
+
86
+ ## References — named by REF, because nothing here opens a file
87
+
88
+ This step is RUNNER-OWNED: the composition is derived by a function, and no model reads this method
89
+ at all. The two skills are named by ref rather than by path for the same reason the tool-less
90
+ playbooks are (#1435) — a path is an instruction nothing can follow:
91
+
92
+ - `config-saas` — the SaaS-config surface the applied scenarios append to
93
+ (`applicationExtraServices`, the workspace members), which is what the foundation executor writes.
@@ -0,0 +1,61 @@
1
+ {
2
+ "ref": "bottom_up.capability-composition",
3
+ "version": "0.1.0",
4
+ "phase": "bottom_up",
5
+ "intent": "Capability composition — decide WHICH of the framework's composition scenarios this application needs (a marketing website, a technical-documentation portal, workers, minions, a second locale, a provider, an environment) and record that decision as the `capability-composition` family, one decision per scenario the framework ships, each naming the declaration it was derived from. DERIVED, never asked: a website follows from an inbound web channel in the market snapshot, a landed brand brief or declared pricing plans; a documentation portal from targeted organisation ICPs or a portability requirement; where no typed declaration can decide a scenario yet (a worker, a minion, a locale) the record says DECLINED and names the declaration that would decide it. Scenarios another step applies (modules and resources by the domain composition, sections and pages by build tasks, providers by the provider decision, environments by deployment) are recorded as owned by that step, so the record stays total. Runs after the domain plan and before the foundation, which applies the NEEDED scenarios and names every scenario applied and declined with its basis.",
6
+ "preconditions": [
7
+ {
8
+ "kind": "artifact_expected",
9
+ "selector": {
10
+ "family": "domain-plan"
11
+ }
12
+ }
13
+ ],
14
+ "inputs": [
15
+ {
16
+ "family": "market-snapshot",
17
+ "render": "map"
18
+ },
19
+ {
20
+ "family": "brand-brief",
21
+ "render": "map"
22
+ },
23
+ {
24
+ "family": "business-model",
25
+ "render": "map"
26
+ },
27
+ {
28
+ "family": "requirements",
29
+ "render": "map"
30
+ },
31
+ {
32
+ "family": "capability-composition",
33
+ "render": "map"
34
+ }
35
+ ],
36
+ "outputs": [
37
+ {
38
+ "family": "capability-composition",
39
+ "schemaRef": "saas-specifications:CapabilityComposition",
40
+ "description": "One decision per composition scenario the framework ships: NEEDED (the foundation applies it), DECLINED (nothing declares it, or no declaration can yet — with the missing declaration named), or OWNED_BY_ANOTHER_STEP (the step that applies it). Each carries the closed basis it was derived from and a one-sentence detail naming the declaring entries."
41
+ }
42
+ ],
43
+ "stepOutputs": [],
44
+ "method": {
45
+ "guidance": "# Capability Composition — Which Scenarios This Application Needs\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## What this step does\n\nThe framework ships one composition scenario per folder under `templates/saas/scenarios/`. Two of\nthem — `add-module` and `add-resource` — are applied by the foundation from the domain plan. The\nothers give an application a marketing website, a documentation portal, a cron minion, a worker, a\nprovider, a file-picker provider, a second website locale, another deployment environment or the\noptional 3D layout, and until this step existed nothing in the journey decided whether an\napplication needed any of them: they were reachable only by a person running `wildo compose`.\n\nThis step records that decision as the `capability-composition` family: **one decision per\nscenario the framework ships**, each with a disposition, the closed basis it was derived from,\nand a one-sentence detail naming the declaring entries.\n\n## It is derived, never asked\n\nNothing here is an interview. Every decision is read off what the application's own families\nDECLARE:\n\n| scenario | NEEDED when | read from |\n|---|---|---|\n| `add-website` | the market declares an inbound web channel (organic or paid search, content, owned or paid social); else a brand brief has landed; else the business model declares pricing plans | `market-snapshot.channels`, `brand-brief`, `business-model.plans` |\n| `add-technical-doc` | a targeted ICP (CORE or EXPANSION) is a legal entity; else a non-functional requirement declares PORTABILITY | `market-snapshot.icps`, `requirements.nonFunctional` |\n| `add-locale` | a website is composed and the application configuration serves more than one language — one locale per language beyond the primary | `appPreferences.languages` in the application configuration (a host fact: no family declares languages, and the configuration already does) |\n\nWhere no typed declaration can decide a scenario, the record says **DECLINED with the basis\n`NO_DECLARATION_DECIDES_IT` and names the declaration that would decide it** — a field for\nsomebody to add, never a question for somebody to answer. Today the only such case is `add-locale`\nwhen a website is composed but the host could not read the configuration's languages.\n\nScenarios another step applies are recorded as **OWNED_BY_ANOTHER_STEP**, naming the owner, so\nthe record stays total without claiming the application lacks them:\n\n| scenario | owner |\n|---|---|\n| `add-module`, `add-resource` | `bottom_up.foundation` — the domain composition |\n| `add-minion`, `add-worker-node`, `add-worker-rust` | `bottom_up.foundation` — one per surface the integration plan declares |\n| `add-custom-operation`, `add-website-section`, `add-marketing-page`, `add-file-picker-provider` | the build tasks that produce those artifacts (`bottom_up.build-decompose`) |\n| `add-provider` | the foundation's provider decision |\n| `add-environment` | the operator, at deployment (`wildo compose add-environment`) |\n| `add-3d-layout` | the operator's opt-in (`wildo compose add-3d-layout`): nothing a product declares decides a rendering style, so the journey never adopts the optional 3D layout |\n\n## Where it lands, and who reads it\n\nThe family lands at `specifications/src/capability-composition/index.ts` and is wired onto the\n`capabilityComposition` companion-exports slot. `bottom_up.foundation` reads it there: the NEEDED\nscenarios are applied after the domain scenarios, with the application's own host facts (slug,\ndisplay name, public domain from its infrastructure environments, its port block), and the\nfoundation record names **every scenario applied and every scenario declined with the declaration\neach came from**. A package that already exists (`website/`, `technical-doc/`) is left alone and\nreported as already composed.\n\n## Read state first\n\nA composition landed before the market, the brand or the business model exists declines what\nnothing yet implies, and says so in each decision's detail. That is the honest first record, not a\nmistake: derived staleness marks the composition stale when any input family lands or changes, and\nre-running this step refines it. Nothing is re-asked because nothing was asked.\n\n## What you emit\n\n- The **capability-composition** at `specifications/src/capability-composition/index.ts` —\n one decision per scenario, total over the scenarios the framework ships.\n\n## Verification\n\n- The record is total: `validateCapabilityComposition` reports `SCENARIO_NOT_DECIDED` for any\n scenario the framework ships that the record never decided about, and\n `DISPOSITION_BASIS_MISMATCH` for a disposition whose basis contradicts it.\n- `rg -n \"disposition: CompositionDisposition.NEEDED\" specifications/src/capability-composition/index.ts`\n lists what the foundation will apply.\n\n## References — named by REF, because nothing here opens a file\n\nThis step is RUNNER-OWNED: the composition is derived by a function, and no model reads this method\nat all. The two skills are named by ref rather than by path for the same reason the tool-less\nplaybooks are (#1435) — a path is an instruction nothing can follow:\n\n- `config-saas` — the SaaS-config surface the applied scenarios append to\n (`applicationExtraServices`, the workspace members), which is what the foundation executor writes.\n",
46
+ "skillRefs": [
47
+ "config-saas"
48
+ ],
49
+ "skillBodyRefs": [],
50
+ "contextSources": [],
51
+ "draftableDocumentDefinitionRefs": [],
52
+ "suspendsForClarification": false,
53
+ "briefAdequacyGate": false,
54
+ "briefAdequacyExcludedSources": []
55
+ },
56
+ "approval": "approve_result",
57
+ "budget": {
58
+ "maxRuns": 5
59
+ },
60
+ "onFailure": "keep_and_flag"
61
+ }
@@ -0,0 +1,98 @@
1
+ # The Conception Lane — the umbrella
2
+
3
+ ### Target Application Framing
4
+
5
+ This knowledge is for configuring behavior in the target application.
6
+ Wildo is the framework surface being used, not the product being built.
7
+
8
+ Read and apply these patterns from the application-developer point of view:
9
+
10
+ - how the application should configure the relevant app-level file
11
+ - how the application should use framework-provided factories, enums, and helpers
12
+ - how the application should avoid mixing frontend, backend, and infrastructure concerns
13
+
14
+
15
+ This playbook produces nothing itself. It drives the steps that CONCEIVE the
16
+ application's structure — the domain plan, the panels' staffing, the foundation, the
17
+ placement plan — and it ends on the placement plan, which is the lane's closing decision.
18
+
19
+ ## The children, and why the order is not written here
20
+
21
+ - **`bottom_up.domain-plan`** — modules, resources and relationships, from the
22
+ requirements and the market. Asks the creator one question (tenancy) and may suspend
23
+ mid-run on a clarification.
24
+ - **`top_down.expert-personas`** — derives and accepts the expert charters the panels
25
+ convene. Runner-owned, lands no family, never re-derives a committed charter, reports
26
+ a role whose inputs have not landed as waiting.
27
+ - **`bottom_up.capability-composition`** — which composition scenarios the
28
+ application needs (a website, a technical-doc portal, workers, minions). Its record
29
+ is what the foundation applies.
30
+ - **`bottom_up.foundation`** — composes the application from the domain plan: the
31
+ configuration, the module and resource slices, the environments. Runner-owned,
32
+ idempotent (a byte-identical target is a skip; a collision refuses), asks the creator
33
+ three questions.
34
+ - **`bottom_up.experience-plan`**, **`bottom_up.website-plan`**,
35
+ **`bottom_up.documentation-plan`** — what each surface the composition declared
36
+ CONTAINS. Conception rather than build: the decomposer reads all three, so a surface
37
+ planned after decomposition is one the build plan has no task for. An application that
38
+ declared no website simply has no website plan, and nothing waits for one.
39
+ - **`bottom_up.placement-plan`** — where every module lands in the application shell,
40
+ decided by a panel (an information architect and a design-system guardian) over three
41
+ candidates.
42
+
43
+ Nothing above is a sequence. Each child declares what it needs, and the runtime
44
+ re-computes what may run after every round. The plan needs the requirements and the
45
+ market; the personas need the vision and the market; the foundation and the placement
46
+ need the plan. Re-run the lane on an application whose plan exists and the first round
47
+ already offers the three that follow it.
48
+
49
+ ## Selecting the next children
50
+
51
+ - **Missing beats present.** A plan or a placement already on record is not
52
+ re-derived unless what it was derived from has been re-derived in this run.
53
+ - **The runner-owned steps run once.** The foundation and the personas land nothing
54
+ the runtime marks delivered, so they stay eligible; the round history is the record
55
+ that they ran. Do not spend a round on either a second time.
56
+ - **Independent children share a round.** The personas and the foundation both need
57
+ only the plan and can run beside each other.
58
+ - **A child waiting on the creator is not offered** — an unanswered interview, or a
59
+ suspended clarification. Run everything else, and stop when nothing eligible advances
60
+ the conception.
61
+
62
+ ## Composing an objective for a child
63
+
64
+ For the domain plan, name the requirements the plan must route and the market ICPs it
65
+ serves. For a re-derivation, name what placement or the build reported the plan could
66
+ not route — that is the whole objective. For placement, name the modules the plan
67
+ declares and the audiences that reach them.
68
+
69
+ ## When the build sends the application back
70
+
71
+ The root re-opens this lane when the build lane's decomposer finds the conception unbuildable
72
+ (`conception-buildable` GAP, #1638). The round history names the criterion, and the objective you
73
+ are given carries the decomposer's reason. Revise the leaf that owns the faulted element, which is
74
+ usually the domain plan: a module, resource or relationship no build target can express, or a
75
+ reference another family makes to something the plan does not declare. A composition surface no
76
+ plan realises belongs to the surface plan it names. Do not re-derive the whole conception: the
77
+ leaves the fault does not touch are still right, and re-deriving them makes the build re-plan work
78
+ that was sound.
79
+
80
+ ## When to stop
81
+
82
+ Stop when the placement plan is on record AND every surface the capability composition
83
+ decided is planned: the placement plan is the decision this lane ends on, but it depends
84
+ only on the domain plan, so it can land while the composition's surfaces are still
85
+ unplanned. A website or documentation portal the composition marks NEEDED, with no
86
+ website plan or documentation plan on record, is a surface the build decomposition will
87
+ emit no task for — and nothing downstream says so. Offer its plan before stopping. The
88
+ coherence report names the gap as `composition-surface-not-planned`.
89
+
90
+ Stop also when nothing eligible advances the conception — the plan suspended on a
91
+ clarification, or an interview is unanswered — and say which.
92
+
93
+ ## What the creator reviews
94
+
95
+ The domain plan and the placement plan, exactly as each leaf's own review guide says;
96
+ the composed application in the working tree, through `git status`; and the accepted
97
+ charters. The decision this lane ends on: the conception is accepted, or returned to
98
+ the domain plan with what could not be routed.
@@ -0,0 +1,98 @@
1
+ {
2
+ "ref": "bottom_up.conception",
3
+ "version": "0.1.2",
4
+ "phase": "bottom_up",
5
+ "intent": "Drive the CONCEPTION of the application as one lane: the domain plan from the requirements and the market, the expert personas that staff the panels, the capability composition the application needs, the foundation composed from the plan and that composition, the surface plans for whatever the composition says this application presents — its experience, its website, its documentation — and the placement plan the panel decides — ending on one decision: the conception is accepted, or returned to the domain plan. An umbrella: it authors nothing itself; every child declares what it needs and the runtime recomputes what may run after each round. Select what is MISSING from the accepted truth shown to you: a family already on record is not re-derived unless the plan it was derived from has been re-derived in this run. The foundation and the expert personas are runner-owned steps that land no family: run each ONCE, when its inputs are on record, and do not spend a round on either again — the round history shows they ran. Run independent children in the same round. STOP when the placement plan is on record AND every surface the capability composition decided NEEDED (a website, a documentation portal) has its plan on record: the placement plan is this lane's closing decision, but it needs only the domain plan, so it can land before a surface plan — and a surface decided and never planned is one the build decomposition emits no task for. A child whose interview the creator has not answered, or whose run suspended on a clarification, is not offered; run everything else and stop when nothing eligible advances the conception.",
6
+ "preconditions": [
7
+ {
8
+ "kind": "artifact_valid",
9
+ "selector": {
10
+ "family": "requirements"
11
+ }
12
+ },
13
+ {
14
+ "kind": "artifact_valid",
15
+ "selector": {
16
+ "family": "market-snapshot"
17
+ }
18
+ },
19
+ {
20
+ "kind": "artifact_expected",
21
+ "selector": {
22
+ "family": "roadmap"
23
+ }
24
+ }
25
+ ],
26
+ "inputs": [
27
+ {
28
+ "family": "vision-brief"
29
+ },
30
+ {
31
+ "family": "requirements",
32
+ "render": "map"
33
+ },
34
+ {
35
+ "family": "market-snapshot",
36
+ "render": "map"
37
+ },
38
+ {
39
+ "family": "roadmap",
40
+ "render": "map"
41
+ },
42
+ {
43
+ "family": "business-model",
44
+ "render": "map"
45
+ },
46
+ {
47
+ "family": "domain-plan",
48
+ "render": "map"
49
+ },
50
+ {
51
+ "family": "placement-plan",
52
+ "render": "map"
53
+ },
54
+ {
55
+ "family": "capability-composition"
56
+ },
57
+ {
58
+ "family": "website-plan",
59
+ "render": "map"
60
+ },
61
+ {
62
+ "family": "documentation-plan",
63
+ "render": "map"
64
+ }
65
+ ],
66
+ "outputs": [],
67
+ "stepOutputs": [],
68
+ "method": {
69
+ "guidance": "# The Conception Lane — the umbrella\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\nThis playbook produces nothing itself. It drives the steps that CONCEIVE the\napplication's structure — the domain plan, the panels' staffing, the foundation, the\nplacement plan — and it ends on the placement plan, which is the lane's closing decision.\n\n## The children, and why the order is not written here\n\n- **`bottom_up.domain-plan`** — modules, resources and relationships, from the\n requirements and the market. Asks the creator one question (tenancy) and may suspend\n mid-run on a clarification.\n- **`top_down.expert-personas`** — derives and accepts the expert charters the panels\n convene. Runner-owned, lands no family, never re-derives a committed charter, reports\n a role whose inputs have not landed as waiting.\n- **`bottom_up.capability-composition`** — which composition scenarios the\n application needs (a website, a technical-doc portal, workers, minions). Its record\n is what the foundation applies.\n- **`bottom_up.foundation`** — composes the application from the domain plan: the\n configuration, the module and resource slices, the environments. Runner-owned,\n idempotent (a byte-identical target is a skip; a collision refuses), asks the creator\n three questions.\n- **`bottom_up.experience-plan`**, **`bottom_up.website-plan`**,\n **`bottom_up.documentation-plan`** — what each surface the composition declared\n CONTAINS. Conception rather than build: the decomposer reads all three, so a surface\n planned after decomposition is one the build plan has no task for. An application that\n declared no website simply has no website plan, and nothing waits for one.\n- **`bottom_up.placement-plan`** — where every module lands in the application shell,\n decided by a panel (an information architect and a design-system guardian) over three\n candidates.\n\nNothing above is a sequence. Each child declares what it needs, and the runtime\nre-computes what may run after every round. The plan needs the requirements and the\nmarket; the personas need the vision and the market; the foundation and the placement\nneed the plan. Re-run the lane on an application whose plan exists and the first round\nalready offers the three that follow it.\n\n## Selecting the next children\n\n- **Missing beats present.** A plan or a placement already on record is not\n re-derived unless what it was derived from has been re-derived in this run.\n- **The runner-owned steps run once.** The foundation and the personas land nothing\n the runtime marks delivered, so they stay eligible; the round history is the record\n that they ran. Do not spend a round on either a second time.\n- **Independent children share a round.** The personas and the foundation both need\n only the plan and can run beside each other.\n- **A child waiting on the creator is not offered** — an unanswered interview, or a\n suspended clarification. Run everything else, and stop when nothing eligible advances\n the conception.\n\n## Composing an objective for a child\n\nFor the domain plan, name the requirements the plan must route and the market ICPs it\nserves. For a re-derivation, name what placement or the build reported the plan could\nnot route — that is the whole objective. For placement, name the modules the plan\ndeclares and the audiences that reach them.\n\n## When the build sends the application back\n\nThe root re-opens this lane when the build lane's decomposer finds the conception unbuildable\n(`conception-buildable` GAP, #1638). The round history names the criterion, and the objective you\nare given carries the decomposer's reason. Revise the leaf that owns the faulted element, which is\nusually the domain plan: a module, resource or relationship no build target can express, or a\nreference another family makes to something the plan does not declare. A composition surface no\nplan realises belongs to the surface plan it names. Do not re-derive the whole conception: the\nleaves the fault does not touch are still right, and re-deriving them makes the build re-plan work\nthat was sound.\n\n## When to stop\n\nStop when the placement plan is on record AND every surface the capability composition\ndecided is planned: the placement plan is the decision this lane ends on, but it depends\nonly on the domain plan, so it can land while the composition's surfaces are still\nunplanned. A website or documentation portal the composition marks NEEDED, with no\nwebsite plan or documentation plan on record, is a surface the build decomposition will\nemit no task for — and nothing downstream says so. Offer its plan before stopping. The\ncoherence report names the gap as `composition-surface-not-planned`.\n\nStop also when nothing eligible advances the conception — the plan suspended on a\nclarification, or an interview is unanswered — and say which.\n\n## What the creator reviews\n\nThe domain plan and the placement plan, exactly as each leaf's own review guide says;\nthe composed application in the working tree, through `git status`; and the accepted\ncharters. The decision this lane ends on: the conception is accepted, or returned to\nthe domain plan with what could not be routed.\n",
70
+ "skillRefs": [],
71
+ "skillBodyRefs": [],
72
+ "contextSources": [],
73
+ "draftableDocumentDefinitionRefs": [],
74
+ "choreography": {
75
+ "admits": [
76
+ "bottom_up.placement-plan",
77
+ "bottom_up.documentation-plan",
78
+ "bottom_up.website-plan",
79
+ "bottom_up.experience-plan",
80
+ "bottom_up.integration-plan",
81
+ "bottom_up.foundation",
82
+ "bottom_up.capability-composition",
83
+ "top_down.expert-personas",
84
+ "bottom_up.domain-plan"
85
+ ],
86
+ "maximumIterations": 12,
87
+ "maximumLanesPerIteration": 3,
88
+ "maximumDepth": 1,
89
+ "maximumDurationMs": 5400000
90
+ },
91
+ "suspendsForClarification": false,
92
+ "briefAdequacyGate": false,
93
+ "briefAdequacyExcludedSources": []
94
+ },
95
+ "approval": "approve_result",
96
+ "budget": {},
97
+ "onFailure": "keep_and_flag"
98
+ }