@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
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.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +170 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +27 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"ref": "bottom_up.foundation",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"phase": "bottom_up",
|
|
5
5
|
"intent": "Bottom-up foundation — turn the approved domain plan and top-down definitions into a configured, bootable application skeleton. For a fresh application, use wildo init in an empty destination before refining its generated configuration; preserve existing projects and use their repair/composition paths. Author capabilities, modules and providers from the approved plan, verify application knowledge delivery (wildo assets sync refreshes installed assets), then run wildo setup --non-interactive and wildo local init with their prerequisites. These tools exist; their successful invocation and postconditions must be observed in the current run. The registered foundation executor composes module/resource shells and tenancy configuration; it does not run this full init/assets/setup sequence. This methodology states the prerequisites and postconditions to fulfil around that execution. It emits no artifact: the deliverable is the application source, configured module registrations and verified initialization. Record the reasons for configuration choices beside those choices. Runs after the domain plan is approved in the bottom_up phase; business resource implementation belongs to the later build work.",
|
|
6
6
|
"preconditions": [
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
"outputs": [],
|
|
47
47
|
"stepOutputs": [],
|
|
48
48
|
"method": {
|
|
49
|
-
"guidance": "# Foundation — Domain Plan → Configured, Bootable App Skeleton (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\nThis method composes existing tooling: `wildo init` creates the SaaS skeleton and\nattempts knowledge delivery, `wildo assets sync` refreshes that knowledge, and\n`wildo setup --non-interactive` followed by `wildo local init` configures and verifies\nthe local environment. It is guidance consumed by the application-creation lane,\nnot an automatically executed CLI script. The registered foundation executor composes\nmodule and resource shells and tenancy configuration from the domain plan; it does\nnot execute this full init/assets/setup sequence. Fulfil those prerequisites and\npostconditions separately and record actual command outcomes. Tool availability\nalone does not prove that a foundation run succeeded.\n\n## Where you are in the journey\n\nThis is the **foundation** playbook — the point in the **bottom-up** phase where\nthe *plan* becomes a *bootable app*. It runs **after** the `bottom_up.domain-plan`\nplaybook produced (and the creator approved) the **domain plan**: the module\ndecomposition, the per-module resource inventory, and the inter-resource\nrelationship intents. Its preconditions — `phase_is bottom_up` and\n`artifact_exists domain-plan` and `artifact_expected vision-brief` — mean the journey\nhas entered the build-shaping phase and the load-bearing artifact is present: the\n**domain plan**, whose modules are registered and whose tenancy decides two of the three\nderived capabilities. The vision is SEQUENCING here rather than readiness (#1434): nothing\nin this playbook reads its content, and it is enforced harder upstream — the market\nsnapshot and the requirements both gate on it, and the domain plan gates on those. The\nroute-bound `transition_committed` fact that authorized and applied crossing from top-down into\nbottom-up was the domain-plan playbook's duty (it is the first bottom-up playbook);\nyou do not re-cross that boundary — the domain plan's existence already sits behind\nit.\n\nYou are not re-opening the domain plan here — you are turning an *approved* plan\ninto the *configured application skeleton the build loop then fills in*.\n\n## What this playbook does\n\nYou are the **foundation engineer**. This playbook reads the approved domain plan\nand the vision brief, then configures and brings up the application skeleton so the\nbuild loop has a real workspace to author into. First inspect the destination: create\na fresh skeleton with `wildo init` in an empty directory, or preserve the existing\napplication. Then perform the configuration-authoring and bring-up steps below.\nThe method describes their order; it does not itself execute the commands.\n\n1. **The engine capabilities are DERIVED for you**, from the approved domain plan's tenancy and the\n business model's revenue model. You do not choose them — see \"Engine capabilities\" below.\n2. **Declare the domain-plan's modules** at the SaaS root (they are registered across\n the runtimes after the skeleton is present, so it boots with them).\n3. **Select the providers** the enabled capabilities need.\n4. **Record the compliance declarations you were given** — the operating entity and\n the jurisdictions, from the elicitation answers, into `./wildo.saas.config.ts`.\n See `config-saas` and its `references/compliance-declarations.md`.\n5. **Verify and bring up the configured project** — check the existing skeleton\n and knowledge delivery, run `wildo setup --non-interactive`, then `wildo local init`.\n\nYou emit **no artifact**. The deliverable is the app itself: `./wildo.saas.config.ts`,\nthe materialized skeleton, and a verified local initialization. Record *why* each\ncapability, module and provider was chosen in the config's own comments, where the\nnext reader of that file will find it.\n\nThis is a **foundation pass**. You enable capabilities, declare modules as shells,\nselect providers, and bring the skeleton up. Deterministic composition may create\nresource shells from the domain plan. Business-specific fields, processing, UI behavior,\nviews and navigation are the downstream build work; a generated shell does not\ncomplete that work.\n\n## Read state first — the artifacts you read, the files you write\n\nThis playbook is **idempotent** and, on a re-run, a *refinement*. Before configuring\nanything, inspect the target directory. For a new application, run `wildo init`\nin an empty destination first, then refine its generated configuration from the\napproved plan. Do not write the planned config into an empty destination and then\nexpect initial scaffolding to merge around it. For an existing application, keep\nits source and use the documented repair/composition paths; never scaffold over it.\nThen:\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 domain plan is present and\n approved, and check whether a `./wildo.saas.config.ts` already exists from an\n earlier run (refine it, do not re-author — see below).\n2. Read the **domain plan** (`domain-plan` family — the modules to register + their\n resource inventory). The executor also reads the landed **business model** if there is\n one, for the billing capability alone; it may legitimately be absent, per the top-down\n phase-gate's optional posture.\n\n **Nothing else is read.** This list used to continue with the market snapshot (\"its ICPs sharpen\n capability selection\"), the requirements and the roadmap (\"which modules are MVP-critical, so you\n enable what the first release needs\"). None of the three reaches the executor, and none ever did\n (#1434). They are no longer declared as inputs either, so the declaration and the prose now say\n the same thing.\n\n// Operator affordances (the executor itself is handed the domain-plan VALUE directly):\n// `wildo context journey` — the eligibility board, runs in flight\n// `wildo context info specification-artifacts` — per-family landed state and rendered content\n\nThe executor **reads** `domain-plan` (handed to it, relationship drafts included) and the landed\n`business-model`; it **writes** `./wildo.saas.config.ts` and the materialized skeleton — app files,\ncommitted to git, which is where the record of what was decided lives.\n\nThis line used to name six families (#1434). Four of them reached nothing.\n\n## Step 1 — Derive and enable the engine capabilities\n\nEngine capabilities are the framework surfaces the app turns on (organizations, billing,\nnotifications, audit trails, and so on). **THE EXECUTOR DERIVES THEM. Nothing here chooses one.**\n\nExactly three are derivable today, and each from one declared value:\n\n| capability | derived from |\n|---|---|\n| `ORGANIZATIONS` | the domain plan's `tenancy` is `organizations` |\n| `EMAIL_TRANSACTIONAL` | the same — tenant invitations send mail |\n| `BILLING` | the business model's revenue model charges users |\n\n**The application's line can exclude a capability, and then nothing derives it.** An internal tool has no billing at\nall: on that line the `billing-provider` question is not asked, the executor never enables `BILLING` whatever else\nimplies it, and a configuration that enables it anyway is reported on the run result as contradicting the line\n(`engineCapabilitiesContradictingLine`), never switched off for you.\n\n**Compliance constraints do NOT select a capability, and this method said for months that they were\n\"the primary driver\".** They are not, and the reason is recorded where the derivation lives\n(`FOUNDATION_CAPABILITY_BASIS`, which is TOTAL over the capability vocabulary and names why each\nremaining one is underivable). The clearest case is the one this method used to point at: where an\naudit trail must LIVE — a ledger, a SIEM — is an operator decision about retention and independence\nrather than a product fact, and leaving that capability out removes no control objective, because\nassurance reads the application's own audit store.\n\nA capability nothing derives is not enabled by guessing. It is enabled deliberately, later, by\nwhoever decides it — which is why the basis map records a reason per capability instead of a\nquestion.\n\nHistorical note, kept because it is the defect rather than a detail (#1434): this section described a\nderivation the runtime cannot perform — four steps of \"walk the constraints\", \"treat these as\nsharpeners\", \"every enabled capability must trace to a compliance constraint\" — and a reader believed\ncompliance constraints shaped the foundation. Nothing walked anything. The market snapshot, the\nrequirements and the roadmap were declared inputs of this playbook for the same reason and reached\nthe same nobody; they are no longer declared.\n\nThe `config-saas` skill carries the vocabulary for the `engineCapabilities` block of\n`./wildo.saas.config.ts`. The executor writes that block; read the skill when you need to understand\nwhat an enabled capability means, not to decide one.\n\n## Step 1b — Apply the capability composition's optional packages\n\nWhen a `capability-composition` has landed (`bottom_up.capability-composition`), the executor\napplies every scenario it marks NEEDED after the domain scenarios below — the marketing website\n(`add-website`) and the documentation portal (`add-technical-doc`) today — with the application's\nown host facts: its slug and display name from `wildo.saas.config.ts`, the public domain from its\ninfrastructure environments (a remote one first, `localhost` when none declares one), and its port\nblock (website = app port + 1, docs = app port + 2, the convention the dogfood applications use).\nA package whose workspace already exists is left alone and reported as already composed. The run\nrecord names **every scenario applied and every scenario declined with the declaration each came\nfrom** (`compositionScenarios`), so a reader sees why the application has a website — or why not —\nwithout re-deriving it.\n\n## Step 2 — Declare the domain-plan's modules (register across runtimes after materialization)\n\nThe skeleton supplies the root workspaces and registry structure; declaring a\nmodule in configuration alone does not implement its package or contributions.\n\n1. **Declare each approved module at the SaaS root.** Use `config-saas` for the\n module's application configuration and preserve existing module identifiers.\n2. **Materialize and register module shells.** Use the delivered module-composition\n scenario and `module-registration` guidance to create the corresponding shared,\n backend and frontend contributions. Inspect the resulting registry exports;\n `config sync` is not a substitute for authored module implementation. At foundation\n depth the shells must load; business-specific resource behavior remains the build\n loop's work.\n3. **Declare every domain-plan module — and no more.** A module the domain plan named\n that is missing from the config is a GAP; a module in the config the domain plan did\n not name is an unjustified-module CONCERN. Record the declared modules (each traced\n to its domain-plan module) as a comment beside it in the config.\n\n**Do not author the resources here.** The domain plan's per-module resource inventory\ntells you *what* resources each module will own, but authoring their schemas, fields,\nand config is the **build loop's** job. If you catch yourself writing a resource\nschema, stop: that is out of this playbook's depth.\n\n## Step 3 — Select the providers\n\nEnabled capabilities that reach an external service need a **provider** (billing → a\npayment provider; notifications/email → an email provider; file storage → an object\nstore). For each such capability, select and wire the provider scope +\n`providerConfigurations` in `./wildo.saas.config.ts` (the `config-saas` skill covers\nthe provider surfaces). A value the vendor issues per deployment — an OAuth client ID, a\nfrontend SDK DSN — is authored in each environment's\n`./infrastructure/<env>/wildo.infra.<env>.config.ts > providerConfigurations` instead (the\n`infra-environment-config` skill):\n\n- **Every provider matches a declared capability.** A provider wired for no enabled\n capability is a CONCERN; an enabled capability that needs a provider with none\n selected is a GAP.\n- **Do not seed secrets here.** Provider *selection* (which provider, which scope) is\n foundation; the per-environment secret material is seeded by the deterministic\n bring-up / environment step, not authored inline. Record the selected providers\n (each matched to its capability) as a comment beside it in the config.\n\n**The choice itself is the creator's, and the interview carries it.** Billing and SMS are\nthe two capabilities whose every provider needs an account, so the executor cannot pick one:\nit reads the `billing-provider` and `sms-provider` answers from the dossier, declares the chosen\nprovider in the backend scope, selects it as primary and enables the capability. The provider's\nrequired credentials are recorded on the run result as OWED — the application boots, and the\nprovider answers once an operator sets them. Answering `none` — the interview requires an answer to\nevery question, so \"decide later\" is an option — leaves the capability owed exactly as before. The\noptions are the engine providers serving the capability plus `none`; the interview validator refuses\nanything else before the run starts. Email is the exception the executor decides itself: it has a\ncredential-free development substitute (`email-preview`) and needs no choice.\n\n## Step 4 — Record the compliance declarations (only what you were told)\n\nThe creator answered `operating-entity` and `operating-jurisdictions`. Write those answers\ninto `operatorComplianceIdentity` and `operatingJurisdictions`, and **nothing else**.\n\n- **Record the PART you were given.** Every part of `operatorComplianceIdentity` is\n independently declarable, so a creator who named the company and not its lawful bases\n gets `legalEntityName` and `registeredAddress` written and the rest left absent. A\n missing part is reported downstream as outstanding; it does not block anything here.\n- **NEVER invent one.** Not a company name, not an address, not a privacy contact, and\n above all not a lawful basis — that is a legal determination, and `CONSENT` in\n particular would tell a person their data rests on an agreement they could withdraw.\n A produced privacy notice quotes these as fact. An absent declaration is reported as an\n open gap a reader can see; an invented one is published.\n- **Omit the key entirely when you were told nothing.** Absence means \"nobody answered\",\n which is the honest state and the one every consumer already renders correctly. An\n empty object is refused by the schema precisely because it would satisfy the field while\n disclosing nothing.\n- **A jurisdiction needs its `basis`.** \"eu\" alone does not say whether you are established\n there, sell there, or hold data about people there, and those imply different obligations.\n If the creator gave a place without a reason, record neither — ask, or leave it out.\n\nThis step CANNOT fail the run. If the creator answered nothing, write nothing and continue:\nthe application boots, and the gap is visible where it matters rather than here.\n\n(A `foundation-manifest` artifact was declared here until 2026-08-25 and is now\nretired with the app-creation verification/digest aspect. It was a bookkeeping record\nof decisions the config already carries — deleting it costs no fact about the app.)\n\n## Step 5 — Verify materialization and bring up the environment\n\nRun the existing commands from the intended application root with their documented\nprerequisites. Keep application structure, delivered knowledge and running services\nas separately verified results.\n\n1. **Verify the skeleton.** A fresh project starts with `wildo init` in an empty\n destination before the configuration-authoring steps above. Check `frontend/`,\n `shared-lib/`, `backend-api/`, `specifications/` and the generated configuration.\n On a repeat run, preserve existing source; use init's repair path or the relevant\n composition scenario instead of regenerating the project as a new application.\n\n2. **Verify application knowledge delivery.** Init attempts delivery from the\n installed packages and reports delivered or skipped assets. If dependency\n installation was skipped or a package is unavailable, install the required\n packages, then refresh the supported skills/rules and framework assets:\n\n ```bash\n wildo assets sync\n ```\n\n <!-- fwk-provenance-waiver: the command below is named in order to be REFUSED — `wildo fwk` needs a framework workspace and errors inside a generated application, which is exactly why an agent that might reach for it has to recognise the name; translating it away would leave the prohibition with nothing to prohibit. -->\n Read the result and inspect the delivered application guidance. Do not assume\n arbitrary agents/hooks are installed, and do not substitute a framework-developer\n delivery flow for this one — this command is how an application receives them.\n\n3. **Run setup** — configure the app from the authored `./wildo.saas.config.ts` and\n the `./infrastructure/` env configs (the `infra-environment-config` skill owns the\n typed infra env files; the `local-environment-bootstrap` skill owns the `wildo`\n lifecycle). Headless setup is registered and fail-closed on the administrator seed\n environment variables; it mints the environment generation without placeholders.\n\n ```bash\n wildo setup --non-interactive\n ```\n\n4. **Initialize and verify the project** — run the registered convergence journey.\n It regenerates artifacts, starts and readiness-gates backing services, reconciles\n platform Mongo state and credentials, starts native platform services, registers the\n app once, emits all runtime projections, and executes a signed managed-config read.\n\n ```bash\n wildo local init\n ```\n\n5. **Know what a PostgreSQL store owes — and that you do not write its baseline here.** Read the\n store selection you authored in the infra env config:\n\n ```bash\n rg -n \"applicationDatabase\" infrastructure/*/wildo.infra.*.config.ts\n ```\n\n Absent, or MongoDB: there is nothing to do — a collection exists on first write, there is no\n plan, and no migration is ever owed.\n\n `engine: DatabaseEngine.POSTGRESQL`: nothing creates a table implicitly, so until the INITIAL\n migration exists the backend refuses to boot on every table it declares. Do NOT accept a baseline\n with `wildo db diff --update-lockfile`: that writes the lockfile and NO migration, so it records a\n plan whose tables were never created and the boot gate still refuses.\n\n The build loop owns that migration. For an application that declares PostgreSQL and has no\n `backend-api/migrations/schema-plan.lock.json`, the dispatch host derives a `database-migrations`\n step; it runs `wildo db generate`, which, with no lockfile, renders the whole model as the initial\n migration and writes the baseline in the same invocation. The two are one change and are committed\n together. It needs a built `backend-api` (the plan is computed by importing the compiled backend\n registry), so report the store you found and leave the migration to that step.\n\nReport the status of each bring-up step to the creator from its real exit and\npostcondition results. A skipped knowledge delivery or unsuccessful initialization\nis not completion, even when source files exist.\n\n## Refine, don't re-author\n\n- **Keep what still holds.** On a re-run, do not disable a capability, drop a module,\n or re-select a provider that is already correct. Only enable a newly-justified\n capability, register a newly-added domain-plan module, or correct a provider where\n the definition set genuinely changed.\n- **Reuse existing module ids and provider scopes.** A module already registered keeps\n its id; a provider already selected keeps its scope — never mint a second one for the\n same module/capability.\n- **Follow the definition set.** If the domain plan added a module since the last run,\n reflect it (register the module) — do not re-derive the whole configuration from\n scratch. The delta is visible in `git diff` on the config, which is the record. A new\n compliance constraint does NOT enable a capability here; see Step 1 for why.\n\n## Quality gate — `foundation-configured-coherently` (declarative at scaffold depth)\n\nThe foundation is checked against the `foundation-configured-coherently` **reviewer\nchecklist** (see the end of this method): five invariants (capability derivation, module registration, provider coverage,\nsequence order, and foundation-depth boundary discipline), each marked PASS / CONCERN /\nGAP.\n\nThis checklist is **declarative**: no runtime executes it (rubric-only judge gates were retired at the flexible-intelligence hard cut — judgment runs only through a compiled Evaluation Treatment, and this playbook has none yet), so it ships as the **creator's review checklist** — nothing runs it automatically. The **trust floor** for accepting the foundation today is the\ncreator's `approve_result` review of the produced config and the bring-up result. There is\nintentionally **no deterministic gate**: config validation is a `wildo` CLI concern\n(`config sync` / validate), not a validator in the journey-artifact schemaRef\nvocabulary. Existing command permission and effect boundaries apply independently\nof this reviewer checklist.\n\n## Scaffold-depth boundary\n\nKeep this playbook at foundation depth. Explicitly **out of scope here**:\n\n- **Implementing replacement CLI tooling.** Use the existing init, asset delivery,\n setup and local initialization owners. If a command fails, retain its diagnostic\n evidence and resolve the prerequisite or concrete defect rather than inventing\n another materializer inside the application.\n- **Resource / field / schema authoring.** The config declares modules as shells and\n enables capabilities. The foundation executor can materialize resource shells\n and scope them to the chosen tenancy. Filling those shells with business-specific\n fields, rules, UI behavior, views and navigation belongs to the later build work.\n- **Re-introducing a foundation artifact.** The `foundation-manifest` family was\n retired on 2026-08-25 with the app-creation verification/digest aspect. Do **NOT**\n reshape `_core` to bring it back: the config file and its git history already carry\n every decision it recorded.\n- **Deep capability / provider modelling.** A defended capability-selection model\n (per-compliance-regime obligation → capability mapping, provider cost/feature\n matrices, multi-provider fallback) is a later depth pass. You derive capabilities\n from the definition set with the v1 heuristic above — not a solved obligation graph.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at scaffold\ndepth — deeper capability modelling belongs to a dedicated later pass,\nholistically.\n\n## What you emit\n\n- The authored **`./wildo.saas.config.ts`** (an app file) — the enabled engine\n capabilities, the registered modules, and the selected providers — plus the\n registered module shells across the runtimes and the\n brought-up skeleton.\n- The **bring-up result** reported to the creator: the status of each step, taken from\n its real exit/postcondition rather than from intent. This is a report, not a stored\n artifact — nothing reads it back.\n\nThe creator reviews the result (approval posture `approve_result`) before it is\naccepted as the journey's foundation, which the bottom-up build loop then fills in\nwith authored resources, operations, UX, and integrations.\n\n## References\n\n- `.claude/skills/config-saas/SKILL.md` — the `./wildo.saas.config.ts` authoring\n surface: `engineCapabilities`, `modules`, provider scopes, and `providerConfigurations`.\n- `.claude/skills/module-registration/SKILL.md` — register each domain-plan module\n across the shared / frontend / backend registries so the skeleton boots with it\n (distinct from `config-saas`, which only declares module existence at the root).\n- `.claude/skills/infra-environment-config/SKILL.md` — the typed `./infrastructure/`\n environment configs (backing services, public domain, service auth) the bring-up needs.\n- `.claude/skills/local-environment-bootstrap/SKILL.md` — the `wildo` lifecycle\n (`setup`, `local init`, `local reinit`, `local dev`) for deterministic initialization,\n repair, clean-room recovery, and runtime start.\n\n## Reviewer checklist — `foundation-configured-coherently`\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 maintained here as guidance against the current tooling:\n\nJudge whether the authored foundation (the ./wildo.saas.config.ts composition + the materialized skeleton) is a coherent realisation of the approved domain plan and the top-down definition set. Assess five invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) CAPABILITY DERIVATION — every enabled engine capability traces to a compliance/vision, business-model, market, or domain-plan need; unjustified capabilities are a CONCERN and missing required capabilities are a GAP. (2) MODULE REGISTRATION — every approved domain-plan module is declared and registered across runtimes; missing modules are a GAP and extra modules are a CONCERN. (3) PROVIDER COVERAGE — every provider serves a declared capability and every provider-backed capability has a provider. (4) SEQUENCE ORDER AND PROOF — materialize a fresh skeleton in an empty destination (or preserve an existing project) → refine config and module registrations → verify knowledge delivery → wildo setup --non-interactive → wildo local init. Treat setup intent, container health, or an initialization marker as insufficient: local init must reach its signed managed-config-read postcondition. (5) BOUNDARY DISCIPLINE — stay at foundation depth: deterministic resource shells are allowed, but business-specific fields, processing, UI behavior, views and navigation belong to later build work. Use the existing init/assets owners; do not replace them. Headless setup and local init run once their prerequisites are satisfied. This reviewer checklist is declarative; creator approval is the trust floor.\n",
|
|
49
|
+
"guidance": "# Foundation — Domain Plan → Configured, Bootable App Skeleton (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\nThis method composes existing tooling: `wildo init` creates the SaaS skeleton and\nattempts knowledge delivery, `wildo assets sync` refreshes that knowledge, and\n`wildo setup --non-interactive` followed by `wildo local init` configures and verifies\nthe local environment. It is guidance consumed by the application-creation lane,\nnot an automatically executed CLI script. The registered foundation executor composes\nmodule and resource shells and tenancy configuration from the domain plan; it does\nnot execute this full init/assets/setup sequence. Fulfil those prerequisites and\npostconditions separately and record actual command outcomes. Tool availability\nalone does not prove that a foundation run succeeded.\n\n## Where you are in the journey\n\nThis is the **foundation** playbook — the point in the **bottom-up** phase where\nthe *plan* becomes a *bootable app*. It runs **after** the `bottom_up.domain-plan`\nplaybook produced (and the creator approved) the **domain plan**: the module\ndecomposition, the per-module resource inventory, and the inter-resource\nrelationship intents. Its preconditions — `phase_is bottom_up` and\n`artifact_exists domain-plan` and `artifact_expected vision-brief` — mean the journey\nhas entered the build-shaping phase and the load-bearing artifact is present: the\n**domain plan**, whose modules are registered and whose tenancy decides two of the three\nderived capabilities. The vision is SEQUENCING here rather than readiness (#1434): nothing\nin this playbook reads its content, and it is enforced harder upstream — the market\nsnapshot and the requirements both gate on it, and the domain plan gates on those. The\nroute-bound `transition_committed` fact that authorized and applied crossing from top-down into\nbottom-up was the domain-plan playbook's duty (it is the first bottom-up playbook);\nyou do not re-cross that boundary — the domain plan's existence already sits behind\nit.\n\nYou are not re-opening the domain plan here — you are turning an *approved* plan\ninto the *configured application skeleton the build loop then fills in*.\n\n## What this playbook does\n\nYou are the **foundation engineer**. This playbook reads the approved domain plan\nand the vision brief, then configures and brings up the application skeleton so the\nbuild loop has a real workspace to author into. First inspect the destination: create\na fresh skeleton with `wildo init` in an empty directory, or preserve the existing\napplication. Then perform the configuration-authoring and bring-up steps below.\nThe method describes their order; it does not itself execute the commands.\n\n1. **The engine capabilities are DERIVED for you**, from the approved domain plan's tenancy and the\n business model's revenue model. You do not choose them — see \"Engine capabilities\" below.\n2. **Declare the domain-plan's modules** at the SaaS root (they are registered across\n the runtimes after the skeleton is present, so it boots with them).\n3. **Select the providers** the enabled capabilities need.\n4. **Record the compliance declarations you were given** — the operating entity and\n the jurisdictions, from the elicitation answers, into `./wildo.saas.config.ts`.\n See `config-saas` and its `references/compliance-declarations.md`.\n5. **Verify and bring up the configured project** — check the existing skeleton\n and knowledge delivery, run `wildo setup --non-interactive`, then `wildo local init`.\n\nYou emit **no artifact**. The deliverable is the app itself: `./wildo.saas.config.ts`,\nthe materialized skeleton, and a verified local initialization. Record *why* each\ncapability, module and provider was chosen in the config's own comments, where the\nnext reader of that file will find it.\n\nThis is a **foundation pass**. You enable capabilities, declare modules as shells,\nselect providers, and bring the skeleton up. Deterministic composition may create\nresource shells from the domain plan. Business-specific fields, processing, UI behavior,\nviews and navigation are the downstream build work; a generated shell does not\ncomplete that work.\n\n## Read state first — the artifacts you read, the files you write\n\nThis playbook is **idempotent** and, on a re-run, a *refinement*. Before configuring\nanything, inspect the target directory. For a new application, run `wildo init`\nin an empty destination first, then refine its generated configuration from the\napproved plan. Do not write the planned config into an empty destination and then\nexpect initial scaffolding to merge around it. For an existing application, keep\nits source and use the documented repair/composition paths; never scaffold over it.\nThen:\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 domain plan is present and\n approved, and check whether a `./wildo.saas.config.ts` already exists from an\n earlier run (refine it, do not re-author — see below).\n2. Read the **domain plan** (`domain-plan` family — the modules to register + their\n resource inventory). The executor also reads the landed **business model** if there is\n one, for the billing capability alone; it may legitimately be absent, per the top-down\n phase-gate's optional posture.\n\n **Nothing else is read.** This list used to continue with the market snapshot (\"its ICPs sharpen\n capability selection\"), the requirements and the roadmap (\"which modules are MVP-critical, so you\n enable what the first release needs\"). None of the three reaches the executor, and none ever did\n (#1434). They are no longer declared as inputs either, so the declaration and the prose now say\n the same thing.\n\n// Operator affordances (the executor itself is handed the domain-plan VALUE directly):\n// `wildo context journey` — the eligibility board, runs in flight\n// `wildo context info specification-artifacts` — per-family landed state and rendered content\n\nThe executor **reads** `domain-plan` (handed to it, relationship drafts included) and the landed\n`business-model`; it **writes** `./wildo.saas.config.ts` and the materialized skeleton — app files,\ncommitted to git, which is where the record of what was decided lives.\n\nThis line used to name six families (#1434). Four of them reached nothing.\n\n## Step 1 — Derive and enable the engine capabilities\n\nEngine capabilities are the framework surfaces the app turns on (organizations, billing,\nnotifications, audit trails, and so on). **THE EXECUTOR DERIVES THEM. Nothing here chooses one.**\n\nExactly three are derivable today, and each from one declared value:\n\n| capability | derived from |\n|---|---|\n| `ORGANIZATIONS` | the domain plan's `tenancy` is `organizations` |\n| `EMAIL_TRANSACTIONAL` | the same — tenant invitations send mail |\n| `BILLING` | the business model's revenue model charges users |\n\n**The application's line can exclude a capability, and then nothing derives it.** An internal tool has no billing at\nall: on that line the `billing-provider` question is not asked, the executor never enables `BILLING` whatever else\nimplies it, and a configuration that enables it anyway is reported on the run result as contradicting the line\n(`engineCapabilitiesContradictingLine`), never switched off for you.\n\n**Compliance constraints do NOT select a capability, and this method said for months that they were\n\"the primary driver\".** They are not, and the reason is recorded where the derivation lives\n(`FOUNDATION_CAPABILITY_BASIS`, which is TOTAL over the capability vocabulary and names why each\nremaining one is underivable). The clearest case is the one this method used to point at: where an\naudit trail must LIVE — a ledger, a SIEM — is an operator decision about retention and independence\nrather than a product fact, and leaving that capability out removes no control objective, because\nassurance reads the application's own audit store.\n\nA capability nothing derives is not enabled by guessing. It is enabled deliberately, later, by\nwhoever decides it — which is why the basis map records a reason per capability instead of a\nquestion.\n\nHistorical note, kept because it is the defect rather than a detail (#1434): this section described a\nderivation the runtime cannot perform — four steps of \"walk the constraints\", \"treat these as\nsharpeners\", \"every enabled capability must trace to a compliance constraint\" — and a reader believed\ncompliance constraints shaped the foundation. Nothing walked anything. The market snapshot, the\nrequirements and the roadmap were declared inputs of this playbook for the same reason and reached\nthe same nobody; they are no longer declared.\n\nThe `config-saas` skill carries the vocabulary for the `engineCapabilities` block of\n`./wildo.saas.config.ts`. The executor writes that block; read the skill when you need to understand\nwhat an enabled capability means, not to decide one.\n\n## Step 1b — Apply the capability composition's optional packages\n\nWhen a `capability-composition` has landed (`bottom_up.capability-composition`), the executor\napplies every scenario it marks NEEDED after the domain scenarios below — the marketing website\n(`add-website`) and the documentation portal (`add-technical-doc`) today — with the application's\nown host facts: its slug and display name from `wildo.saas.config.ts`, the public domain from its\ninfrastructure environments (a remote one first, `localhost` when none declares one), and its port\nblock (website = app port + 1, docs = app port + 2, the convention the dogfood applications use).\nA package whose workspace already exists is left alone and reported as already composed. The run\nrecord names **every scenario applied and every scenario declined with the declaration each came\nfrom** (`compositionScenarios`), so a reader sees why the application has a website — or why not —\nwithout re-deriving it.\n\n## Step 1c — Lay down the line's access posture (internal tool)\n\nWho may hold an account is, for an internal tool, decided by what the application IS: the company's own people,\nadmitted by the company. So the executor, after declaring the organization type that owns the application, writes the\nline's posture through the same function the `wildo/internal-tool` blueprint applies at `wildo init --line`\n(`applyLineAccessPosture`), and reports it on the run result as `accessPosture`:\n\n| what | written | decided by |\n|---|---|---|\n| `userTypes.<each user type of the owner>.auth.registration.mode` in `./backend-api/src/saas-config.backend.ts` | `RegistrationMode.INVITATION_ONLY` | the line (not asked) |\n| organization creation | nothing to write: no door creates an organization of the owner type, and the configuration refuses a `creationPolicy` or `selfServiceCreation` on it | the line, through the owner it declares |\n| `[AuthMethod.ORG_OPENID_CONNECT]` and `[AuthMethod.ORG_SAML]` on those user types, and `CoreFeature.SINGLE_SIGN_ON` in the default feature profile | `true` / granted | the `corporate-identity` answer: `identity_provider` or `identity_provider_and_directory` |\n| `scimProvisioning` on the owner organization type, and `CoreFeature.DIRECTORY_PROVISIONING` | `{ enabled: true }` / granted | the `corporate-identity` answer: `identity_provider_and_directory` |\n\nOnly an internal tool is asked `corporate-identity`; every other line, and an application with no line yet, is not.\nWhen it is unanswered, the domain plan's owner type joining as `DIRECTORY_PROVISIONED` counts as\n`identity_provider_and_directory`; when the answer and the plan disagree, the answer is applied and the disagreement is\nlisted in `accessPosture.owed`. `none` writes nothing, and nothing already open is switched off. What the run cannot\nwrite (no owner type, user types it cannot read, a file shape it cannot address, a user type no owner lists) is listed\nthere too, with its remedy; nothing is guessed.\n\n`frontendServices.<app>.usersManagement.<user type>.register` stays as declared. It gates self-service sign-up at the\nfrontend service (password sign-up and social sign-up alike), which invitation-only registration already refuses at\nthe API, and the backend logs the overlap at startup; accepting an invitation does not read it.\n\nWhat this does NOT set up: the identity-provider connection, the verified domain and the SCIM token. Those carry\nsecrets or proofs and are records the company creates in the running application, through the product. The SHAPE of the\ncompany's identity set-up (its units, its directory's department mapping, its single sign-on posture) is a committed\ndeclaration, authored next.\n\n**The organization identity declaration.** Once the owner type is found and the corporate identity is known, the executor\nwrites `./backend-api/src/organization-identity.ts` (`APPLICATION_ORGANIZATION_IDENTITY`) and passes it as\n`organizationIdentity` in `./backend-api/src/bootstrap-config.ts`, before the host's overrides\n(`composeOwnerOrganizationIdentityDeclaration`). The backend applies it at every boot to the owner organization. It is\nreported on the run result as `organizationIdentity`:\n\n| part | written | decided by |\n|---|---|---|\n| `singleSignOn` | `requireSSO: true`, `requireEnterpriseSSOOnly: true`, `allowPasswordFallback: true`, no break-glass account | the `corporate-identity` answer: `identity_provider` or `identity_provider_and_directory`; `none` declares no posture |\n| `units` | empty | nothing typed names the company's units: OWED, never invented |\n| `directory` | not declared | each binding names a declared unit, so it is OWED with the units (`identity_provider_and_directory`) |\n| `name` | not declared | nothing typed names the company: OWED, never invented. Until it is added, every person reads the platform's placeholder \"Default Organization\"; the backend writes a declared name over that placeholder only: once the organization is named, a changed `name` is reported as drift (with the rename that adopts it), never written over the stored name |\n\nPasswords stay allowed until the company names an emergency administrator: refusing them with no break-glass account\nwould lock the company out the day its identity provider is unreachable. The owed list says to name one in\n`singleSignOn.breakGlassAccounts` and then set `allowPasswordFallback: false`. The file is rewritten only while it is\nexactly what a derivation wrote; once someone edits it (units added, an account named), it is kept and the run says so.\nAn unanswered `corporate-identity` writes nothing and is owed.\n\n**The owner type takes the domain plan's names, through a declared rename.** The platform seeds the owner\norganization for the first administrator, typed from the configuration, when the application is initialized. The\ncreation playbooks run on a started application, so by the time this step runs it usually has been, and an\norganization's type and a user's types are fixed at creation. So where the domain plan names the owner type or its\npeople differently (`group`, `employee` against the scaffold's `workspace`, `member`), the executor RENAMES them before\nlaying the posture down (`renameOwnerToDomainPlanNames`): the new keys carry `renamedFrom` naming the old ones, every\nreference follows (the first administrator's user types, the frontends' user management, relationship kinds), and the\nbackend re-types the seeded organization and every account still holding the old key at its next start, recording each\nat CRITICAL. The rename is all or nothing: one it cannot make (a spread key, a plan name already declared as another\ntype, several user types on either side) writes nothing and is listed in `accessPosture.owed`, for the build's\norganization-model task to finish. The build must never declare a second type with `ownsApplication`.\n\n## Step 1d — Report where records live outside the application\n\nWhen the domain plan's `organizationModel.recordLocations` puts a resource's records in a system of record (an ERP, a\nCRM), the run result lists each system under `systemsOfRecord`: its kind, the resources it holds, and the credentials its\ninstance will owe, read off the facet the `@wildo-ai/systems-of-record` library declares for that kind and named as the\nbackend reads them (`WILDO_SOR_<INSTANCE>__<SLOT>`). The instance is named by its kind (`systemsOfRecord.odoo`). Where\nthe facet offers several credential kinds, the result names them: which one the company uses is its choice. Report\nthose credentials as owed, like a provider's.\n\nThe executor declares neither the instance nor the library. The build's binding task declares the instance (vendor,\ndialect, partition, personal-data origin) against the facet; once it does, `wildo config sync` (and `wildo local dev`)\ndeclares the library on the backend and links it in one step, which is the only rule that writes both halves.\n\n## Step 2 — Declare the domain-plan's modules (register across runtimes after materialization)\n\nThe skeleton supplies the root workspaces and registry structure; declaring a\nmodule in configuration alone does not implement its package or contributions.\n\n1. **Declare each approved module at the SaaS root.** Use `config-saas` for the\n module's application configuration and preserve existing module identifiers.\n2. **Materialize and register module shells.** Use the delivered module-composition\n scenario and `module-registration` guidance to create the corresponding shared,\n backend and frontend contributions. Inspect the resulting registry exports;\n `config sync` is not a substitute for authored module implementation. At foundation\n depth the shells must load; business-specific resource behavior remains the build\n loop's work.\n3. **Declare every domain-plan module — and no more.** A module the domain plan named\n that is missing from the config is a GAP; a module in the config the domain plan did\n not name is an unjustified-module CONCERN. Record the declared modules (each traced\n to its domain-plan module) as a comment beside it in the config.\n\n**Do not author the resources here.** The domain plan's per-module resource inventory\ntells you *what* resources each module will own, but authoring their schemas, fields,\nand config is the **build loop's** job. If you catch yourself writing a resource\nschema, stop: that is out of this playbook's depth.\n\n## Step 3 — Select the providers\n\nEnabled capabilities that reach an external service need a **provider** (billing → a\npayment provider; notifications/email → an email provider; file storage → an object\nstore). For each such capability, select and wire the provider scope +\n`providerConfigurations` in `./wildo.saas.config.ts` (the `config-saas` skill covers\nthe provider surfaces). A value the vendor issues per deployment — an OAuth client ID, a\nfrontend SDK DSN — is authored in each environment's\n`./infrastructure/<env>/wildo.infra.<env>.config.ts > providerConfigurations` instead (the\n`infra-environment-config` skill):\n\n- **Every provider matches a declared capability.** A provider wired for no enabled\n capability is a CONCERN; an enabled capability that needs a provider with none\n selected is a GAP.\n- **Do not seed secrets here.** Provider *selection* (which provider, which scope) is\n foundation; the per-environment secret material is seeded by the deterministic\n bring-up / environment step, not authored inline. Record the selected providers\n (each matched to its capability) as a comment beside it in the config.\n\n**The choice itself is the creator's, and the interview carries it.** Billing and SMS are\nthe two capabilities whose every provider needs an account, so the executor cannot pick one:\nit reads the `billing-provider` and `sms-provider` answers from the dossier, declares the chosen\nprovider in the backend scope, selects it as primary and enables the capability. The provider's\nrequired credentials are recorded on the run result as OWED — the application boots, and the\nprovider answers once an operator sets them. Answering `none` — the interview requires an answer to\nevery question, so \"decide later\" is an option — leaves the capability owed exactly as before. The\noptions are the engine providers serving the capability plus `none`; the interview validator refuses\nanything else before the run starts. Email is the exception the executor decides itself: it has a\ncredential-free development substitute (`email-preview`) and needs no choice.\n\n## Step 4 — The compliance declarations are written by the executor (only what was told)\n\nNo agent writes these: the foundation executor writes them deterministically from the\ninterview, after the capabilities and the composition. Each answer follows a grammar the\ninterview holds it to at every door, so what reaches the executor is always readable.\n\n- **`operating-entity`** is labelled parts: `name: …`, `address: …`, `privacy contact: …`,\n one per line or separated by `;`. Each stated part the configuration lacks is written to\n `operatorComplianceIdentity.legalEntityName`, `.registeredAddress` or `.privacyContact`.\n Any subset is a valid answer: every part is independently declarable, and a missing one is\n reported downstream as outstanding (`wildo context launch-blockers`), never filled in.\n- **`operating-jurisdictions`** is `<code>: <why>` entries (`fr: established here; eu:\n customers resident here`). Each jurisdiction the configuration lacks is appended to\n `operatingJurisdictions.jurisdictions`, with its basis. A place without a basis is refused at\n the door: \"eu\" alone does not say which obligation applies.\n- **An authored value is never replaced.** A part or a jurisdiction the configuration already\n declares differently is kept, and the run result names it in `operatorDeclarations`. Nothing\n is removed, and nothing the interview does not ask (lawful bases, roles, hosting regions) is\n touched: those are legal or operational determinations nobody typed here.\n- **Nothing is invented.** The executor writes only text the creator gave. It never derives a\n company name, an address, a privacy contact or a lawful basis.\n- **Unanswered is an advisory, not a refusal.** A deferred or unanswered question writes\n nothing, and the run result says so. An answer stored before the grammar existed is reported\n as unreadable, with nothing written, until it is answered again.\n\nThis step CANNOT fail the run: a configuration the executor cannot read or edit is reported on\nthe run result with nothing written, and the application boots.\n\n### The data residency is written by the executor\n\nThe `data-residency-territories` answer is not prose: the interview stores it as jurisdiction\nslugs (`eu, ch`) or `none`, and the foundation executor writes it, deterministically.\n\n- **Every data-serving provider is placed first.** A provider the residency leaves exactly one\n region for (only offered vendor-hosted, one region whose places all lie inside) gets that\n region in `providerComplianceChoices`. An authored choice is never overwritten.\n- **The residency is written only when nothing is left unplaced**, into\n `operatorComplianceIdentity.dataResidency.territories`. `wildo config sync` refuses a\n declared residency that leaves a provider unplaced, so writing it earlier would stop the\n application starting.\n- **Anything left is named, never guessed.** A provider with several regions inside, none, a\n deployment model to choose, an authored region outside or no compliance profile is reported\n on the run result with the regions that would satisfy the residency, and\n `wildo context launch-blockers` lists it until the choice is made.\n- **`none` writes nothing**, and an authored residency is never removed by it: removing a\n residency withdraws a commitment, which a person does on purpose. A deferred answer writes\n nothing and the run says the residency is still open.\n\n(A `foundation-manifest` artifact was declared here until 2026-08-25 and is now\nretired with the app-creation verification/digest aspect. It was a bookkeeping record\nof decisions the config already carries — deleting it costs no fact about the app.)\n\n## Step 5 — Verify materialization and bring up the environment\n\nRun the existing commands from the intended application root with their documented\nprerequisites. Keep application structure, delivered knowledge and running services\nas separately verified results.\n\n1. **Verify the skeleton.** A fresh project starts with `wildo init` in an empty\n destination before the configuration-authoring steps above. Check `frontend/`,\n `shared-lib/`, `backend-api/`, `specifications/` and the generated configuration.\n On a repeat run, preserve existing source; use init's repair path or the relevant\n composition scenario instead of regenerating the project as a new application.\n\n2. **Verify application knowledge delivery.** Init attempts delivery from the\n installed packages and reports delivered or skipped assets. If dependency\n installation was skipped or a package is unavailable, install the required\n packages, then refresh the supported skills/rules and framework assets:\n\n ```bash\n wildo assets sync\n ```\n\n <!-- fwk-provenance-waiver: the command below is named in order to be REFUSED — `wildo fwk` needs a framework workspace and errors inside a generated application, which is exactly why an agent that might reach for it has to recognise the name; translating it away would leave the prohibition with nothing to prohibit. -->\n Read the result and inspect the delivered application guidance. Do not assume\n arbitrary agents/hooks are installed, and do not substitute a framework-developer\n delivery flow for this one — this command is how an application receives them.\n\n3. **Run setup** — configure the app from the authored `./wildo.saas.config.ts` and\n the `./infrastructure/` env configs (the `infra-environment-config` skill owns the\n typed infra env files; the `local-environment-bootstrap` skill owns the `wildo`\n lifecycle). Headless setup is registered and fail-closed on the administrator seed\n environment variables; it mints the environment generation without placeholders.\n\n ```bash\n wildo setup --non-interactive\n ```\n\n4. **Initialize and verify the project** — run the registered convergence journey.\n It regenerates artifacts, starts and readiness-gates backing services, reconciles\n platform Mongo state and credentials, starts native platform services, registers the\n app once, emits all runtime projections, and executes a signed managed-config read.\n\n ```bash\n wildo local init\n ```\n\n5. **Know what a PostgreSQL store owes — and that you do not write its baseline here.** Read the\n store selection you authored in the infra env config:\n\n ```bash\n rg -n \"applicationDatabase\" infrastructure/*/wildo.infra.*.config.ts\n ```\n\n Absent, or MongoDB: there is nothing to do — a collection exists on first write, there is no\n plan, and no migration is ever owed.\n\n `engine: DatabaseEngine.POSTGRESQL`: nothing creates a table implicitly, so until the INITIAL\n migration exists the backend refuses to boot on every table it declares. Do NOT accept a baseline\n with `wildo db diff --update-lockfile`: that writes the lockfile and NO migration, so it records a\n plan whose tables were never created and the boot gate still refuses.\n\n The build loop owns that migration. For an application that declares PostgreSQL and has no\n `backend-api/migrations/schema-plan.lock.json`, the dispatch host derives a `database-migrations`\n step; it runs `wildo db generate`, which, with no lockfile, renders the whole model as the initial\n migration and writes the baseline in the same invocation. The two are one change and are committed\n together. It needs a built `backend-api` (the plan is computed by importing the compiled backend\n registry), so report the store you found and leave the migration to that step.\n\nReport the status of each bring-up step to the creator from its real exit and\npostcondition results. A skipped knowledge delivery or unsuccessful initialization\nis not completion, even when source files exist.\n\n## Refine, don't re-author\n\n- **Keep what still holds.** On a re-run, do not disable a capability, drop a module,\n or re-select a provider that is already correct. Only enable a newly-justified\n capability, register a newly-added domain-plan module, or correct a provider where\n the definition set genuinely changed.\n- **Reuse existing module ids and provider scopes.** A module already registered keeps\n its id; a provider already selected keeps its scope — never mint a second one for the\n same module/capability.\n- **Follow the definition set.** If the domain plan added a module since the last run,\n reflect it (register the module) — do not re-derive the whole configuration from\n scratch. The delta is visible in `git diff` on the config, which is the record. A new\n compliance constraint does NOT enable a capability here; see Step 1 for why.\n\n## Quality gate — `foundation-configured-coherently` (declarative at scaffold depth)\n\nThe foundation is checked against the `foundation-configured-coherently` **reviewer\nchecklist** (see the end of this method): five invariants (capability derivation, module registration, provider coverage,\nsequence order, and foundation-depth boundary discipline), each marked PASS / CONCERN /\nGAP.\n\nThis checklist is **declarative**: no runtime executes it (rubric-only judge gates were retired at the flexible-intelligence hard cut — judgment runs only through a compiled Evaluation Treatment, and this playbook has none yet), so it ships as the **creator's review checklist** — nothing runs it automatically. The **trust floor** for accepting the foundation today is the\ncreator's `approve_result` review of the produced config and the bring-up result. There is\nintentionally **no deterministic gate**: config validation is a `wildo` CLI concern\n(`config sync` / validate), not a validator in the journey-artifact schemaRef\nvocabulary. Existing command permission and effect boundaries apply independently\nof this reviewer checklist.\n\n## Scaffold-depth boundary\n\nKeep this playbook at foundation depth. Explicitly **out of scope here**:\n\n- **Implementing replacement CLI tooling.** Use the existing init, asset delivery,\n setup and local initialization owners. If a command fails, retain its diagnostic\n evidence and resolve the prerequisite or concrete defect rather than inventing\n another materializer inside the application.\n- **Resource / field / schema authoring.** The config declares modules as shells and\n enables capabilities. The foundation executor can materialize resource shells\n and scope them to the chosen tenancy. Filling those shells with business-specific\n fields, rules, UI behavior, views and navigation belongs to the later build work.\n- **Re-introducing a foundation artifact.** The `foundation-manifest` family was\n retired on 2026-08-25 with the app-creation verification/digest aspect. Do **NOT**\n reshape `_core` to bring it back: the config file and its git history already carry\n every decision it recorded.\n- **Deep capability / provider modelling.** A defended capability-selection model\n (per-compliance-regime obligation → capability mapping, provider cost/feature\n matrices, multi-provider fallback) is a later depth pass. You derive capabilities\n from the definition set with the v1 heuristic above — not a solved obligation graph.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at scaffold\ndepth — deeper capability modelling belongs to a dedicated later pass,\nholistically.\n\n## What you emit\n\n- The authored **`./wildo.saas.config.ts`** (an app file) — the enabled engine\n capabilities, the registered modules, and the selected providers — plus the\n registered module shells across the runtimes and the\n brought-up skeleton.\n- The **bring-up result** reported to the creator: the status of each step, taken from\n its real exit/postcondition rather than from intent. This is a report, not a stored\n artifact — nothing reads it back.\n\nThe creator reviews the result (approval posture `approve_result`) before it is\naccepted as the journey's foundation, which the bottom-up build loop then fills in\nwith authored resources, operations, UX, and integrations.\n\n## References\n\n- `.claude/skills/config-saas/SKILL.md` — the `./wildo.saas.config.ts` authoring\n surface: `engineCapabilities`, `modules`, provider scopes, and `providerConfigurations`.\n- `.claude/skills/module-registration/SKILL.md` — register each domain-plan module\n across the shared / frontend / backend registries so the skeleton boots with it\n (distinct from `config-saas`, which only declares module existence at the root).\n- `.claude/skills/infra-environment-config/SKILL.md` — the typed `./infrastructure/`\n environment configs (backing services, public domain, service auth) the bring-up needs.\n- `.claude/skills/local-environment-bootstrap/SKILL.md` — the `wildo` lifecycle\n (`setup`, `local init`, `local reinit`, `local dev`) for deterministic initialization,\n repair, clean-room recovery, and runtime start.\n\n## Reviewer checklist — `foundation-configured-coherently`\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 maintained here as guidance against the current tooling:\n\nJudge whether the authored foundation (the ./wildo.saas.config.ts composition + the materialized skeleton) is a coherent realisation of the approved domain plan and the top-down definition set. Assess five invariants and mark each PASS / CONCERN / GAP with a one-line evidence note. (1) CAPABILITY DERIVATION — every enabled engine capability traces to a compliance/vision, business-model, market, or domain-plan need; unjustified capabilities are a CONCERN and missing required capabilities are a GAP. (2) MODULE REGISTRATION — every approved domain-plan module is declared and registered across runtimes; missing modules are a GAP and extra modules are a CONCERN. (3) PROVIDER COVERAGE — every provider serves a declared capability and every provider-backed capability has a provider. (4) SEQUENCE ORDER AND PROOF — materialize a fresh skeleton in an empty destination (or preserve an existing project) → refine config and module registrations → verify knowledge delivery → wildo setup --non-interactive → wildo local init. Treat setup intent, container health, or an initialization marker as insufficient: local init must reach its signed managed-config-read postcondition. (5) BOUNDARY DISCIPLINE — stay at foundation depth: deterministic resource shells are allowed, but business-specific fields, processing, UI behavior, views and navigation belong to later build work. Use the existing init/assets owners; do not replace them. Headless setup and local init run once their prerequisites are satisfied. This reviewer checklist is declarative; creator approval is the trust floor.\n",
|
|
50
50
|
"skillRefs": [
|
|
51
51
|
"config-saas",
|
|
52
52
|
"module-registration",
|
|
@@ -73,18 +73,34 @@
|
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"ref": "operating-entity",
|
|
76
|
-
"question": "Which legal entity operates this service? Give the
|
|
76
|
+
"question": "Which legal entity operates this service? Give the parts you know, each on its own line (or separated by `;`) and labelled: `name: <registered company name>`, `address: <registered address>`, `privacy contact: <the email, URL or postal address a person uses to reach you about privacy>`. Answer only the parts you actually know today — anything you leave out is recorded as outstanding and nothing is blocked by it. Do NOT supply a placeholder or a plausible-looking value: a produced privacy notice quotes these as fact, and the address is what a person would use to serve a legal request on a real company.",
|
|
77
77
|
"kind": "free_text",
|
|
78
|
+
"answerFormat": "operator_identity_parts",
|
|
78
79
|
"depth": "essential",
|
|
79
80
|
"whenUnknown": "ask",
|
|
80
81
|
"regulatedDomain": true
|
|
81
82
|
},
|
|
82
83
|
{
|
|
83
84
|
"ref": "operating-jurisdictions",
|
|
84
|
-
"question": "Which jurisdictions does this application operate in, and why does each one reach it — are you established there, do you sell there, or do you hold data about people there?
|
|
85
|
+
"question": "Which jurisdictions does this application operate in, and why does each one reach it — are you established there, do you sell there, or do you hold data about people there? Give one per line (or separated by `;`), each as `<code>: <why>`, using country codes (`fr`, `us`), the supranational `eu`, or a subdivision (`us-ca`): for example `fr: established here; eu: customers resident here`. If the market is genuinely unsettled, defer the question rather than answer it; an absent answer is read as unanswered, never as \"nowhere\".",
|
|
85
86
|
"kind": "free_text",
|
|
87
|
+
"answerFormat": "operating_jurisdictions",
|
|
86
88
|
"depth": "essential",
|
|
87
|
-
"regulatedDomain": true
|
|
89
|
+
"regulatedDomain": true,
|
|
90
|
+
"nonAnswers": [
|
|
91
|
+
"deferred"
|
|
92
|
+
]
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
"ref": "data-residency-territories",
|
|
96
|
+
"question": "Must this application's data stay inside named places? List them as jurisdiction codes separated by commas: a country (`de`, `fr`, `ch`), the supranational `eu`, or a subdivision (`us-ca`); the EEA is `eu, is, li, no`. Every provider that processes the data must then process inside them, so the framework chooses each provider's region where only one fits and names the providers where you must choose. Answer `none` if the data may be processed anywhere.",
|
|
97
|
+
"kind": "free_text",
|
|
98
|
+
"answerFormat": "jurisdiction_slugs_or_none",
|
|
99
|
+
"depth": "detail",
|
|
100
|
+
"regulatedDomain": true,
|
|
101
|
+
"nonAnswers": [
|
|
102
|
+
"deferred"
|
|
103
|
+
]
|
|
88
104
|
},
|
|
89
105
|
{
|
|
90
106
|
"ref": "billing-provider",
|
|
@@ -94,7 +110,11 @@
|
|
|
94
110
|
"stripe",
|
|
95
111
|
"none"
|
|
96
112
|
],
|
|
97
|
-
"depth": "detail"
|
|
113
|
+
"depth": "detail",
|
|
114
|
+
"nonAnswers": [
|
|
115
|
+
"not_applicable",
|
|
116
|
+
"deferred"
|
|
117
|
+
]
|
|
98
118
|
},
|
|
99
119
|
{
|
|
100
120
|
"ref": "sms-provider",
|
|
@@ -104,10 +124,34 @@
|
|
|
104
124
|
"twilio",
|
|
105
125
|
"none"
|
|
106
126
|
],
|
|
107
|
-
"depth": "detail"
|
|
127
|
+
"depth": "detail",
|
|
128
|
+
"nonAnswers": [
|
|
129
|
+
"not_applicable",
|
|
130
|
+
"deferred"
|
|
131
|
+
]
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"ref": "corporate-identity",
|
|
135
|
+
"question": "How do the company's people sign in to this tool? Through the company's identity provider (single sign-on, such as Microsoft Entra ID, Okta or Google Workspace) with accounts provisioned from the company directory; through the identity provider with each person invited by an administrator; or with no corporate identity provider, each person invited and signing in with the tool's own sign-in.",
|
|
136
|
+
"kind": "choice",
|
|
137
|
+
"options": [
|
|
138
|
+
"identity_provider_and_directory",
|
|
139
|
+
"identity_provider",
|
|
140
|
+
"none"
|
|
141
|
+
],
|
|
142
|
+
"depth": "detail",
|
|
143
|
+
"nonAnswers": [
|
|
144
|
+
"deferred"
|
|
145
|
+
]
|
|
108
146
|
}
|
|
109
147
|
]
|
|
110
148
|
},
|
|
149
|
+
"derivedFromAnswers": [
|
|
150
|
+
{
|
|
151
|
+
"playbookRef": "top_down.vision-elicitation",
|
|
152
|
+
"questionRef": "application-line"
|
|
153
|
+
}
|
|
154
|
+
],
|
|
111
155
|
"contextSources": [],
|
|
112
156
|
"draftableDocumentDefinitionRefs": [],
|
|
113
157
|
"suspendsForClarification": false,
|
|
@@ -103,17 +103,24 @@ augments.
|
|
|
103
103
|
Never bind a third-party vendor that neither that list nor the workspace carries: no module would provide
|
|
104
104
|
it. A need the registry does not cover is written in the plan's rationale as open, not bound.
|
|
105
105
|
|
|
106
|
-
## Step 4b — Say whether work arrives by email
|
|
106
|
+
## Step 4b — Say whether work arrives by email or by text
|
|
107
107
|
|
|
108
|
-
Declare an `inboundChannels` entry
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
108
|
+
Declare an `inboundChannels` entry only when the product ACTS on messages people send it:
|
|
109
|
+
|
|
110
|
+
- `channel: email` — a firm whose clients email documents to their matter, a support desk that turns a
|
|
111
|
+
message into a ticket.
|
|
112
|
+
- `channel: sms` — people text an organization's number and something happens: a patient moves an
|
|
113
|
+
appointment, a driver confirms a delivery, a member asks for the status of a request.
|
|
114
|
+
|
|
115
|
+
Its `purpose` says what arrives and what the application does with it; `servesRefs` names what asked
|
|
116
|
+
for it. One entry per channel.
|
|
112
117
|
|
|
113
118
|
This declaration is what switches the receiving capability on: the foundation derives `EMAIL_INBOUND`
|
|
114
|
-
from it and records the provider it is owed, so nobody is asked. Do not declare
|
|
115
|
-
|
|
116
|
-
another system is derived for that delivery, not
|
|
119
|
+
(email) or `SMS` (text) from it and records the provider it is owed, so nobody is asked. Do not declare
|
|
120
|
+
a channel because the product SENDS on it (notifications, sign-in codes): sending is not work arriving.
|
|
121
|
+
Never declare a webhook: a signed delivery from another system is derived for that delivery, not
|
|
122
|
+
planned. A text carries no attachment and its sender is identified, never authenticated, so a text
|
|
123
|
+
channel suits short requests a person could equally make by phone, not documents or approvals.
|
|
117
124
|
|
|
118
125
|
## Step 5 — Make every surface accountable
|
|
119
126
|
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
],
|
|
39
39
|
"stepOutputs": [],
|
|
40
40
|
"method": {
|
|
41
|
-
"guidance": "# Integration Plan — What Runs Beside the Backend\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## Where you are in the journey\n\nThe domain plan is approved and the requirements are written. You decide **what this application\nruns that is not a request** — its workers and its cron minions — and **what it reaches out to** —\nthe providers it binds, and where.\n\nYou do not write any of it. The foundation composes each package, and\n`bottom_up.build-decompose` turns each entry here into a build task bound to the skill that authors\nit.\n\n## Most applications declare nothing here, and that is an answer\n\nThere is no minimum. An application with no worker, no minion and no extra provider binding is the\nordinary case, and a plan that says so — with a rationale saying why — is complete. Inventing a\nworker to fill a collection composes a package nobody maintains.\n\n## Step 1 — Worker or minion? One question settles it\n\nThis is the distinction the whole plan turns on, and planning one as the other produces either a\npackage that never runs or one that runs with nothing to contain it.\n\n| | **worker** | **minion** |\n|---|---|---|\n| what starts it | the backend calls it | the clock |\n| how it is reached | HTTP routes it registers | nothing reaches it |\n| its authority | the caller's | a containment whitelist of its own |\n| plan it when | work cannot finish inside a request | something must happen because time passed |\n\nA nightly sweep is a minion. A slow import the user triggers is a worker. A nightly sweep that the\nbackend also triggers on demand is **both**, and they are two entries.\n\n## The refs carry a prefix, and the schema refuses one that does not\n\nA worker is `worker-<slug>` and a minion is `minion-<slug>`. You supply the SLUG; the runtime stamps\nthe prefix. Keep the slug kebab-case and starting with a LETTER: a ref beginning with a digit parses\nhere and is then refused when the foundation derives the package's identifiers from it.\n\n## Step 2 — Plan each worker\n\n- **`runtime`** — `NODE` unless the work is CPU-bound enough that the choice is the reason the\n worker exists. Rust is a cargo crate: no shared-lib, no pnpm workspace member, a different\n bootstrap. Choose it deliberately or choose Node.\n- **`purpose`** — what the backend delegates, and **why that cannot happen inside a request**. The\n second half is what a reader checks the decision against.\n- **`jobRefs`** — the routes the entry registers, which is what the backend calls. At least one, and\n **not the worker's own name**: `worker-imports` exposing only `imports` says nothing about what is\n delegated, and the plan reports it.\n\n## Step 3 — Plan each minion, and name its containment\n\n- **`purpose`** — what happens because time passed.\n- **`behaviorRefs`** — the named behaviours the tick performs.\n- **`readsResourceRefs` / `writesResourceRefs`** — **the containment decision, and this is why a\n minion is planned rather than left to the coding agent.** A minion's `resourceAccess` whitelist\n starts DENY-ALL, each named resource must separately opt in, and an empty whitelist logs a soft\n warning and **keeps running** — so a minion whose access nobody decided looks healthy and touches\n nothing. Name the decided resources its tick reads and the ones it writes.\n\n**No schedule here.** The plan says what happens because time passed, never how often: a cadence is\nan operational decision, and the minion's own build task sets it beside the whitelist it must widen\nanyway.\n\n## Step 4 — Bind the providers\n\nOne entry per provider per **scope** — the runtime owner whose declaration it lands in:\n\n| scope | the owner | what the binding is |\n|---|---|---|\n| `BACKEND` | the backend service | a package installed in the backend and scoped to it |\n| `COMPANION` | the dev companion | the same act, in the companion's scope |\n| `FRONTEND_APP` | the application frontend | a browser-bound provider module |\n| `WEBSITE` | the marketing site | the same, on the website's frontend service |\n\nThe same provider on two scopes is legitimate and common; the same provider twice on ONE scope is\none declaration written twice, and the plan refuses it.\n\n**A minion's or a worker's own providers are not here.** Those are declared on that surface's own\n`providers` block and belong to the task that builds it.\n\n**A third-party provider comes from the registry.** the declared `provider_registry` context section of your brief lists every\nprovider module on offer, whether this application has installed it, and the ref it is bound as. When a\nrequirement needs a vendor (reading documents, posting to a team chat, filing a task), pick the module that\nfills it, bind it by that ref, and put its install command, `wildo registry add wildo/providers/<name>`, in\nthe binding's rationale when it is not installed yet. The binding's build task installs it first. An\naugmentation (a module that adds operations to another provider, such as Teams on `microsoft`) is bound by\nits OWN ref with `augments` naming that provider; its task lands when the application opts it in under\n`providers.augmentations.<augments>`, which also needs a binding (or an existing scope) for the provider it\naugments.\nNever bind a third-party vendor that neither that list nor the workspace carries: no module would provide\nit. A need the registry does not cover is written in the plan's rationale as open, not bound.\n\n## Step 4b — Say whether work arrives by email\n\nDeclare an `inboundChannels` entry
|
|
41
|
+
"guidance": "# Integration Plan — What Runs Beside the Backend\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## Where you are in the journey\n\nThe domain plan is approved and the requirements are written. You decide **what this application\nruns that is not a request** — its workers and its cron minions — and **what it reaches out to** —\nthe providers it binds, and where.\n\nYou do not write any of it. The foundation composes each package, and\n`bottom_up.build-decompose` turns each entry here into a build task bound to the skill that authors\nit.\n\n## Most applications declare nothing here, and that is an answer\n\nThere is no minimum. An application with no worker, no minion and no extra provider binding is the\nordinary case, and a plan that says so — with a rationale saying why — is complete. Inventing a\nworker to fill a collection composes a package nobody maintains.\n\n## Step 1 — Worker or minion? One question settles it\n\nThis is the distinction the whole plan turns on, and planning one as the other produces either a\npackage that never runs or one that runs with nothing to contain it.\n\n| | **worker** | **minion** |\n|---|---|---|\n| what starts it | the backend calls it | the clock |\n| how it is reached | HTTP routes it registers | nothing reaches it |\n| its authority | the caller's | a containment whitelist of its own |\n| plan it when | work cannot finish inside a request | something must happen because time passed |\n\nA nightly sweep is a minion. A slow import the user triggers is a worker. A nightly sweep that the\nbackend also triggers on demand is **both**, and they are two entries.\n\n## The refs carry a prefix, and the schema refuses one that does not\n\nA worker is `worker-<slug>` and a minion is `minion-<slug>`. You supply the SLUG; the runtime stamps\nthe prefix. Keep the slug kebab-case and starting with a LETTER: a ref beginning with a digit parses\nhere and is then refused when the foundation derives the package's identifiers from it.\n\n## Step 2 — Plan each worker\n\n- **`runtime`** — `NODE` unless the work is CPU-bound enough that the choice is the reason the\n worker exists. Rust is a cargo crate: no shared-lib, no pnpm workspace member, a different\n bootstrap. Choose it deliberately or choose Node.\n- **`purpose`** — what the backend delegates, and **why that cannot happen inside a request**. The\n second half is what a reader checks the decision against.\n- **`jobRefs`** — the routes the entry registers, which is what the backend calls. At least one, and\n **not the worker's own name**: `worker-imports` exposing only `imports` says nothing about what is\n delegated, and the plan reports it.\n\n## Step 3 — Plan each minion, and name its containment\n\n- **`purpose`** — what happens because time passed.\n- **`behaviorRefs`** — the named behaviours the tick performs.\n- **`readsResourceRefs` / `writesResourceRefs`** — **the containment decision, and this is why a\n minion is planned rather than left to the coding agent.** A minion's `resourceAccess` whitelist\n starts DENY-ALL, each named resource must separately opt in, and an empty whitelist logs a soft\n warning and **keeps running** — so a minion whose access nobody decided looks healthy and touches\n nothing. Name the decided resources its tick reads and the ones it writes.\n\n**No schedule here.** The plan says what happens because time passed, never how often: a cadence is\nan operational decision, and the minion's own build task sets it beside the whitelist it must widen\nanyway.\n\n## Step 4 — Bind the providers\n\nOne entry per provider per **scope** — the runtime owner whose declaration it lands in:\n\n| scope | the owner | what the binding is |\n|---|---|---|\n| `BACKEND` | the backend service | a package installed in the backend and scoped to it |\n| `COMPANION` | the dev companion | the same act, in the companion's scope |\n| `FRONTEND_APP` | the application frontend | a browser-bound provider module |\n| `WEBSITE` | the marketing site | the same, on the website's frontend service |\n\nThe same provider on two scopes is legitimate and common; the same provider twice on ONE scope is\none declaration written twice, and the plan refuses it.\n\n**A minion's or a worker's own providers are not here.** Those are declared on that surface's own\n`providers` block and belong to the task that builds it.\n\n**A third-party provider comes from the registry.** the declared `provider_registry` context section of your brief lists every\nprovider module on offer, whether this application has installed it, and the ref it is bound as. When a\nrequirement needs a vendor (reading documents, posting to a team chat, filing a task), pick the module that\nfills it, bind it by that ref, and put its install command, `wildo registry add wildo/providers/<name>`, in\nthe binding's rationale when it is not installed yet. The binding's build task installs it first. An\naugmentation (a module that adds operations to another provider, such as Teams on `microsoft`) is bound by\nits OWN ref with `augments` naming that provider; its task lands when the application opts it in under\n`providers.augmentations.<augments>`, which also needs a binding (or an existing scope) for the provider it\naugments.\nNever bind a third-party vendor that neither that list nor the workspace carries: no module would provide\nit. A need the registry does not cover is written in the plan's rationale as open, not bound.\n\n## Step 4b — Say whether work arrives by email or by text\n\nDeclare an `inboundChannels` entry only when the product ACTS on messages people send it:\n\n- `channel: email` — a firm whose clients email documents to their matter, a support desk that turns a\n message into a ticket.\n- `channel: sms` — people text an organization's number and something happens: a patient moves an\n appointment, a driver confirms a delivery, a member asks for the status of a request.\n\nIts `purpose` says what arrives and what the application does with it; `servesRefs` names what asked\nfor it. One entry per channel.\n\nThis declaration is what switches the receiving capability on: the foundation derives `EMAIL_INBOUND`\n(email) or `SMS` (text) from it and records the provider it is owed, so nobody is asked. Do not declare\na channel because the product SENDS on it (notifications, sign-in codes): sending is not work arriving.\nNever declare a webhook: a signed delivery from another system is derived for that delivery, not\nplanned. A text carries no attachment and its sender is identified, never authenticated, so a text\nchannel suits short requests a person could equally make by phone, not documents or approvals.\n\n## Step 5 — Make every surface accountable\n\nEach worker and minion carries `servesRefs`: the requirement, feature draft, roadmap phase or\nsuccess criterion that asked for it. A background process accountable to nothing is one nobody\nasked for, and the plan reports it.\n\n## Refine, don't re-author\n\nYour own prior plan is an input. Keep every worker and minion ref that still has a reason to exist —\nbuild tasks name them, and a moved ref orphans the task that produced its package.\n\n## What you emit\n\n- The **integration plan** at `specifications/src/integration-plan/index.ts` — the workers, the\n minions, the provider bindings and the inbound channels this application carries, with the\n rationale for the shape as a whole.\n\n## Verification\n\n- Every `readsResourceRefs` / `writesResourceRefs` entry names a resource the domain plan declares.\n- No worker's only `jobRefs` entry repeats its own name.\n- `rg -n \"workerRef|minionRef\" specifications/src/integration-plan/index.ts | wc -l` — the number of\n packages the foundation will compose.\n\n## References — named by REF, because this step cannot open a file\n\nA structured generation has no filesystem, so a path here would be an instruction answered from\nrecollection (#1435). Each skill is named by its REF, and two reach this step as BODIES\n(`method.skillBodyRefs`): **`worker-authoring`** and **`minion-authoring`**. That is not a\nconvenience — step 1's question is a runtime contract, and step 3's containment chain has three\nparts of which two live outside the minion's own package, so neither is answerable from memory.\n\nThe rest are the contracts the CODING AGENT opens when it builds each task:\n\n- `provider-backend-package` — installing and scoping a provider on a backend-side owner, bound to\n the emitted task by `INTEGRATION_PROVIDER_BINDING_SKILL_REF` for the `BACKEND` and `COMPANION`\n scopes.\n- `provider-frontend-file-picker` — the frontend provider-module mechanism, bound for the\n `FRONTEND_APP` and `WEBSITE` scopes.\n- `provider-operation-calls` — how a bound provider's operations are actually called, which is what\n makes a binding worth having.\n- `resource-external-data` — the other way to reach another system: read-through or pipeline, when\n what you want is DATA rather than a provider call.\n- `configure-billing` — the worked five-surface chain for the provider binding most applications\n need first.\n- `inbound-channels` — what a declared inbound channel becomes: the handler that decides what a\n message causes, the sender assurance it requires, and whether it answers.\n",
|
|
42
42
|
"skillRefs": [
|
|
43
43
|
"worker-authoring",
|
|
44
44
|
"minion-authoring",
|
|
@@ -53,6 +53,7 @@
|
|
|
53
53
|
"worker-authoring",
|
|
54
54
|
"minion-authoring"
|
|
55
55
|
],
|
|
56
|
+
"derivedFromAnswers": [],
|
|
56
57
|
"contextSources": [
|
|
57
58
|
"workspace_truth",
|
|
58
59
|
"provider_registry"
|
|
@@ -37,10 +37,16 @@ Nothing here is an opinion, and no model produces it. Each row's level is reache
|
|
|
37
37
|
|---|---|---|
|
|
38
38
|
| `UNADDRESSED` | nothing the application decided points at the requirement | the decided-element graph |
|
|
39
39
|
| `DECIDED` | a decided element links to it — a feature draft, an experience surface, a worker, a build task | inbound links on the same graph |
|
|
40
|
-
| `BUILT` | a build task addressing it has LANDED | the landing probe, over
|
|
40
|
+
| `BUILT` | a build task addressing it has LANDED | the landing probe, over the working tree |
|
|
41
41
|
| `VERIFIED` | that landed task's declared product was PROVEN | the same probe, minus what it could not verify |
|
|
42
42
|
| `OBSERVED` | something watched the running application do it | runtime observations |
|
|
43
43
|
|
|
44
|
+
A requirement a coding run still REPORTS unmet reads at most `BUILT`, whatever the probe found. The
|
|
45
|
+
run that built the work said what is missing, so its file is not proof. The row lists each open gap,
|
|
46
|
+
the task that reported it, and the follow-up task the build host derived to answer it. A gap closes
|
|
47
|
+
when its follow-up lands with nothing left to report, or when a landed later run states the
|
|
48
|
+
requirement met.
|
|
49
|
+
|
|
44
50
|
The ladder is ordered, and the stage is the highest one whose threshold the population meets. The
|
|
45
51
|
default threshold is **every requirement at that level** — one number, and not a guess: a share
|
|
46
52
|
below 1 would be an invented tolerance, and this family measures rather than flatters.
|
|
@@ -64,12 +70,14 @@ or the derivation, knowing it exists.
|
|
|
64
70
|
|
|
65
71
|
## What the reading says that a number cannot
|
|
66
72
|
|
|
67
|
-
|
|
73
|
+
Four findings, and each names the application rather than the artifact:
|
|
68
74
|
|
|
69
75
|
- a requirement **nothing addresses** — the reading's whole point;
|
|
70
76
|
- a requirement whose build work **landed and could not be proven**, so its evidence stops at
|
|
71
77
|
`BUILT`. A task that declares no product cannot be probed, and that is a known, deliberate state
|
|
72
78
|
rather than a failure;
|
|
79
|
+
- a requirement a coding run still **reports partly unmet**, naming what is missing and the
|
|
80
|
+
follow-up that answers it. It stops at `BUILT` until that gap closes;
|
|
73
81
|
- **no runtime observation exists at all**, which today is true of every application. The finding
|
|
74
82
|
names what would fill it — an engine-behaviour e2e scenario that names the requirement it
|
|
75
83
|
exercises — rather than leaving the top of the ladder quietly empty.
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"ref": "bottom_up.maturity-reading",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"phase": "bottom_up",
|
|
5
|
-
"intent": "Maturity reading — measure WHERE THIS APPLICATION STANDS against its own requirements, and record it as the `application-maturity` family: one row per requirement the application declares, the evidence that exists for it, and the stage that follows. DERIVED, never judged. Each row's level is reached by a measurement — a decided element that points at the requirement (a feature draft, an experience surface, a worker, a build task), a build task addressing it that has LANDED in
|
|
5
|
+
"intent": "Maturity reading — measure WHERE THIS APPLICATION STANDS against its own requirements, and record it as the `application-maturity` family: one row per requirement the application declares, the evidence that exists for it, and the stage that follows. DERIVED, never judged. Each row's level is reached by a measurement — a decided element that points at the requirement (a feature draft, an experience surface, a worker, a build task), a build task addressing it that has LANDED (its product is in the working tree and something checked it), a landed task whose declared product was PROVEN, or a runtime observation of the running application. The denominator is the requirements family itself, total and in its own order, so a requirement nothing addresses is a row rather than an omission and adding one lowers the reading with no code change. This is a MEASUREMENT and never a gate: there is no 'done' for an application, and the stage moves in both directions as the application and its requirements change.",
|
|
6
6
|
"preconditions": [
|
|
7
7
|
{
|
|
8
8
|
"kind": "artifact_exists",
|
|
@@ -50,9 +50,10 @@
|
|
|
50
50
|
],
|
|
51
51
|
"stepOutputs": [],
|
|
52
52
|
"method": {
|
|
53
|
-
"guidance": "# Maturity Reading — Where This Application Stands\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 build lane ends on four typechecks and a migration-drift probe, and its own method says it \"does\nnot boot the application, run its test suite\". Nothing related what was BUILT to what the\napplication's requirements ASKED FOR.\n\nThis step records that relation as the `application-maturity` family: **one row per requirement the\napplication declares**, the evidence that exists for it, and the stage that follows.\n\n## There is no \"done\", and that is the design\n\nThe highest stage does not mean finished. It means that today, every requirement has the strongest\nevidence this framework can produce for it — and the next requirement somebody writes lowers the\nreading again, with no code change anywhere. That is what the measurement is FOR.\n\nSo nothing in the lane may gate on this family, and no other step may read a stage as permission.\n\n## It is derived, never judged\n\nNothing here is an opinion, and no model produces it. Each row's level is reached by a measurement:\n\n| level | reached when | measured from |\n|---|---|---|\n| `UNADDRESSED` | nothing the application decided points at the requirement | the decided-element graph |\n| `DECIDED` | a decided element links to it — a feature draft, an experience surface, a worker, a build task | inbound links on the same graph |\n| `BUILT` | a build task addressing it has LANDED | the landing probe, over
|
|
53
|
+
"guidance": "# Maturity Reading — Where This Application Stands\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 build lane ends on four typechecks and a migration-drift probe, and its own method says it \"does\nnot boot the application, run its test suite\". Nothing related what was BUILT to what the\napplication's requirements ASKED FOR.\n\nThis step records that relation as the `application-maturity` family: **one row per requirement the\napplication declares**, the evidence that exists for it, and the stage that follows.\n\n## There is no \"done\", and that is the design\n\nThe highest stage does not mean finished. It means that today, every requirement has the strongest\nevidence this framework can produce for it — and the next requirement somebody writes lowers the\nreading again, with no code change anywhere. That is what the measurement is FOR.\n\nSo nothing in the lane may gate on this family, and no other step may read a stage as permission.\n\n## It is derived, never judged\n\nNothing here is an opinion, and no model produces it. Each row's level is reached by a measurement:\n\n| level | reached when | measured from |\n|---|---|---|\n| `UNADDRESSED` | nothing the application decided points at the requirement | the decided-element graph |\n| `DECIDED` | a decided element links to it — a feature draft, an experience surface, a worker, a build task | inbound links on the same graph |\n| `BUILT` | a build task addressing it has LANDED | the landing probe, over the working tree |\n| `VERIFIED` | that landed task's declared product was PROVEN | the same probe, minus what it could not verify |\n| `OBSERVED` | something watched the running application do it | runtime observations |\n\nA requirement a coding run still REPORTS unmet reads at most `BUILT`, whatever the probe found. The\nrun that built the work said what is missing, so its file is not proof. The row lists each open gap,\nthe task that reported it, and the follow-up task the build host derived to answer it. A gap closes\nwhen its follow-up lands with nothing left to report, or when a landed later run states the\nrequirement met.\n\nThe ladder is ordered, and the stage is the highest one whose threshold the population meets. The\ndefault threshold is **every requirement at that level** — one number, and not a guess: a share\nbelow 1 would be an invented tolerance, and this family measures rather than flatters.\n\n## The denominator is the requirements family, and nothing else\n\nEvery row comes from `requirements`, functional and non-functional, in its own order. Not the\nrequirements that happen to be referenced somewhere, not a count of build tasks, not a share of\nfiles. A requirement nothing addresses is a ROW at `UNADDRESSED` — visible, counted, and lowering\nthe reading.\n\nThat is the difference between a measurement and a file count: a denominator you choose yourself is\nnot a measurement at all.\n\n## A family that addresses requirements joins on its own\n\n\"Which elements address this requirement\" is read from the decided-element graph's inbound links, so\nevery family that declares an edge to `requirements.functional` or `requirements.non-functional`\nalready contributes — and one that declares such an edge tomorrow contributes without this method,\nor the derivation, knowing it exists.\n\n## What the reading says that a number cannot\n\nFour findings, and each names the application rather than the artifact:\n\n- a requirement **nothing addresses** — the reading's whole point;\n- a requirement whose build work **landed and could not be proven**, so its evidence stops at\n `BUILT`. A task that declares no product cannot be probed, and that is a known, deliberate state\n rather than a failure;\n- a requirement a coding run still **reports partly unmet**, naming what is missing and the\n follow-up that answers it. It stops at `BUILT` until that gap closes;\n- **no runtime observation exists at all**, which today is true of every application. The finding\n names what would fill it — an engine-behaviour e2e scenario that names the requirement it\n exercises — rather than leaving the top of the ladder quietly empty.\n\n## What you emit\n\n- The **maturity reading** at `specifications/src/application-maturity/index.ts`. It is landed by\n the runner, not written by hand.\n\n## Verification\n\n- The row count equals the number of requirements the application declares.\n- Every `requirementRef` names a requirement in the `requirements` family.\n- `rg -c \"UNADDRESSED\" specifications/src/application-maturity/index.ts` — how many requirements\n nothing has picked up yet.\n",
|
|
54
54
|
"skillRefs": [],
|
|
55
55
|
"skillBodyRefs": [],
|
|
56
|
+
"derivedFromAnswers": [],
|
|
56
57
|
"contextSources": [],
|
|
57
58
|
"draftableDocumentDefinitionRefs": [],
|
|
58
59
|
"suspendsForClarification": false,
|
|
@@ -160,6 +160,38 @@ Reject placements justified by implementation convenience ("it renders there
|
|
|
160
160
|
already"), by the shape of the data model rather than the user's task, or by symmetry
|
|
161
161
|
for its own sake. Surfacing something everywhere is a **cost**, not thoroughness.
|
|
162
162
|
|
|
163
|
+
**One business concept, one sidebar entry.** The domain plan sometimes keeps one
|
|
164
|
+
concept's records in two resources: read through live from another system AND copied
|
|
165
|
+
into the application (its `organizationModel.recordLocations` names both lanes for the
|
|
166
|
+
records of one system), or a directory and the records people adopt from it. The
|
|
167
|
+
concept's one sidebar entry is the application VIEW that shows both lists (the
|
|
168
|
+
experience plan names it, with the resources it is the entry for, in
|
|
169
|
+
`entryForResourceRefs`; `config-navigation`, `references/one-entry-per-concept.md`).
|
|
170
|
+
So PLACE that view on the SIDEBAR, and PLACE each list on the COMMAND_MENU only, so it
|
|
171
|
+
stays reachable by name. Never DECLINE one of these lists: a declined decision means
|
|
172
|
+
the subject is shown NOWHERE, so a list declined and also placed on the command menu is
|
|
173
|
+
a contradiction no shell can carry. Two entries for one concept is criterion 2 failing
|
|
174
|
+
twice — Wonder Procurement put "Supplier Directory" and "Suppliers" side by side, and
|
|
175
|
+
nobody could tell which to use or why a supplier was in one and not the other. Read the
|
|
176
|
+
experience plan's views when you are given them: place the view whose
|
|
177
|
+
`entryForResourceRefs` names the concept's resources, by its slug (without `view-`).
|
|
178
|
+
When there is no experience plan yet, name the concept's view by the concept's slug
|
|
179
|
+
(`suppliers`), the slug the experience plan is told to give it. Where the two plans still
|
|
180
|
+
disagree, the coherence report marks it (`concept-list-on-sidebar`,
|
|
181
|
+
`concept-view-not-on-sidebar`, `concept-list-not-on-command-menu`); it refuses nothing, and
|
|
182
|
+
the next run of the plan that is wrong resolves it.
|
|
183
|
+
|
|
184
|
+
**Every view you place is one the experience plan holds.** When you are given the
|
|
185
|
+
experience plan's views, an `APP_VIEW` subject names one of them, by its slug (its
|
|
186
|
+
`viewRef` without `view-`), and nothing else: a view the experience plan does not plan is
|
|
187
|
+
a view no task builds, and the sidebar task that must carry it can never land. One
|
|
188
|
+
application placed `guided-onboarding`, `manager-pipeline-adoption-overview` and
|
|
189
|
+
`field-workspace` while its experience plan held `view-getting-started`,
|
|
190
|
+
`view-management-overview` and `view-field-work-overview`. A placement plan naming a
|
|
191
|
+
view the landed experience plan does not hold is refused, with the planned views named
|
|
192
|
+
(`placement-places-unknown-view`). Do not rename a view to suit the sidebar's wording:
|
|
193
|
+
the section's label is the placement's, the view's ref is the experience plan's.
|
|
194
|
+
|
|
163
195
|
## Groups carry a purpose, and the purpose is load-bearing
|
|
164
196
|
|
|
165
197
|
When you declare a group, state its `purpose` in product terms. It is not decoration:
|
|
@@ -243,6 +275,8 @@ so the task that follows has something to implement rather than a default to gue
|
|
|
243
275
|
|
|
244
276
|
- Every subject the workspace offers is either PLACED or DECLINED — nothing omitted.
|
|
245
277
|
- No subject placed twice on one surface.
|
|
278
|
+
- No business concept on the sidebar twice: a concept held in two resources (read through and
|
|
279
|
+
copied) has its view on the sidebar and each of its lists on the command menu, none declined.
|
|
246
280
|
- No application view placed on the settings rail or the user dropdown.
|
|
247
281
|
- Every grouped placement names a group this plan declares, for that same surface.
|
|
248
282
|
- Every `subGroupRef` names a sub-category this plan declares under that placement's category.
|