@wildo-ai/framework-knowledge 1.1.3 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +349 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- 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 +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- 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 +326 -8
- 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 +5 -3
- 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 +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- 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 +10 -5
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- 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 +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- 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 +167 -9
- 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 +171 -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 +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- 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 +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- 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 +8 -7
- 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 +3 -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 +22 -3
- 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 +5 -3
- 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 +21 -12
- 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 +192 -27
- 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 +172 -33
- 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 +2 -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 +6 -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 +182 -5
- 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 +191 -5
- 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 +2 -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 +3 -2
- 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 +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -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 +2 -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 +2 -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 +6 -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 +2 -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 +2 -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 +2 -2
- 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 +7 -3
- 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 +32 -4
- 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 +27 -3
- 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 +2 -2
- 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 +4 -2
- 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 +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- 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 +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- 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 +187 -4
- 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 +6 -5
- 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 +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.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 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- 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/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -1,14 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"ref": "top_down.scope-roadmap",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"phase": "top_down",
|
|
5
5
|
"intent": "Turn the accepted capability map into a non-vacuous current-horizon RoadmapSnapshot. Phases explicitly sequence and group accepted requirements and vision success criteria without pretending that FIT is build-order authority or inventing unsupported delivery commitments.",
|
|
6
|
-
"functionalTopics": [],
|
|
7
6
|
"preconditions": [
|
|
8
|
-
{
|
|
9
|
-
"kind": "phase_is",
|
|
10
|
-
"phase": "top_down"
|
|
11
|
-
},
|
|
12
7
|
{
|
|
13
8
|
"kind": "artifact_valid",
|
|
14
9
|
"selector": {
|
|
@@ -44,6 +39,9 @@
|
|
|
44
39
|
{
|
|
45
40
|
"family": "requirements"
|
|
46
41
|
},
|
|
42
|
+
{
|
|
43
|
+
"family": "roadmap"
|
|
44
|
+
},
|
|
47
45
|
{
|
|
48
46
|
"family": "vision-brief"
|
|
49
47
|
}
|
|
@@ -52,15 +50,16 @@
|
|
|
52
50
|
{
|
|
53
51
|
"family": "roadmap",
|
|
54
52
|
"schemaRef": "saas-specifications:RoadmapSnapshot",
|
|
55
|
-
"placement": ".wildo-saas/journey/<journeyId>/roadmap/",
|
|
56
53
|
"description": "A validated ordered roadmap whose phases bind current-horizon requirements and success criteria."
|
|
57
54
|
}
|
|
58
55
|
],
|
|
56
|
+
"stepOutputs": [],
|
|
59
57
|
"method": {
|
|
60
|
-
"guidance": "# Scope & Roadmap — Capability Map → Release Plan Method (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to be\n> iterated. The phasing order, the MVP-first rubric, and the in/out-of-scope\n> convention below are deliberately explicit so they can be tuned against real\n> runs — treat them as a starting rubric, not a frozen contract. The\n> *analytical depth* of release planning (typed schedules, dependency graphs,\n> capacity/estimation, defended prioritization) is intentionally shallow here\n> and is deepened in a later phase; do not perfect it in this playbook.\n\n## What this playbook does\n\nYou are the **release planner**. This playbook turns *product capability* (the\nfeatures the capability map identified and the requirements behind them) into a\n**release plan**: an ordered set of roadmap **phases** (MVP → Beta → GA →\nGrowth) that declare **what gets delivered when**. Capability mapping already\nproduced a **MarketSnapshot** whose benefits are wired to delivering features,\nplus **feature-drafts** and a set of **requirements**. Your one job is to answer,\nfor the whole product: **in what order do we deliver this, and what is in vs out\nof scope for each release?** — and record the answer as a `RoadmapSnapshot`.\n\nYou produce ONE artifact for this journey: the **roadmap** family\n(`RoadmapSnapshot`), a single ordered `phases` collection.\n\nThis is a **focused planning pass**, distinct from the capability map (which\nmade each benefit deliverable and drafted the features) and from the phase-gate\n(which decides whether the top-down phase is complete). Where the capability map\nsaid *what the product must do*, you say *in what order it ships*.\n\n## The roadmap is requirement/success-criterion-addressed, NOT feature-addressed\n\nRead this before you start — it is the one structural fact that shapes the whole\nmethod. A roadmap phase declares what it delivers through **two flat cross-ref\nlists**:\n\n- **`deliversRequirementRefs`** — the requirement refs (from the `requirements`\n family) this phase delivers. Primarily **functional-requirement** refs\n (`functional-requirement-…`) — the case the `_core` phase contract narrates —\n but a phase that lands a quality attribute may also deliver a **non-functional**\n ref (`nfr-…`); the catalog resolves both against one combined requirement-ref\n pool, so an NFR ref is valid here (see the NFR-phasing boundary note).\n- **`deliversSuccessCriterionRefs`** — the vision success-criterion refs (from\n the `vision-brief` family) this phase is expected to satisfy.\n\nA phase does **not** name feature refs. So the capability map's **features reach\nthe roadmap indirectly**: feature → benefit → requirement → phase. You slot\n**requirements and success criteria** into phases; you use the capability map\n(which feature delivers which benefit, and the FIT/Kano read on the feature set)\nto **judge which requirements are MVP-critical vs later**. The feature →\nrequirement trace is **prose-only today** (a requirement cross-refs ICPs and jobs\nbut not market pains/gains, and there is no typed feature → requirement edge —\nthis is the filed depth-phase gap; see the scaffold-depth boundary). At scaffold\ndepth you bridge that trace by reading the capability map and the requirements\ntogether and using judgement — do **not** try to make it deterministic here.\n\n## Read state first — the four families you read, the one you write\n\nThis playbook is **idempotent** and, on a re-run, a *refinement*: a MarketSnapshot\nmust already exist (the `artifact_exists` precondition enforces the capability map\nis in place — you cannot plan releases before you know the capabilities). Before\nplanning anything:\n\n1. Read the current journey state and scope through the `journey-status` skill\n (it owns the read; do not re-derive it here). Confirm a `market-snapshot`\n exists and check whether a `roadmap` already exists from an earlier run.\n2. Read the capability-mapped **MarketSnapshot** (benefits + their\n `deliveredByFeatureRefs` + FIT/Kano signal), the **feature-drafts** (the prose\n capability contracts — what each delivering feature actually is, so you can\n weigh how much of the product a requirement pulls in and whether it is\n MVP-critical), the **requirements** (`requirements` family — the\n functional/non-functional requirements to slot into phases), and the\n **VisionSnapshot** (`vision-brief` — the success criteria to deliver and the\n differentiation that anchors what belongs in the MVP).\n\n// TODO CLI COMMAND: wildo context journey-status (read current journey scope + artifacts)\n// TODO CLI COMMAND: wildo context roadmap (read any existing phases to refine)\n\nYou **read** `market-snapshot` + `feature-drafts` + `requirements` +\n`vision-brief`; you **write** the `roadmap` family.\n\n## The phasing loop (build the ordered releases)\n\n1. **Establish the MVP cut first.** The first phase is the smallest coherent\n release that makes the product's core promise true. Pull in the requirements\n whose delivering features are **table-stakes** for the primary ICP — the\n capability map's FIT/Kano read surfaces these (a `THRESHOLD` benefit for a\n `CORE`/`EXPANSION` ICP is MVP-critical). A requirement whose benefit is a\n `DELIGHTER`, or serves a non-primary segment, is a candidate for a later\n phase, not the MVP. MVP-first is the scaffold rubric: deliver the differentiated\n core early, defer the upside.\n2. **Group the remaining work into ordered later phases.** Beta / GA / Growth\n stages each pull in the next coherent slice of requirements and success\n criteria. Group by *theme* (a phase has a narrative headline — \"Trust &\n safety\", \"Onboarding excellence\"), not by arbitrary size.\n3. **Assign each phase its ordering + coarse tags.**\n - **`sequence`** — the authoritative ordering key (ascending integer).\n Consumers sort by `sequence`, never by array position. Author with **gaps**\n (10, 20, 30) so a later phase can be inserted without renumbering. Every\n phase must have a **distinct** `sequence` (a shared sequence is a\n `DUPLICATE_SEQUENCE` WARN — the order becomes ambiguous).\n - **`horizon`** — coarse `NOW` / `NEXT` / `LATER` bucket (`RoadmapPhaseHorizon`).\n - **`kind`** — coarse lifecycle stage `DISCOVERY` / `MVP` / `BETA` / `GA` /\n `GROWTH` / `OTHER` (`RoadmapPhaseKind`).\n - **`title`** (required), plus optional `theme` (narrative angle),\n `objective` (the concrete outcome in prose), and `targetWindow` (WHEN, as\n **free prose** — \"Q3 2026\", \"first 3 months post-launch\"; a typed schedule\n is a later-phase concern).\n4. **Wire what each phase delivers.** Populate `deliversRequirementRefs` with the\n requirement refs (functional, and any non-functional quality the phase lands)\n the phase delivers, and `deliversSuccessCriterionRefs` with the vision\n success-criterion refs it satisfies. **Every requirement and every success\n criterion should land in at most one phase** — the earliest that delivers it.\n Two distinct duplication cases exist, and the gate catches only one:\n - **Same ref twice on ONE phase's list** → a `DUPLICATE_CROSS_REF` WARN. The\n gate catches this (each of the two lists is its own namespace, so the same\n string appearing once in each list is NOT flagged).\n - **Same ref on TWO different phases** → the gate does **NOT** catch this — the\n validator's duplicate check is per-list, per-phase, never cross-phase. It is\n silently wrong: coverage double-counts the ref and \"which release first\n delivers it\" becomes ambiguous. Keeping a ref in exactly one phase is an\n **authoring discipline**, not a gate-enforced invariant.\n5. **Sanity-check coverage.** By the last phase, every requirement whose benefit\n the product actually promises, and every vision success criterion, should be\n delivered by some phase. A requirement no phase delivers is out-of-scope of the\n *entire roadmap* — that is a real decision (it says \"the product will not do\n this\"), so make it deliberately and narrate it, do not leave it by accident.\n\n## In-scope vs out-of-scope per release (the scope decision)\n\nThe roadmap `_core` has **no typed out-of-scope axis** — a phase declares only\nwhat it **delivers**. So scope is modelled as follows at scaffold depth:\n\n- **In-scope of a release = its `delivers*` refs.** The `deliversRequirementRefs`\n + `deliversSuccessCriterionRefs` a phase carries ARE its declared, gate-checked\n in-scope. This is explicit and typed.\n- **Out-of-scope of a release is implicit + partly derivable.** Everything NOT\n yet delivered by a phase at or before this one is out-of-scope of that release\n (cumulative — a ref delivered by an earlier phase stays in-scope in every later\n one). Within that out-of-scope set, two sub-cases ARE derivable from the roadmap\n alone: *deferred* (some later phase delivers the ref → planned, just not yet)\n vs *never* (NO phase anywhere delivers the ref → out of the product).\n- **What is NOT derivable — and therefore needs prose.** The roadmap cannot\n distinguish a *deliberately excluded* requirement (\"we chose not to build SSO\")\n from an *accidentally dropped* one (\"we forgot to slot it\"): both surface\n identically — a requirement authored in the `requirements` family that no phase\n delivers. That single ambiguity is the entire cost of Option A. So record the\n **rationale** for every deliberate \"never\" in the phase `objective` / `theme`\n **prose** (\"Out of scope for MVP: bulk import, SSO — deferred to GA\"; \"Not in\n the product: on-prem hosting — SaaS-only by design\"), and run the coverage\n sanity-check (step 5 above) so an accidental drop is caught rather than shipped\n as a phantom exclusion.\n\nRejected alternatives:\n\n- A **typed out-of-scope / explicitly-deferred axis** on a phase (a\n `defersRequirementRefs` list, or an `outOfScope` block). It is the real fix for\n the ambiguity above — it makes \"deliberately never\" machine-readable — but it is\n a `_core/roadmap` reshape, filed as a depth-phase item, NOT built here. Do\n **not** reshape the roadmap contract to add it.\n- A **phantom \"out-of-scope\" phase** — a phase whose `deliversRequirementRefs`\n lists the *excluded* requirements to fake a machine-readable exclusion set. Do\n **NOT** do this. A phase *delivers* its refs by definition; listing excluded\n refs there inverts the semantics and **corrupts every downstream coverage\n count** (those refs would read as delivered, and the phase-gate / refinement\n playbooks would treat excluded work as shipped). This is exactly the kind of\n \"trick\" the framework mindset forbids — the excluded set stays in prose until\n the typed axis lands, never by abusing `delivers*`.\n\n## Refine, don't re-author\n\n- **Keep what still holds.** On a re-run, do not renumber or re-theme phases that\n are already correct. Only add a phase, move a requirement to a different phase,\n or correct a delivers-list where the plan genuinely changed.\n- **Reuse existing phase refs.** A phase that already exists keeps its\n `roadmap-phase-<slug>` ref — never mint a second ref for the same release. Refs\n are unique (a `DUPLICATE_REF` is an ERROR that silently drops a phase).\n- **Never orphan a deliver-ref.** A phase's `deliversRequirementRefs` /\n `deliversSuccessCriterionRefs` must name refs that exist in the requirements /\n vision families. These cross-family refs are resolution-checked **fail-soft**\n (the check is skipped while the families are decoupled and no ref set is\n supplied), so honest planning must not name a requirement or success criterion\n that does not exist in the first place.\n- **Each ref in at most one phase.** A requirement/success-criterion is delivered\n by the earliest phase that delivers it; do not re-list it in later phases.\n\n## Quality gate\n\nThe RoadmapSnapshot is checked by the deterministic `roadmap-valid` gate\n(`validateRoadmapSnapshot`) before anything downstream consumes it. The invariants\nit enforces (verified issue catalogue):\n\n- **`INVALID_REF_FORMAT` (ERROR)** — a phase ref is not kebab-case with the\n `roadmap-phase-` prefix.\n- **`DUPLICATE_REF` (ERROR)** — two phases share a ref; the collection is\n addressed by ref, so a duplicate silently drops a phase.\n- **`DUPLICATE_SEQUENCE` (WARN)** — two phases share a `sequence`; the order\n between them is ambiguous (no data lost, so a WARN). Give each phase a distinct\n `sequence`.\n- **`DUPLICATE_CROSS_REF` (WARN)** — the same deliver-ref is listed more than\n once on ONE phase's deliver-list (each of the two lists is its own namespace, so\n the same ref appearing once in each list is NOT a duplicate). Remove the repeat.\n- **`NO_PHASES` (WARN)** — the roadmap plans no phases; it describes no delivery.\n- **`STALE_AUTHORED` (WARN)** — a phase's `authored.lastAuthoredAt` is older than\n its `reviewCadence`.\n- **`UNKNOWN_REQUIREMENT_REF` / `UNKNOWN_SUCCESS_CRITERION_REF` (ERROR, fail-soft)**\n — a `deliversRequirementRefs` / `deliversSuccessCriterionRefs` entry does not\n resolve against a supplied ref set. These are **SKIPPED (fail-soft) when no ref\n set is passed** — the roadmap family is decoupled from the requirements/vision\n families and the catalog owns cross-family resolution, so authoring a roadmap\n before those registries are fully wired does NOT crash-loop. Even so, only name\n refs that really exist (see \"Never orphan a deliver-ref\").\n\n## Scaffold-depth boundary (deferred to a later depth phase)\n\nKeep this playbook at scaffold depth. Explicitly **out of scope here**:\n\n- **Typed timeline / scheduling.** `targetWindow` is free prose and ordering is a\n coarse `sequence` integer. Start/end dates, date math, and calendar alignment\n are a later-phase concern — a phase says \"first 3 months post-launch\" as prose\n today, not a typed interval. Do NOT build a schedule model.\n- **Inter-phase dependency graph.** Phases are an ordered list, not a DAG. Edges\n between phases (phase B needs phase A's delivery) are a later-phase concern.\n- **Capacity / velocity / estimation and prioritization frameworks.** A phase is a\n themed bucket of deliver-refs, not an estimated, capacity-fitted, RICE/WSJF/MoSCoW-\n ranked plan. If you catch yourself estimating effort or building a prioritization\n model, **stop** — that is depth-phase work.\n- **A typed out-of-scope / explicitly-deferred axis** (see the scope decision\n above) — a `_core/roadmap` reshape, filed as a depth-phase item, not built here.\n- **Requirement priority + inter-requirement dependency.** A requirement has no\n MoSCoW/priority axis and no \"requirement A needs B\" edge; only the roadmap\n `sequence` approximates ordering. Do NOT reshape the requirements contract to add\n them — it is a filed depth-phase question.\n- **A dedicated non-functional-requirement delivery axis.** `deliversRequirementRefs`\n today carries functional AND non-functional refs against one combined pool. Some\n NFRs are cross-cutting quality attributes (accessibility, latency) that no single\n phase \"delivers\" — whether NFRs deserve their own phase-delivery axis (or a\n per-phase quality bar) rather than sharing `deliversRequirementRefs` is a\n depth-phase question. At scaffold depth, slot a phase-specific NFR into\n `deliversRequirementRefs` and leave universal NFRs unphased; do NOT reshape\n `_core` for a separate axis here.\n- **Per-phase ICP/segment targeting.** A phase cannot declare the primary\n ICP/segment it serves; that is a filed depth-phase gap. Note it in prose if it\n matters; do NOT reshape `_core` to add a typed edge.\n- **Deterministic feature → phase traceability.** Because a requirement carries no\n typed market pain/gain edge (and no typed feature → requirement edge), the\n feature → benefit → requirement → phase trace is prose-only. Whether the\n requirements family should gain a pain/gain edge is a filed depth-phase question —\n do NOT reshape the requirements or roadmap contract here.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at\nscaffold depth — depth is a dedicated later pass done once, holistically.\n\n## What you emit\n\nOne artifact for this journey: the **roadmap** at\n`.wildo-saas/journey/<journeyId>/roadmap/` — a `RoadmapSnapshot` whose `phases`\nare the ordered, MVP-first releases, each with a distinct `sequence`, a coarse\n`horizon` + `kind`, and its `deliversRequirementRefs` / `deliversSuccessCriterionRefs`\nwired — passing the `roadmap-valid` gate.\n\nThe creator reviews the result (approval posture `approve_result`) before it is\naccepted as the journey's roadmap.\n\n## References\n\n- `.claude/skills/journey-status/SKILL.md` — read the current journey state and\n scope, and confirm a `market-snapshot` (the capability map) already exists to\n plan releases from.\n",
|
|
58
|
+
"guidance": "# Scope & Roadmap — Capability Map → Release Plan Method (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to be\n> iterated. The phasing order, the MVP-first rubric, and the in/out-of-scope\n> convention below are deliberately explicit so they can be tuned against real\n> runs — treat them as a starting rubric, not a frozen contract. The\n> *analytical depth* of release planning (typed schedules, dependency graphs,\n> capacity/estimation, defended prioritization) is intentionally shallow here\n> and is deepened in a later phase; do not perfect it in this playbook.\n\n## What this playbook does\n\nYou are the **release planner**. This playbook turns *product capability* (the\nfeatures the capability map identified and the requirements behind them) into a\n**release plan**: an ordered set of roadmap **phases** (MVP → Beta → GA →\nGrowth) that declare **what gets delivered when**. Capability mapping already\nproduced a **MarketSnapshot** whose benefits are wired to delivering features,\nplus **feature-drafts** and a set of **requirements**. Your one job is to answer,\nfor the whole product: **in what order do we deliver this, and what is in vs out\nof scope for each release?** — and record the answer as a `RoadmapSnapshot`.\n\nYou produce ONE artifact for this journey: the **roadmap** family\n(`RoadmapSnapshot`), a single ordered `phases` collection.\n\nThis is a **focused planning pass**, distinct from the capability map (which\nmade each benefit deliverable and drafted the features) and from the phase-gate\n(which decides whether the top-down phase is complete). Where the capability map\nsaid *what the product must do*, you say *in what order it ships*.\n\n## The roadmap is requirement/success-criterion-addressed, NOT feature-addressed\n\nRead this before you start — it is the one structural fact that shapes the whole\nmethod. A roadmap phase declares what it delivers through **two flat cross-ref\nlists**:\n\n- **`deliversRequirementRefs`** — the requirement refs (from the `requirements`\n family) this phase delivers. Primarily **functional-requirement** refs\n (`functional-requirement-…`) — the case the `_core` phase contract narrates —\n but a phase that lands a quality attribute may also deliver a **non-functional**\n ref (`nfr-…`); the catalog resolves both against one combined requirement-ref\n pool, so an NFR ref is valid here (see the NFR-phasing boundary note).\n- **`deliversSuccessCriterionRefs`** — the vision success-criterion refs (from\n the `vision-brief` family) this phase is expected to satisfy.\n\nA phase does **not** name feature refs. So the capability map's **features reach\nthe roadmap indirectly**: feature → benefit → requirement → phase. You slot\n**requirements and success criteria** into phases; you use the capability map\n(which feature delivers which benefit, and the FIT/Kano read on the feature set)\nto **judge which requirements are MVP-critical vs later**. The feature →\nrequirement trace is **prose-only today** (a requirement cross-refs ICPs and jobs\nbut not market pains/gains, and there is no typed feature → requirement edge —\nthis is the filed depth-phase gap; see the scaffold-depth boundary). At scaffold\ndepth you bridge that trace by reading the capability map and the requirements\ntogether and using judgement — do **not** try to make it deterministic here.\n\n## Read state first — the four families you read, the one you write\n\nThis playbook is **idempotent** and, on a re-run, a *refinement*: a MarketSnapshot\nmust already exist (the `artifact_exists` precondition enforces the capability map\nis in place — you cannot plan releases before you know the capabilities). Before\nplanning anything:\n\n1. Read the current journey state and scope through the `journey-status` skill\n (it owns the read; do not re-derive it here). Confirm a `market-snapshot`\n exists and check whether a `roadmap` already exists from an earlier run.\n2. Read the capability-mapped **MarketSnapshot** (benefits + their\n `deliveredByFeatureRefs`, and their authored Kano categories). The FIT half of\n that signal is COMPUTED for you and arrives in\n the declared `market_fit_scores` context section of your brief — read it there rather than deriving or\n estimating it. Then the **feature-drafts** (the prose\n capability contracts — what each delivering feature actually is, so you can\n weigh how much of the product a requirement pulls in and whether it is\n MVP-critical), the **requirements** (`requirements` family — the\n functional/non-functional requirements to slot into phases), and the\n **VisionSnapshot** (`vision-brief` — the success criteria to deliver and the\n differentiation that anchors what belongs in the MVP).\n\n(A previously landed roadmap arrives in your brief as the `roadmap` input section — refine those\nphases rather than re-cutting them blind.)\n\nYou **read** `market-snapshot` + `feature-drafts` + `requirements` +\n`vision-brief`; you **write** the `roadmap` family.\n\n## The phasing loop (build the ordered releases)\n\n1. **Establish the MVP cut first.** The first phase is the smallest coherent\n release that makes the product's core promise true. Pull in the requirements\n whose delivering features are **table-stakes** for the primary ICP — the\n capability map's FIT/Kano read surfaces these (a `THRESHOLD` benefit for a\n `CORE`/`EXPANSION` ICP is MVP-critical). A requirement whose benefit is a\n `DELIGHTER`, or serves a non-primary segment, is a candidate for a later\n phase, not the MVP. MVP-first is the scaffold rubric: deliver the differentiated\n core early, defer the upside.\n2. **Group the remaining work into ordered later phases.** Beta / GA / Growth\n stages each pull in the next coherent slice of requirements and success\n criteria. Group by *theme* (a phase has a narrative headline — \"Trust &\n safety\", \"Onboarding excellence\"), not by arbitrary size.\n3. **Assign each phase its ordering + coarse tags.**\n - **`sequence`** — the authoritative ordering key (ascending integer).\n Consumers sort by `sequence`, never by array position. Author with **gaps**\n (10, 20, 30) so a later phase can be inserted without renumbering. Every\n phase must have a **distinct** `sequence` (a shared sequence is a\n `DUPLICATE_SEQUENCE` WARN — the order becomes ambiguous).\n - **`horizon`** — coarse `NOW` / `NEXT` / `LATER` bucket (`RoadmapPhaseHorizon`).\n - **`kind`** — coarse lifecycle stage `DISCOVERY` / `MVP` / `BETA` / `GA` /\n `GROWTH` / `OTHER` (`RoadmapPhaseKind`).\n - **`title`** (required), plus optional `theme` (narrative angle),\n `objective` (the concrete outcome in prose), and `targetWindow` (WHEN, as\n **free prose** — \"Q3 2026\", \"first 3 months post-launch\"; a typed schedule\n is a later-phase concern).\n4. **Wire what each phase delivers.** Populate `deliversRequirementRefs` with the\n requirement refs (functional, and any non-functional quality the phase lands)\n the phase delivers, and `deliversSuccessCriterionRefs` with the vision\n success-criterion refs it satisfies. **Every requirement and every success\n criterion should land in at most one phase** — the earliest that delivers it.\n Two distinct duplication cases exist, and the gate catches only one:\n - **Same ref twice on ONE phase's list** → a `DUPLICATE_CROSS_REF` WARN. The\n gate catches this (each of the two lists is its own namespace, so the same\n string appearing once in each list is NOT flagged).\n - **Same ref on TWO different phases** → the gate does **NOT** catch this — the\n validator's duplicate check is per-list, per-phase, never cross-phase. It is\n silently wrong: coverage double-counts the ref and \"which release first\n delivers it\" becomes ambiguous. Keeping a ref in exactly one phase is an\n **authoring discipline**, not a gate-enforced invariant.\n5. **Sanity-check coverage.** By the last phase, every requirement whose benefit\n the product actually promises, and every vision success criterion, should be\n delivered by some phase. A requirement no phase delivers is out-of-scope of the\n *entire roadmap* — that is a real decision (it says \"the product will not do\n this\"), so make it deliberately and narrate it, do not leave it by accident.\n\n## In-scope vs out-of-scope per release (the scope decision)\n\nThe roadmap `_core` has **no typed out-of-scope axis** — a phase declares only\nwhat it **delivers**. So scope is modelled as follows at scaffold depth:\n\n- **In-scope of a release = its `delivers*` refs.** The `deliversRequirementRefs`\n + `deliversSuccessCriterionRefs` a phase carries ARE its declared, gate-checked\n in-scope. This is explicit and typed.\n- **Out-of-scope of a release is implicit + partly derivable.** Everything NOT\n yet delivered by a phase at or before this one is out-of-scope of that release\n (cumulative — a ref delivered by an earlier phase stays in-scope in every later\n one). Within that out-of-scope set, two sub-cases ARE derivable from the roadmap\n alone: *deferred* (some later phase delivers the ref → planned, just not yet)\n vs *never* (NO phase anywhere delivers the ref → out of the product).\n- **What is NOT derivable — and therefore needs prose.** The roadmap cannot\n distinguish a *deliberately excluded* requirement (\"we chose not to build SSO\")\n from an *accidentally dropped* one (\"we forgot to slot it\"): both surface\n identically — a requirement authored in the `requirements` family that no phase\n delivers. That single ambiguity is the entire cost of Option A. So record the\n **rationale** for every deliberate \"never\" in the phase `objective` / `theme`\n **prose** (\"Out of scope for MVP: bulk import, SSO — deferred to GA\"; \"Not in\n the product: on-prem hosting — SaaS-only by design\"), and run the coverage\n sanity-check (step 5 above) so an accidental drop is caught rather than shipped\n as a phantom exclusion.\n\nRejected alternatives:\n\n- A **typed out-of-scope / explicitly-deferred axis** on a phase (a\n `defersRequirementRefs` list, or an `outOfScope` block). It is the real fix for\n the ambiguity above — it makes \"deliberately never\" machine-readable — but it is\n a `_core/roadmap` reshape, filed as a depth-phase item, NOT built here. Do\n **not** reshape the roadmap contract to add it.\n- A **phantom \"out-of-scope\" phase** — a phase whose `deliversRequirementRefs`\n lists the *excluded* requirements to fake a machine-readable exclusion set. Do\n **NOT** do this. A phase *delivers* its refs by definition; listing excluded\n refs there inverts the semantics and **corrupts every downstream coverage\n count** (those refs would read as delivered, and the phase-gate / refinement\n playbooks would treat excluded work as shipped). This is exactly the kind of\n \"trick\" the framework mindset forbids — the excluded set stays in prose until\n the typed axis lands, never by abusing `delivers*`.\n\n## Refine, don't re-author\n\n- **Keep what still holds.** On a re-run, do not renumber or re-theme phases that\n are already correct. Only add a phase, move a requirement to a different phase,\n or correct a delivers-list where the plan genuinely changed.\n- **Reuse existing phase refs.** A phase that already exists keeps its\n `roadmap-phase-<slug>` ref — never mint a second ref for the same release. Refs\n are unique (a `DUPLICATE_REF` is an ERROR that silently drops a phase).\n- **Never orphan a deliver-ref.** A phase's `deliversRequirementRefs` /\n `deliversSuccessCriterionRefs` must name refs that exist in the requirements /\n vision families. These cross-family refs are resolution-checked **fail-soft**\n (the check is skipped while the families are decoupled and no ref set is\n supplied), so honest planning must not name a requirement or success criterion\n that does not exist in the first place.\n- **Each ref in at most one phase.** A requirement/success-criterion is delivered\n by the earliest phase that delivers it; do not re-list it in later phases.\n\n## Quality gate\n\nThe RoadmapSnapshot is checked by the deterministic `roadmap-valid` gate\n(`validateRoadmapSnapshot`) before anything downstream consumes it. The invariants\nit enforces (verified issue catalogue):\n\n- **`INVALID_REF_FORMAT` (ERROR)** — a phase ref is not kebab-case with the\n `roadmap-phase-` prefix.\n- **`DUPLICATE_REF` (ERROR)** — two phases share a ref; the collection is\n addressed by ref, so a duplicate silently drops a phase.\n- **`DUPLICATE_SEQUENCE` (WARN)** — two phases share a `sequence`; the order\n between them is ambiguous (no data lost, so a WARN). Give each phase a distinct\n `sequence`.\n- **`DUPLICATE_CROSS_REF` (WARN)** — the same deliver-ref is listed more than\n once on ONE phase's deliver-list (each of the two lists is its own namespace, so\n the same ref appearing once in each list is NOT a duplicate). Remove the repeat.\n- **`NO_PHASES` (WARN)** — the roadmap plans no phases; it describes no delivery.\n- **`STALE_AUTHORED` (WARN)** — a phase's `authored.lastAuthoredAt` is older than\n its `reviewCadence`.\n- **`UNKNOWN_REQUIREMENT_REF` / `UNKNOWN_SUCCESS_CRITERION_REF` (ERROR, fail-soft)**\n — a `deliversRequirementRefs` / `deliversSuccessCriterionRefs` entry does not\n resolve against a supplied ref set. These are **SKIPPED (fail-soft) when no ref\n set is passed** — the roadmap family is decoupled from the requirements/vision\n families and the catalog owns cross-family resolution, so authoring a roadmap\n before those registries are fully wired does NOT crash-loop. Even so, only name\n refs that really exist (see \"Never orphan a deliver-ref\").\n\n## Scaffold-depth boundary (deferred to a later depth phase)\n\nKeep this playbook at scaffold depth. Explicitly **out of scope here**:\n\n- **Typed timeline / scheduling.** `targetWindow` is free prose and ordering is a\n coarse `sequence` integer. Start/end dates, date math, and calendar alignment\n are a later-phase concern — a phase says \"first 3 months post-launch\" as prose\n today, not a typed interval. Do NOT build a schedule model.\n- **Inter-phase dependency graph.** Phases are an ordered list, not a DAG. Edges\n between phases (phase B needs phase A's delivery) are a later-phase concern.\n- **Capacity / velocity / estimation and prioritization frameworks.** A phase is a\n themed bucket of deliver-refs, not an estimated, capacity-fitted, RICE/WSJF/MoSCoW-\n ranked plan. If you catch yourself estimating effort or building a prioritization\n model, **stop** — that is depth-phase work.\n- **A typed out-of-scope / explicitly-deferred axis** (see the scope decision\n above) — a `_core/roadmap` reshape, filed as a depth-phase item, not built here.\n- **Requirement priority + inter-requirement dependency.** A requirement has no\n MoSCoW/priority axis and no \"requirement A needs B\" edge; only the roadmap\n `sequence` approximates ordering. Do NOT reshape the requirements contract to add\n them — it is a filed depth-phase question.\n- **A dedicated non-functional-requirement delivery axis.** `deliversRequirementRefs`\n today carries functional AND non-functional refs against one combined pool. Some\n NFRs are cross-cutting quality attributes (accessibility, latency) that no single\n phase \"delivers\" — whether NFRs deserve their own phase-delivery axis (or a\n per-phase quality bar) rather than sharing `deliversRequirementRefs` is a\n depth-phase question. At scaffold depth, slot a phase-specific NFR into\n `deliversRequirementRefs` and leave universal NFRs unphased; do NOT reshape\n `_core` for a separate axis here.\n- **Per-phase ICP/segment targeting.** A phase cannot declare the primary\n ICP/segment it serves; that is a filed depth-phase gap. Note it in prose if it\n matters; do NOT reshape `_core` to add a typed edge.\n- **Deterministic feature → phase traceability.** Because a requirement carries no\n typed market pain/gain edge (and no typed feature → requirement edge), the\n feature → benefit → requirement → phase trace is prose-only. Whether the\n requirements family should gain a pain/gain edge is a filed depth-phase question —\n do NOT reshape the requirements or roadmap contract here.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at\nscaffold depth — depth is a dedicated later pass done once, holistically.\n\n## What you emit\n\nOne artifact for this journey: the **roadmap** at\n`specifications/src/roadmap/index.ts` — a `RoadmapSnapshot` whose `phases`\nare the ordered, MVP-first releases, each with a distinct `sequence`, a coarse\n`horizon` + `kind`, and its `deliversRequirementRefs` / `deliversSuccessCriterionRefs`\nwired — passing the `roadmap-valid` gate.\n\nThe creator reviews the result (approval posture `approve_result`) before it is\naccepted as the journey's roadmap.\n\n## References\n\nThese are skill FOLDERS installed in the application, named so each piece of work has an\nauthoring contract a later coding agent can open. This step has no tools and does not open them;\nwhat reaches you is this method, your declared inputs, and the brief's own sections.\n\n- `journey-status` — read the current journey state and\n scope, and confirm a `market-snapshot` (the capability map) already exists to\n plan releases from.\n",
|
|
61
59
|
"skillRefs": [
|
|
62
60
|
"journey-status"
|
|
63
61
|
],
|
|
62
|
+
"skillBodyRefs": [],
|
|
64
63
|
"elicitation": {
|
|
65
64
|
"questions": [
|
|
66
65
|
{
|
|
@@ -74,17 +73,16 @@
|
|
|
74
73
|
"kind": "free_text"
|
|
75
74
|
}
|
|
76
75
|
]
|
|
77
|
-
}
|
|
76
|
+
},
|
|
77
|
+
"contextSources": [
|
|
78
|
+
"market_fit_scores"
|
|
79
|
+
],
|
|
80
|
+
"draftableDocumentDefinitionRefs": [],
|
|
81
|
+
"suspendsForClarification": false,
|
|
82
|
+
"briefAdequacyGate": false,
|
|
83
|
+
"briefAdequacyExcludedSources": []
|
|
78
84
|
},
|
|
79
85
|
"executor": "companion_agent",
|
|
80
|
-
"qualityGates": [
|
|
81
|
-
{
|
|
82
|
-
"ref": "roadmap-valid",
|
|
83
|
-
"kind": "deterministic_validator",
|
|
84
|
-
"validatorRef": "saas-specifications:validateRoadmapSnapshot",
|
|
85
|
-
"required": true
|
|
86
|
-
}
|
|
87
|
-
],
|
|
88
86
|
"approval": "approve_result",
|
|
89
87
|
"budget": {
|
|
90
88
|
"maxRuns": 3
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"aggregationPolicyRef":"application-creation:aggregation/worst-value-proposition-verdict","aggregationStrategy":"WORST_VERDICT_PRECEDENCE_V1","criteria":[{"assessesAspects":["market.positioning","market.tone-of-voice","market.icp","market.benefit"],"criterionRef":"application-creation:criterion/value-proposition-positioning-coverage","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/value-proposition-positioning-coverage","requirementVersion":1}],"instruction":"Determine whether every ICP the product targets (priority CORE or EXPANSION) has exactly one positioning entry carrying 2 to 4 value pillars, each pillar hanging off the weighted benefits it names, framed by the vision's differentiation; whether EXPLORATORY, DEFERRED and ANTI_TARGET ICPs carry none; and whether the tones of voice are few and distinct, each positioning speaking in one of them.","schemaVersion":1,"verdictGuidance":{"CONCERN":"Coverage is complete but a pillar restates a benefit rather than sharpening a promise, or two tones are hard to tell apart.","GAP":"A CORE or EXPANSION ICP with no positioning, a positioning naming a missing ICP or benefit, a pillar count outside 2 to 4, or a positioning for an anti-target.","INDETERMINATE":"The market snapshot's ICPs or positionings are not in evidence.","PASS":"One positioning per targeted ICP, each with 2 to 4 pillars over named benefits, and a small distinct tone set."}},{"assessesAspects":["market.benefit","market.job","market.pain","market.gain","market.icp","vision.mission","vision.problem"],"criterionRef":"application-creation:criterion/value-proposition-vision-framed-benefits","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/value-proposition-vision-framed-benefits","requirementVersion":1}],"instruction":"Determine whether every benefit expresses the vision's differentiation and is weighted honestly: its relieves, creates and advances edges name pains, gains and jobs the market pass authored (never a ref that does not exist); each edge carries a degree; importanceByICP gives each targeted ICP a weight and a Kano category, with at most one THRESHOLD benefit per (ICP, job) and every THRESHOLD benefit advancing at least one job; and deliveredByFeatureRefs stays non-empty, as inherited forward references at this phase.","schemaVersion":1,"verdictGuidance":{"CONCERN":"Weighting is present but thin, or a benefit's link to the vision is weak enough that it reads as a generic promise.","GAP":"A benefit referencing a pain, gain or job that does not exist, a THRESHOLD claim with no job, two THRESHOLD benefits for one ICP and job, an empty deliveredByFeatureRefs, or a benefit the vision does not stand behind.","INDETERMINATE":"The vision or the market snapshot's jobs, pains and gains are not in evidence.","PASS":"Every benefit traces to the vision's differentiation, references only authored pains, gains and jobs, and carries honest per-ICP weighting."}}],"promptAssemblyStrategy":"CANONICAL_PROTOCOL_EVIDENCE_V1","protocolRef":"application-creation:evaluation-protocol/value-proposition","protocolVersion":1,"provenance":{"compilerRef":"meta-workflow:compiler/evaluation-treatment","compilerVersion":1,"sourcePlaybookRef":"playbook:top_down.value-proposition"},"schemaVersion":1,"verdictPrecedence":["GAP","INDETERMINATE","CONCERN","PASS"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"authorityRequirement":{"admittedChannels":["INTERFACE_RELAY"],"assurancePolicyRef":"application-creation:authority-policy/local-single-operator","channelPolicyRef":"application-creation:authority-policy/interface-relay","consequenceClassRef":"application-creation:authority-consequence/accept-market-snapshot","decisionModePolicyRef":"application-creation:authority-policy/explicit-operator-confirmation","expiryPolicyRef":"application-creation:authority-expiry/current-interface-session","hardFloorOverrideAllowed":false,"hardFloorPosture":"NON_WAIVABLE","minimumAssurance":"LOCAL_OS_SESSION","noncePolicyRef":"application-creation:authority-nonce/random-per-request","principalPolicyRef":null,"requiredDecisionMode":"EXPLICIT_OPERATOR_CONFIRMATION","requiredEvidenceRequirementRefs":["application-creation:evidence-requirement/value-proposition-positioning-coverage"],"requirementRef":"application-creation:authority-requirement/value-proposition-result","requirementVersion":1,"riskClassRef":"application-creation:risk/market-snapshot-accepted-family-mutation","schemaVersion":1},"continuationPolicy":{"fallbackAction":"BLOCK","mappings":[{"action":"CONTINUE","decisionConsequence":"CONTINUE"},{"action":"REVISE","decisionConsequence":"REVISE"},{"action":"REQUEST_EVIDENCE","decisionConsequence":"REQUEST_EVIDENCE"},{"action":"REQUEST_AUTHORITY","decisionConsequence":"REQUEST_AUTHORITY"},{"action":"BLOCK","decisionConsequence":"BLOCK"}],"maximumAuthorityReviews":1,"maximumEvidenceRequests":2,"maximumRevisionAttempts":3,"policyRef":"application-creation:continuation-policy/value-proposition","policyVersion":1,"schemaVersion":1},"decisionPointDefinition":{"authorityRequirement":{"requirementRef":"application-creation:authority-requirement/value-proposition-result","requirementVersion":1},"continuationPolicy":{"policyRef":"application-creation:continuation-policy/value-proposition","policyVersion":1},"decisionPointRef":"application-creation:decision-point/value-proposition-result","decisionPointVersion":1,"decisionRule":{"ruleRef":"application-creation:decision-rule/value-proposition-result","ruleVersion":1},"evaluatorBindingPolicy":{"policyRef":"application-creation:evaluator-binding-policy/value-proposition","policyVersion":1},"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/value-proposition-positioning-coverage","requirementVersion":1},{"requirementRef":"application-creation:evidence-requirement/value-proposition-vision-framed-benefits","requirementVersion":1}],"hardFloorRefs":["application-creation:hard-floor/market-snapshot-valid"],"riskPolicyRef":"application-creation:risk-policy/scoped-application-and-execution-context","schemaVersion":1,"significancePolicyRef":"application-creation:significance-policy/current-horizon-market-snapshot-change","triggerRefs":["application-creation:trigger/market-snapshot-staged-and-valid"]},"decisionRule":{"boundaryClass":"QUALITY_INTERPRETATION","evaluatorFailureConsequence":"BLOCK","evidenceAggregationRef":"application-creation:aggregation/worst-value-proposition-verdict","hardFloorBindings":[{"evidenceRequirementRefs":["application-creation:evidence-requirement/value-proposition-vision-framed-benefits"],"hardFloorRef":"application-creation:hard-floor/market-snapshot-valid"}],"hardFloorFailureConsequence":"BLOCK","hardFloorShortcutAllowed":false,"resultMappings":[{"consequence":"REQUEST_AUTHORITY","verdict":"PASS"},{"consequence":"REVISE","verdict":"CONCERN"},{"consequence":"REVISE","verdict":"GAP"},{"consequence":"REQUEST_EVIDENCE","verdict":"INDETERMINATE"}],"ruleRef":"application-creation:decision-rule/value-proposition-result","ruleVersion":1,"schemaVersion":1,"unresolvedConsequence":"REQUEST_EVIDENCE"},"definitionRef":"application-creation:evaluation-treatment/value-proposition","definitionVersion":1,"evaluationProtocol":{"aggregationPolicyRef":"application-creation:aggregation/worst-value-proposition-verdict","aggregationStrategy":"WORST_VERDICT_PRECEDENCE_V1","criteria":[{"assessesAspects":["market.positioning","market.tone-of-voice","market.icp","market.benefit"],"criterionRef":"application-creation:criterion/value-proposition-positioning-coverage","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/value-proposition-positioning-coverage","requirementVersion":1}],"instruction":"Determine whether every ICP the product targets (priority CORE or EXPANSION) has exactly one positioning entry carrying 2 to 4 value pillars, each pillar hanging off the weighted benefits it names, framed by the vision's differentiation; whether EXPLORATORY, DEFERRED and ANTI_TARGET ICPs carry none; and whether the tones of voice are few and distinct, each positioning speaking in one of them.","schemaVersion":1,"verdictGuidance":{"CONCERN":"Coverage is complete but a pillar restates a benefit rather than sharpening a promise, or two tones are hard to tell apart.","GAP":"A CORE or EXPANSION ICP with no positioning, a positioning naming a missing ICP or benefit, a pillar count outside 2 to 4, or a positioning for an anti-target.","INDETERMINATE":"The market snapshot's ICPs or positionings are not in evidence.","PASS":"One positioning per targeted ICP, each with 2 to 4 pillars over named benefits, and a small distinct tone set."}},{"assessesAspects":["market.benefit","market.job","market.pain","market.gain","market.icp","vision.mission","vision.problem"],"criterionRef":"application-creation:criterion/value-proposition-vision-framed-benefits","criterionVersion":1,"evidenceRequirements":[{"requirementRef":"application-creation:evidence-requirement/value-proposition-vision-framed-benefits","requirementVersion":1}],"instruction":"Determine whether every benefit expresses the vision's differentiation and is weighted honestly: its relieves, creates and advances edges name pains, gains and jobs the market pass authored (never a ref that does not exist); each edge carries a degree; importanceByICP gives each targeted ICP a weight and a Kano category, with at most one THRESHOLD benefit per (ICP, job) and every THRESHOLD benefit advancing at least one job; and deliveredByFeatureRefs stays non-empty, as inherited forward references at this phase.","schemaVersion":1,"verdictGuidance":{"CONCERN":"Weighting is present but thin, or a benefit's link to the vision is weak enough that it reads as a generic promise.","GAP":"A benefit referencing a pain, gain or job that does not exist, a THRESHOLD claim with no job, two THRESHOLD benefits for one ICP and job, an empty deliveredByFeatureRefs, or a benefit the vision does not stand behind.","INDETERMINATE":"The vision or the market snapshot's jobs, pains and gains are not in evidence.","PASS":"Every benefit traces to the vision's differentiation, references only authored pains, gains and jobs, and carries honest per-ICP weighting."}}],"promptAssemblyStrategy":"CANONICAL_PROTOCOL_EVIDENCE_V1","protocolRef":"application-creation:evaluation-protocol/value-proposition","protocolVersion":1,"provenance":{"compilerRef":"meta-workflow:compiler/evaluation-treatment","compilerVersion":1,"sourcePlaybookRef":"playbook:top_down.value-proposition"},"schemaVersion":1,"verdictPrecedence":["GAP","INDETERMINATE","CONCERN","PASS"]},"evaluatorBindingPolicy":{"admissibleEvaluatorDescriptors":[{"descriptorRef":"meta-workflow:evaluator/structured-semantic-coherence","descriptorVersion":1}],"budgetPolicyRef":"application-creation:evaluator-policy/current-work-cycle-budget","defaultEvaluatorDescriptor":{"descriptorRef":"meta-workflow:evaluator/structured-semantic-coherence","descriptorVersion":1},"escalationPolicyRef":"application-creation:evaluator-policy/request-explicit-review","fallbackPolicyRef":"application-creation:evaluator-policy/fail-closed","maximumAttempts":2,"outputSchemaRef":"meta-workflow:schema/structured-semantic-evaluation-candidate","policyRef":"application-creation:evaluator-binding-policy/value-proposition","policyVersion":1,"schemaVersion":1,"selectionPolicyRef":"application-creation:evaluator-policy/scoped-risk-and-evidence","timeoutPolicyRef":"application-creation:evaluator-policy/bounded-semantic-evaluation"},"evidenceRequirements":[{"aggregationPolicyRef":null,"conditionRef":null,"coveragePolicyRef":"application-creation:evidence-policy/exact-value-proposition-inputs-and-candidate","criterionRef":"application-creation:criterion/value-proposition-positioning-coverage","diversityPolicyRef":null,"freshnessPolicyRef":"application-creation:evidence-policy/current-action-binding","independencePolicyRef":null,"kind":"MANDATORY","maxCount":3,"minCount":2,"requirementRef":"application-creation:evidence-requirement/value-proposition-positioning-coverage","requirementVersion":1,"schemaVersion":1,"subjectRef":"application-creation:definition-set/vision-and-market-snapshot-candidate"},{"aggregationPolicyRef":null,"conditionRef":null,"coveragePolicyRef":"application-creation:evidence-policy/exact-value-proposition-inputs-and-candidate","criterionRef":"application-creation:criterion/value-proposition-vision-framed-benefits","diversityPolicyRef":null,"freshnessPolicyRef":"application-creation:evidence-policy/current-action-binding","independencePolicyRef":null,"kind":"MANDATORY","maxCount":3,"minCount":2,"requirementRef":"application-creation:evidence-requirement/value-proposition-vision-framed-benefits","requirementVersion":1,"schemaVersion":1,"subjectRef":"application-creation:definition-set/vision-and-market-snapshot-candidate"}],"schemaVersion":1}
|
|
@@ -91,7 +91,7 @@ invent a promise the product does not stand behind.
|
|
|
91
91
|
## Where the snapshot lives
|
|
92
92
|
|
|
93
93
|
The MarketSnapshot for this journey is at
|
|
94
|
-
|
|
94
|
+
`specifications/src/market/index.ts`. That is the artifact this
|
|
95
95
|
playbook refines in place — you read it, sharpen the value-proposition slices,
|
|
96
96
|
and write the same artifact back. When the product's definition later
|
|
97
97
|
stabilises, the snapshot is what seeds the durable market specification under
|
|
@@ -111,8 +111,6 @@ it). Before sharpening anything:
|
|
|
111
111
|
VisionSnapshot at the `vision-brief` placement, so you sharpen against the
|
|
112
112
|
real market intent and the real differentiation, not from scratch.
|
|
113
113
|
|
|
114
|
-
// TODO CLI COMMAND: wildo context journey-status (read current journey scope + artifacts)
|
|
115
|
-
// TODO CLI COMMAND: wildo context market-snapshot (read the existing snapshot to refine its value-prop slices)
|
|
116
114
|
|
|
117
115
|
Then sharpen:
|
|
118
116
|
|
|
@@ -154,15 +152,22 @@ failures** — the snapshot does not advance until they clear:
|
|
|
154
152
|
past its review cadence). Read `market-snapshot-validation` for the full issue
|
|
155
153
|
catalogue and emit a clean snapshot the first time.
|
|
156
154
|
|
|
155
|
+
Beyond the deterministic gate, the advisory judge reads the landed snapshot against
|
|
156
|
+
three criteria — vision-framed benefits, positioning coverage, and refinement rather
|
|
157
|
+
than re-authoring — and its verdicts reach the creator's review as notes. A verdict
|
|
158
|
+
never refuses a landing.
|
|
159
|
+
|
|
157
160
|
## Scaffold-depth boundary (deferred to a later depth phase)
|
|
158
161
|
|
|
159
162
|
Keep this playbook at scaffold depth. The following are explicitly **out of
|
|
160
163
|
scope here** and are deepened in the methodology-depth phase, not now:
|
|
161
164
|
|
|
162
|
-
- **Quantified FIT / Kano scoring precision** —
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
165
|
+
- **Quantified FIT / Kano scoring precision** — the deterministic FIT scorer has
|
|
166
|
+
already been run for you and its per-ICP scores arrive in
|
|
167
|
+
the declared `market_fit_scores` context section of your brief; `market-scoring-interpretation` is how to
|
|
168
|
+
READ them. At scaffold depth you consume them to sanity-check benefit weighting
|
|
169
|
+
and Kano assignment, never to drive a precise prioritization model, and you never
|
|
170
|
+
restate or estimate a score. The prioritization seam stays pluggable (the
|
|
166
171
|
capability-map playbook owns wiring FIT scores into feature drafts). Do not
|
|
167
172
|
build a scoring model here.
|
|
168
173
|
- **Positioning rigor** — a pillar captures *the* sharp per-ICP promise; a
|
|
@@ -178,7 +183,7 @@ scaffold depth — depth is a dedicated later pass done once, holistically.
|
|
|
178
183
|
|
|
179
184
|
## What you emit
|
|
180
185
|
|
|
181
|
-
The SAME MarketSnapshot at
|
|
186
|
+
The SAME MarketSnapshot at `specifications/src/market/index.ts`,
|
|
182
187
|
with its value-proposition slices sharpened: weighted benefits with per-ICP
|
|
183
188
|
Kano categories, the tones of voice, and one positioning entry (with its 2–4
|
|
184
189
|
value pillars) per `CORE`/`EXPANSION` ICP — all framed by the vision's
|
|
@@ -188,17 +193,21 @@ differentiation — passing the
|
|
|
188
193
|
|
|
189
194
|
## References
|
|
190
195
|
|
|
191
|
-
|
|
196
|
+
These are skill FOLDERS installed in the application, named so each piece of work has an
|
|
197
|
+
authoring contract a later coding agent can open. This step has no tools and does not open them;
|
|
198
|
+
what reaches you is this method, your declared inputs, and the brief's own sections.
|
|
199
|
+
|
|
200
|
+
- `journey-status` — read the current journey state
|
|
192
201
|
and scope, and confirm a `market-snapshot` already exists to refine.
|
|
193
|
-
-
|
|
202
|
+
- `market-add-feature-benefit` — author the benefit
|
|
194
203
|
claims and their relieves/creates/advances weighting and per-ICP Kano
|
|
195
204
|
categories.
|
|
196
|
-
-
|
|
205
|
+
- `market-tone-of-voice` — author the named brand
|
|
197
206
|
voices.
|
|
198
|
-
-
|
|
207
|
+
- `market-positioning-authoring` — author the per-ICP
|
|
199
208
|
positioning entries and their 2–4 value pillars.
|
|
200
|
-
-
|
|
209
|
+
- `market-scoring-interpretation` — interpret the
|
|
201
210
|
deterministic FIT scorer to sanity-check benefit weighting and Kano
|
|
202
211
|
assignment (scaffold depth — sanity-check, not a scoring model).
|
|
203
|
-
-
|
|
212
|
+
- `market-snapshot-validation` — the full validation
|
|
204
213
|
issue catalogue the quality gate enforces.
|
|
@@ -1,14 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"ref": "top_down.value-proposition",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"phase": "top_down",
|
|
5
5
|
"intent": "Top-down value-proposition / positioning: sharpen the product's value proposition on an EXISTING MarketSnapshot — the weighted benefits (relieves/creates/advances edges, Kano category per ICP), the tones of voice, and the per-ICP positioning pillars — framed by the product VisionSnapshot's differentiation. Runs after market-analysis (which produced the broad snapshot) and refines the same market-snapshot artifact; it does NOT create a new family (benefits, tone-of-voice, and positioning all live inside MarketSnapshot). Emits the refined MarketSnapshot validated by validateMarketSnapshot, consumed downstream by capability-map (benefits -> deliveredByFeatureRefs) and the refinement/coverage playbooks. v1 scaffold methodology — the FIT/Kano scoring precision and positioning rigor are iterated in a later depth phase, not here.",
|
|
6
|
-
"functionalTopics": [],
|
|
7
6
|
"preconditions": [
|
|
8
|
-
{
|
|
9
|
-
"kind": "phase_is",
|
|
10
|
-
"phase": "top_down"
|
|
11
|
-
},
|
|
12
7
|
{
|
|
13
8
|
"kind": "artifact_exists",
|
|
14
9
|
"selector": {
|
|
@@ -28,12 +23,12 @@
|
|
|
28
23
|
{
|
|
29
24
|
"family": "market-snapshot",
|
|
30
25
|
"schemaRef": "saas-specifications:MarketSnapshot",
|
|
31
|
-
"placement": ".wildo-saas/journey/<journeyId>/market-snapshot/",
|
|
32
26
|
"description": "The SAME MarketSnapshot, refined so its value-proposition slices are sharp: benefits with weighted relieves/creates/advances edges and per-ICP Kano categories, the tones of voice, and one positioning pillar per targeted ICP. Validated by validateMarketSnapshot; feeds capability-map and refinement."
|
|
33
27
|
}
|
|
34
28
|
],
|
|
29
|
+
"stepOutputs": [],
|
|
35
30
|
"method": {
|
|
36
|
-
"guidance": "# Value Proposition & Positioning — Sharpen Method (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to\n> be iterated. The refinement order, the benefit-weighting posture, and the\n> \"sharpen vs. leave\" rules below are deliberately explicit so they can be\n> tuned against real runs — treat them as a starting rubric, not a frozen\n> contract. The *analytical depth* of the value-proposition work (quantified\n> FIT / Kano scoring precision, positioning rigor) is intentionally shallow\n> here and is deepened in a later phase; do not perfect it in this playbook.\n\n## What this playbook does\n\nYou are the **positioning strategist**. Market-analysis already produced the\n**MarketSnapshot** — the category, ICPs, personas, and jobs/pains/gains. Your\none job is to **sharpen the value-proposition slices of that same snapshot**:\nthe benefits, the tones of voice, and the per-ICP positioning pillars, framed\nby the product's **VisionSnapshot** differentiation. You do not create a new\nartifact family — benefits, tone-of-voice, and positioning all live *inside*\n`MarketSnapshot`. You read the existing snapshot, tighten these three slices,\nand re-emit the same snapshot.\n\nThis is a **focused refinement pass**, distinct from market-analysis (which\ndoes the broad initial market sweep). Where market-analysis lays down the\nwhole snapshot at a first-pass depth, you come back over the value-proposition\nslices specifically and make them sharp, consistent with each other, and true\nto the vision.\n\nThe three slices you own, in dependency order (later slices reference earlier\nrefs, and all reference the jobs/pains/gains the market pass already authored):\n\n1. **Benefits** — the outcome claims the product delivers (`FeatureBenefit`),\n each a *weighted* set of edges: the pains it **relieves**, the gains it\n **creates**, and the jobs it **advances**, every edge carrying a `degree`\n (1..10) the FIT scorer multiplies by the ICP's own edge weight. Layer on\n `importanceByICP`: a per-ICP `weight` plus a **Kano category** from the\n `BenefitKanoCategory` enum — `THRESHOLD` (a must-have; its absence breaks\n the deal), `PERFORMANCE` (more is better), `DELIGHTER` (unexpected upside),\n plus `INDIFFERENT` / `REVERSE` for completeness — so the same benefit can\n matter differently to different segments. Benefits reference the\n pains/gains/jobs the market pass authored — never weight against a\n pain/gain/job that does not exist. (`market-add-feature-benefit`)\n - **Structural constraint (the U8 seam):** every benefit carries a\n non-empty `deliveredByFeatureRefs[]` — a benefit must be *deliverable*.\n At this top-down phase there is no feature registry yet, so these are\n **forward-reference** feature refs; the `ORPHAN_REF` resolution check is\n skipped until a feature set exists. **Wiring benefits to real spec-first\n feature drafts is the capability-map playbook's job (U8), not yours** —\n do not invent the feature registry here. Keep the refs you inherit;\n leave a placeholder ref only where the market pass already did.\n2. **Tones of voice** — the named brand voices the product speaks in\n (`ToneOfVoice`, addressed by `ToneOfVoiceRef`). Keep them few and distinct;\n each positioning and message template later speaks in one of them.\n (`market-tone-of-voice`)\n3. **Positioning** — the per-ICP marketing-truth promise (`MarketPositioning`):\n author **one positioning entry per ICP the product actually targets**\n (priority `CORE` or `EXPANSION`), each carrying **2–4 value pillars**\n (`valuePillars`) — the sharp claims that separate the product from the\n alternatives. Each pillar hangs off the weighted benefits above (it traces\n back to `FeatureBenefitRef[]`) and is framed by the vision's\n differentiation. (`market-positioning-authoring`)\n\nSharpen only the slices the product's stage warrants. A snapshot whose\nbenefits carry honest relieves/creates/advances weighting with per-ICP Kano\ncategories, at least one tone of voice, and one positioning entry (with its\nvalue pillars) per `CORE`/`EXPANSION` ICP is a legitimate v1; the depth of the\nweighting and the pillar prose is additive.\n\n## Frame everything by the vision\n\nThe **VisionSnapshot** (`vision-brief` family) is your differentiation anchor.\nRead its mission, its problem framing, and its success criteria before you\nweight a single benefit. A benefit's weight, a Kano category, and a positioning\npillar are only *right* if they express the product's actual differentiation —\nwhat the vision says makes this product worth building over the alternatives.\nWhen a benefit or pillar cannot be traced back to the vision's differentiation,\nthat is a signal to either sharpen the vision link or drop the claim, not to\ninvent a promise the product does not stand behind.\n\n## Where the snapshot lives\n\nThe MarketSnapshot for this journey is at\n`.wildo-saas/journey/<journeyId>/market-snapshot/`. That is the artifact this\nplaybook refines in place — you read it, sharpen the value-proposition slices,\nand write the same artifact back. When the product's definition later\nstabilises, the snapshot is what seeds the durable market specification under\n`./specifications/` — but at this phase it is a journey artifact, not yet app\nsource.\n\n## Refine, don't re-author — read state first\n\nThis playbook is **idempotent** and, by construction, a *refinement*: a\nMarketSnapshot must already exist (the `artifact_exists` precondition enforces\nit). Before sharpening anything:\n\n1. Read the current journey state and scope through the `journey-status` skill\n (it owns the read; do not re-derive it here) — that tells you which scope\n the value proposition must hold *for*.\n2. Read the existing MarketSnapshot at this playbook's placement path and the\n VisionSnapshot at the `vision-brief` placement, so you sharpen against the\n real market intent and the real differentiation, not from scratch.\n\n// TODO CLI COMMAND: wildo context journey-status (read current journey scope + artifacts)\n// TODO CLI COMMAND: wildo context market-snapshot (read the existing snapshot to refine its value-prop slices)\n\nThen sharpen:\n\n- **Keep what still holds.** Do not rewrite benefits, tones, or pillars that\n are already sharp and vision-true. Only add/correct where the current\n steering notes, the vision, or benefit-weight inconsistencies call for it.\n- **Never orphan a ref.** A positioning names an ICP and its pillars name\n benefits; a benefit names the pains/gains/jobs it relieves/creates/advances.\n Dropping an ICP, pain, gain, job, or benefit that a positioning, pillar, or\n benefit still points at orphans the downstream ref (the validator catches\n this as `ORPHAN_REF`, but honest refinement should not create the orphan).\n If a slice from the market pass is genuinely wrong, fix it at its source\n slice, do not paper over it in the value-prop layer.\n\n## Quality gate\n\nYour re-emitted snapshot is checked by the deterministic `market-snapshot-valid`\ngate (`validateMarketSnapshot`) before anything downstream consumes it. The\nvalue-proposition invariants it enforces are mostly **`ERROR`-severity hard\nfailures** — the snapshot does not advance until they clear:\n\n- **`MISSING_POSITIONING_FOR_ICP` (ERROR)** — a `CORE` or `EXPANSION` ICP has\n no `MarketPositioning`. This is the headline gap this playbook closes: a\n targeted ICP without a positioning is a *hard failure*, not a warning.\n (`EXPLORATORY` / `DEFERRED` / `ANTI_TARGET` ICPs are exempt.)\n- **`THRESHOLD_BENEFIT_WITHOUT_JOB` (ERROR)** — a benefit carries a\n `kanoCategory: THRESHOLD` entry but its `advances[]` is empty; a must-have\n claim needs a job to anchor against.\n- **`MULTIPLE_THRESHOLDS_PER_ICP_JOB` (ERROR)** — two distinct benefits both\n claim `THRESHOLD` for the same (icp, job); only one must-have per job.\n- **`EMPTY_BENEFIT_DELIVERED_BY` (ERROR)** — a benefit's `deliveredByFeatureRefs[]`\n is empty; every benefit must stay deliverable (see the U8 seam above).\n- **`ORPHAN_REF` (ERROR)** — a positioning naming a missing ICP, a pillar or\n benefit naming a missing pain/gain/job. (Feature-ref orphans are only\n checked once a feature registry is passed — not at this phase.)\n\n`WARN`-severity issues do not block but should be resolved: `DUPLICATE_EDGE_PER_ENTITY`\n(a duplicate `(benefit, icp)` importance edge) and `STALE_AUTHORED` (a slice\npast its review cadence). Read `market-snapshot-validation` for the full issue\ncatalogue and emit a clean snapshot the first time.\n\n## Scaffold-depth boundary (deferred to a later depth phase)\n\nKeep this playbook at scaffold depth. The following are explicitly **out of\nscope here** and are deepened in the methodology-depth phase, not now:\n\n- **Quantified FIT / Kano scoring precision** — `market-scoring-interpretation`\n reads the deterministic FIT scorer; at scaffold depth you consume it to\n sanity-check benefit weighting and Kano assignment, not to drive a precise\n prioritization model. The prioritization seam stays pluggable (the\n capability-map playbook owns wiring FIT scores into feature drafts). Do not\n build a scoring model here.\n- **Positioning rigor** — a pillar captures *the* sharp per-ICP promise; a\n full competitive positioning matrix, message-market-fit testing, or\n A/B-tested copy is later-phase work.\n- **Message-template rendering** — this playbook stops at the value-proposition\n slices (benefits / tone / pillars). Turning them into reusable message\n templates stays with the market-analysis playbook's `market_message_templates`\n slice.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at\nscaffold depth — depth is a dedicated later pass done once, holistically.\n\n## What you emit\n\nThe SAME MarketSnapshot at `.wildo-saas/journey/<journeyId>/market-snapshot/`,\nwith its value-proposition slices sharpened: weighted benefits with per-ICP\nKano categories, the tones of voice, and one positioning entry (with its 2–4\nvalue pillars) per `CORE`/`EXPANSION` ICP — all framed by the vision's\ndifferentiation — passing the\n`market-snapshot-valid` gate. The creator reviews the result (approval posture\n`approve_result`) before it is accepted as the journey's refined market intent.\n\n## References\n\n- `.claude/skills/journey-status/SKILL.md` — read the current journey state\n and scope, and confirm a `market-snapshot` already exists to refine.\n- `.claude/skills/market-add-feature-benefit/SKILL.md` — author the benefit\n claims and their relieves/creates/advances weighting and per-ICP Kano\n categories.\n- `.claude/skills/market-tone-of-voice/SKILL.md` — author the named brand\n voices.\n- `.claude/skills/market-positioning-authoring/SKILL.md` — author the per-ICP\n positioning entries and their 2–4 value pillars.\n- `.claude/skills/market-scoring-interpretation/SKILL.md` — interpret the\n deterministic FIT scorer to sanity-check benefit weighting and Kano\n assignment (scaffold depth — sanity-check, not a scoring model).\n- `.claude/skills/market-snapshot-validation/SKILL.md` — the full validation\n issue catalogue the quality gate enforces.\n",
|
|
31
|
+
"guidance": "# Value Proposition & Positioning — Sharpen Method (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to\n> be iterated. The refinement order, the benefit-weighting posture, and the\n> \"sharpen vs. leave\" rules below are deliberately explicit so they can be\n> tuned against real runs — treat them as a starting rubric, not a frozen\n> contract. The *analytical depth* of the value-proposition work (quantified\n> FIT / Kano scoring precision, positioning rigor) is intentionally shallow\n> here and is deepened in a later phase; do not perfect it in this playbook.\n\n## What this playbook does\n\nYou are the **positioning strategist**. Market-analysis already produced the\n**MarketSnapshot** — the category, ICPs, personas, and jobs/pains/gains. Your\none job is to **sharpen the value-proposition slices of that same snapshot**:\nthe benefits, the tones of voice, and the per-ICP positioning pillars, framed\nby the product's **VisionSnapshot** differentiation. You do not create a new\nartifact family — benefits, tone-of-voice, and positioning all live *inside*\n`MarketSnapshot`. You read the existing snapshot, tighten these three slices,\nand re-emit the same snapshot.\n\nThis is a **focused refinement pass**, distinct from market-analysis (which\ndoes the broad initial market sweep). Where market-analysis lays down the\nwhole snapshot at a first-pass depth, you come back over the value-proposition\nslices specifically and make them sharp, consistent with each other, and true\nto the vision.\n\nThe three slices you own, in dependency order (later slices reference earlier\nrefs, and all reference the jobs/pains/gains the market pass already authored):\n\n1. **Benefits** — the outcome claims the product delivers (`FeatureBenefit`),\n each a *weighted* set of edges: the pains it **relieves**, the gains it\n **creates**, and the jobs it **advances**, every edge carrying a `degree`\n (1..10) the FIT scorer multiplies by the ICP's own edge weight. Layer on\n `importanceByICP`: a per-ICP `weight` plus a **Kano category** from the\n `BenefitKanoCategory` enum — `THRESHOLD` (a must-have; its absence breaks\n the deal), `PERFORMANCE` (more is better), `DELIGHTER` (unexpected upside),\n plus `INDIFFERENT` / `REVERSE` for completeness — so the same benefit can\n matter differently to different segments. Benefits reference the\n pains/gains/jobs the market pass authored — never weight against a\n pain/gain/job that does not exist. (`market-add-feature-benefit`)\n - **Structural constraint (the U8 seam):** every benefit carries a\n non-empty `deliveredByFeatureRefs[]` — a benefit must be *deliverable*.\n At this top-down phase there is no feature registry yet, so these are\n **forward-reference** feature refs; the `ORPHAN_REF` resolution check is\n skipped until a feature set exists. **Wiring benefits to real spec-first\n feature drafts is the capability-map playbook's job (U8), not yours** —\n do not invent the feature registry here. Keep the refs you inherit;\n leave a placeholder ref only where the market pass already did.\n2. **Tones of voice** — the named brand voices the product speaks in\n (`ToneOfVoice`, addressed by `ToneOfVoiceRef`). Keep them few and distinct;\n each positioning and message template later speaks in one of them.\n (`market-tone-of-voice`)\n3. **Positioning** — the per-ICP marketing-truth promise (`MarketPositioning`):\n author **one positioning entry per ICP the product actually targets**\n (priority `CORE` or `EXPANSION`), each carrying **2–4 value pillars**\n (`valuePillars`) — the sharp claims that separate the product from the\n alternatives. Each pillar hangs off the weighted benefits above (it traces\n back to `FeatureBenefitRef[]`) and is framed by the vision's\n differentiation. (`market-positioning-authoring`)\n\nSharpen only the slices the product's stage warrants. A snapshot whose\nbenefits carry honest relieves/creates/advances weighting with per-ICP Kano\ncategories, at least one tone of voice, and one positioning entry (with its\nvalue pillars) per `CORE`/`EXPANSION` ICP is a legitimate v1; the depth of the\nweighting and the pillar prose is additive.\n\n## Frame everything by the vision\n\nThe **VisionSnapshot** (`vision-brief` family) is your differentiation anchor.\nRead its mission, its problem framing, and its success criteria before you\nweight a single benefit. A benefit's weight, a Kano category, and a positioning\npillar are only *right* if they express the product's actual differentiation —\nwhat the vision says makes this product worth building over the alternatives.\nWhen a benefit or pillar cannot be traced back to the vision's differentiation,\nthat is a signal to either sharpen the vision link or drop the claim, not to\ninvent a promise the product does not stand behind.\n\n## Where the snapshot lives\n\nThe MarketSnapshot for this journey is at\n`specifications/src/market/index.ts`. That is the artifact this\nplaybook refines in place — you read it, sharpen the value-proposition slices,\nand write the same artifact back. When the product's definition later\nstabilises, the snapshot is what seeds the durable market specification under\n`./specifications/` — but at this phase it is a journey artifact, not yet app\nsource.\n\n## Refine, don't re-author — read state first\n\nThis playbook is **idempotent** and, by construction, a *refinement*: a\nMarketSnapshot must already exist (the `artifact_exists` precondition enforces\nit). Before sharpening anything:\n\n1. Read the current journey state and scope through the `journey-status` skill\n (it owns the read; do not re-derive it here) — that tells you which scope\n the value proposition must hold *for*.\n2. Read the existing MarketSnapshot at this playbook's placement path and the\n VisionSnapshot at the `vision-brief` placement, so you sharpen against the\n real market intent and the real differentiation, not from scratch.\n\n\nThen sharpen:\n\n- **Keep what still holds.** Do not rewrite benefits, tones, or pillars that\n are already sharp and vision-true. Only add/correct where the current\n steering notes, the vision, or benefit-weight inconsistencies call for it.\n- **Never orphan a ref.** A positioning names an ICP and its pillars name\n benefits; a benefit names the pains/gains/jobs it relieves/creates/advances.\n Dropping an ICP, pain, gain, job, or benefit that a positioning, pillar, or\n benefit still points at orphans the downstream ref (the validator catches\n this as `ORPHAN_REF`, but honest refinement should not create the orphan).\n If a slice from the market pass is genuinely wrong, fix it at its source\n slice, do not paper over it in the value-prop layer.\n\n## Quality gate\n\nYour re-emitted snapshot is checked by the deterministic `market-snapshot-valid`\ngate (`validateMarketSnapshot`) before anything downstream consumes it. The\nvalue-proposition invariants it enforces are mostly **`ERROR`-severity hard\nfailures** — the snapshot does not advance until they clear:\n\n- **`MISSING_POSITIONING_FOR_ICP` (ERROR)** — a `CORE` or `EXPANSION` ICP has\n no `MarketPositioning`. This is the headline gap this playbook closes: a\n targeted ICP without a positioning is a *hard failure*, not a warning.\n (`EXPLORATORY` / `DEFERRED` / `ANTI_TARGET` ICPs are exempt.)\n- **`THRESHOLD_BENEFIT_WITHOUT_JOB` (ERROR)** — a benefit carries a\n `kanoCategory: THRESHOLD` entry but its `advances[]` is empty; a must-have\n claim needs a job to anchor against.\n- **`MULTIPLE_THRESHOLDS_PER_ICP_JOB` (ERROR)** — two distinct benefits both\n claim `THRESHOLD` for the same (icp, job); only one must-have per job.\n- **`EMPTY_BENEFIT_DELIVERED_BY` (ERROR)** — a benefit's `deliveredByFeatureRefs[]`\n is empty; every benefit must stay deliverable (see the U8 seam above).\n- **`ORPHAN_REF` (ERROR)** — a positioning naming a missing ICP, a pillar or\n benefit naming a missing pain/gain/job. (Feature-ref orphans are only\n checked once a feature registry is passed — not at this phase.)\n\n`WARN`-severity issues do not block but should be resolved: `DUPLICATE_EDGE_PER_ENTITY`\n(a duplicate `(benefit, icp)` importance edge) and `STALE_AUTHORED` (a slice\npast its review cadence). Read `market-snapshot-validation` for the full issue\ncatalogue and emit a clean snapshot the first time.\n\nBeyond the deterministic gate, the advisory judge reads the landed snapshot against\nthree criteria — vision-framed benefits, positioning coverage, and refinement rather\nthan re-authoring — and its verdicts reach the creator's review as notes. A verdict\nnever refuses a landing.\n\n## Scaffold-depth boundary (deferred to a later depth phase)\n\nKeep this playbook at scaffold depth. The following are explicitly **out of\nscope here** and are deepened in the methodology-depth phase, not now:\n\n- **Quantified FIT / Kano scoring precision** — the deterministic FIT scorer has\n already been run for you and its per-ICP scores arrive in\n the declared `market_fit_scores` context section of your brief; `market-scoring-interpretation` is how to\n READ them. At scaffold depth you consume them to sanity-check benefit weighting\n and Kano assignment, never to drive a precise prioritization model, and you never\n restate or estimate a score. The prioritization seam stays pluggable (the\n capability-map playbook owns wiring FIT scores into feature drafts). Do not\n build a scoring model here.\n- **Positioning rigor** — a pillar captures *the* sharp per-ICP promise; a\n full competitive positioning matrix, message-market-fit testing, or\n A/B-tested copy is later-phase work.\n- **Message-template rendering** — this playbook stops at the value-proposition\n slices (benefits / tone / pillars). Turning them into reusable message\n templates stays with the market-analysis playbook's `market_message_templates`\n slice.\n\nIf you find yourself perfecting any of the above, stop and leave the slice at\nscaffold depth — depth is a dedicated later pass done once, holistically.\n\n## What you emit\n\nThe SAME MarketSnapshot at `specifications/src/market/index.ts`,\nwith its value-proposition slices sharpened: weighted benefits with per-ICP\nKano categories, the tones of voice, and one positioning entry (with its 2–4\nvalue pillars) per `CORE`/`EXPANSION` ICP — all framed by the vision's\ndifferentiation — passing the\n`market-snapshot-valid` gate. The creator reviews the result (approval posture\n`approve_result`) before it is accepted as the journey's refined market intent.\n\n## References\n\nThese are skill FOLDERS installed in the application, named so each piece of work has an\nauthoring contract a later coding agent can open. This step has no tools and does not open them;\nwhat reaches you is this method, your declared inputs, and the brief's own sections.\n\n- `journey-status` — read the current journey state\n and scope, and confirm a `market-snapshot` already exists to refine.\n- `market-add-feature-benefit` — author the benefit\n claims and their relieves/creates/advances weighting and per-ICP Kano\n categories.\n- `market-tone-of-voice` — author the named brand\n voices.\n- `market-positioning-authoring` — author the per-ICP\n positioning entries and their 2–4 value pillars.\n- `market-scoring-interpretation` — interpret the\n deterministic FIT scorer to sanity-check benefit weighting and Kano\n assignment (scaffold depth — sanity-check, not a scoring model).\n- `market-snapshot-validation` — the full validation\n issue catalogue the quality gate enforces.\n",
|
|
37
32
|
"skillRefs": [
|
|
38
33
|
"journey-status",
|
|
39
34
|
"market-add-feature-benefit",
|
|
@@ -41,17 +36,17 @@
|
|
|
41
36
|
"market-tone-of-voice",
|
|
42
37
|
"market-scoring-interpretation",
|
|
43
38
|
"market-snapshot-validation"
|
|
44
|
-
]
|
|
39
|
+
],
|
|
40
|
+
"skillBodyRefs": [],
|
|
41
|
+
"contextSources": [
|
|
42
|
+
"market_fit_scores"
|
|
43
|
+
],
|
|
44
|
+
"draftableDocumentDefinitionRefs": [],
|
|
45
|
+
"suspendsForClarification": false,
|
|
46
|
+
"briefAdequacyGate": false,
|
|
47
|
+
"briefAdequacyExcludedSources": []
|
|
45
48
|
},
|
|
46
49
|
"executor": "companion_agent",
|
|
47
|
-
"qualityGates": [
|
|
48
|
-
{
|
|
49
|
-
"ref": "market-snapshot-valid",
|
|
50
|
-
"kind": "deterministic_validator",
|
|
51
|
-
"validatorRef": "saas-specifications:validateMarketSnapshot",
|
|
52
|
-
"required": true
|
|
53
|
-
}
|
|
54
|
-
],
|
|
55
50
|
"approval": "approve_result",
|
|
56
51
|
"budget": {
|
|
57
52
|
"maxRuns": 3
|
|
@@ -137,10 +137,14 @@ Before you start, read the current journey state and scope so you elicit the
|
|
|
137
137
|
vision for the right product, and read any vision that already exists so you
|
|
138
138
|
refine it rather than re-eliciting it from scratch.
|
|
139
139
|
|
|
140
|
-
|
|
141
|
-
|
|
140
|
+
(When a prior vision exists it arrives in your brief as the `vision-brief` input section — refine
|
|
141
|
+
that content rather than re-eliciting it.)
|
|
142
142
|
|
|
143
143
|
## References
|
|
144
144
|
|
|
145
|
-
|
|
145
|
+
These are skill FOLDERS installed in the application, named so each piece of work has an
|
|
146
|
+
authoring contract a later coding agent can open. This step has no tools and does not open them;
|
|
147
|
+
what reaches you is this method, your declared inputs, and the brief's own sections.
|
|
148
|
+
|
|
149
|
+
- `journey-status` — read current journey state and
|
|
146
150
|
scope before eliciting, and to see whether a `vision-brief` already exists.
|
|
@@ -1,29 +1,28 @@
|
|
|
1
1
|
{
|
|
2
2
|
"ref": "top_down.vision-elicitation",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"phase": "top_down",
|
|
5
5
|
"intent": "Elicit a complete current-horizon product vision from sealed creator input and application context. The provider proposes semantic content; the trusted runtime stamps refs/version and keeps provenance, authority and accepted-family mutation outside model output.",
|
|
6
|
-
"
|
|
7
|
-
"
|
|
6
|
+
"preconditions": [],
|
|
7
|
+
"inputs": [
|
|
8
8
|
{
|
|
9
|
-
"
|
|
10
|
-
"phase": "top_down"
|
|
9
|
+
"family": "vision-brief"
|
|
11
10
|
}
|
|
12
11
|
],
|
|
13
|
-
"inputs": [],
|
|
14
12
|
"outputs": [
|
|
15
13
|
{
|
|
16
14
|
"family": "vision-brief",
|
|
17
15
|
"schemaRef": "saas-specifications:VisionSnapshot",
|
|
18
|
-
"placement": ".wildo-saas/journey/<journeyId>/vision-brief/",
|
|
19
16
|
"description": "One validated VisionSnapshot containing the product idea, problem, mission, success criteria and constraints."
|
|
20
17
|
}
|
|
21
18
|
],
|
|
19
|
+
"stepOutputs": [],
|
|
22
20
|
"method": {
|
|
23
|
-
"guidance": "# Vision Elicitation — Interview Method (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to\n> be iterated. The question set, the interviewing depth, and the \"when is it\n> done enough\" bar below are deliberately explicit so they can be tuned\n> against real elicitation runs — treat them as a starting rubric, not a\n> frozen contract.\n\n## What this playbook does\n\nYou are the **vision interviewer**. Your one job is to draw the product's\nfoundational vision out of the creator through a structured conversation, and\nto capture it as a single typed **`VisionSnapshot`** — the `vision-brief`\nartifact. This is the **first** top-down step: everything downstream\n(positioning, the capability map, the compliance posture, the roadmap) reads\nthe vision you produce, so an honest, well-framed vision is the whole task.\n\nYou do **not** design the domain, draft requirements, or write code. You\nelicit *intent* — what the product is, why it should exist, what winning looks\nlike, and what limits bound it — and nothing more. Keep the market family\n(segments, personas) and the requirements family out of scope; the vision\nreferences them later, it does not absorb them.\n\n## The elicitation posture\n\n- **Interview, do not fill a form.** The typed questions on this playbook\n (`method.elicitation`) are your backbone, not your ceiling. Ask them in a\n natural order, follow up where an answer is thin, and skip a follow-up the\n creator already answered. Reflect each answer back in one line and let the\n creator correct you before you move on.\n- **Progressive is fine.** A `VisionSnapshot` requires only the **idea**; the\n problem statement and mission are OPTIONAL and elicited progressively. If the\n creator can only give you the idea today, capture it, note what is still\n open, and stop — the snapshot persists as partially-elicited and this\n playbook can resume. Never invent a problem or mission the creator did not\n give you just to fill the shape.\n- **One product, one vision.** The snapshot is a single aggregate, not a list\n — one idea, one problem, one mission, plus ref-addressable success criteria\n and constraints. If the creator describes two products, stop and ask which\n one this journey is for.\n\n## What you elicit — one aggregate\n\nWork the vision entity by entity. For each, the target shape and the framing\nquestions:\n\n- **Idea** (REQUIRED). The anchor concept. Capture a quotable one-liner\n (\"X for Y\") and a short paragraph expanding it (core capability, shape of the\n solution). Record any framing caveats or pivots as notes. A vision without an\n idea is nothing — do not proceed to the rest until you have it.\n- **Problem** (optional, WARNed when absent). The pain the product exists to\n solve: the core statement, who is affected (prose — the deep segment model is\n the market family's job), how people cope today, the cost of leaving it\n unsolved, and the timing trigger that makes solving it urgent *now*. This is\n a framing surface, not a sized opportunity model — capture the \"why\", not a\n TAM.\n- **Mission** (optional, WARNed when absent). The enduring purpose: the mission\n statement (what we do, for whom, to what end, in one sentence), the\n aspirational long-term end-state if it fully succeeds, and the guiding\n principles / non-negotiables that constrain *how* the product is built.\n Principles are chosen stances — keep them distinct from the hard external\n constraints below.\n- **Success criteria** (ref-addressable, `success-criterion-<slug>`). What\n \"this succeeded\" concretely looks like. Each criterion is a statement, an\n optional metric and target (free prose at this stage — \"500 weekly active\n teams\", \"median time-to-first-value < 5 min\"), and a coarse horizon bucket\n (`launch` / `short_term` / `long_term`). Do not force a quantified metric\n where the creator only has a qualitative one — a typed metric taxonomy is a\n later concern. A vision with no success criteria cannot be judged\n succeeded — the validator WARNs on it, so push for at least one.\n- **Constraints** (ref-addressable, `constraint-<slug>`). External limits the\n product must be built within, each classified by kind: `technical`,\n `business`, `compliance`, `resource`, `timeline`, or `other`. Capture the\n constraint statement and, where the creator gives it, the rationale (the\n source of the limit).\n - **Compliance constraints get explicit attention.** Ask whether the product\n handles regulated or personal data, operates in a regulated sector or has contractual\n assurance commitments. If so, record each as a\n `kind: compliance` constraint with a **prose** statement (\"Must be\n GDPR-compliant for EU customer personal data\"). Stop at prose — the deep\n per-regime obligation model (control catalogs, data-flow / residency\n matrices) is the compliance-posture step's job, not yours. Getting the\n compliance *seam* named here is what lets that later step engage.\n\n## What you emit\n\nA single `VisionSnapshot`:\n\n- `version` — the snapshot format version (leave at its default unless told\n otherwise).\n- `idea` — the required anchor (`oneLiner`, `description`, optional `notes`).\n- `problem` / `mission` — the optional singletons, present only if elicited.\n- `successCriteria[]` — each with a stable kebab-case `ref` prefixed\n `success-criterion-`, unique across the set.\n- `constraints[]` — each with a stable kebab-case `ref` prefixed `constraint-`,\n unique across the set, and a `kind`.\n\nAuthor every entity in English. Use stable, human-readable ref slugs\n(`success-criterion-weekly-active-teams`, `constraint-gdpr-eu-data`) — they are\naddressed by ref downstream, so a duplicate silently drops an entity.\n\n## Quality gate\n\nYour emitted snapshot is checked by the deterministic `vision-snapshot-valid`\ngate (`validateVisionSnapshot`) before it commits. Duplicate refs and malformed\nrefs (a success-criterion or constraint ref that is not kebab-case with its\nrequired prefix) are hard **errors** — the gate rejects them. A missing problem,\na missing mission, and an empty success-criteria set are **warnings**: they\nreflect a not-yet-complete vision, they do not block, and the journey persists\nthe snapshot as partially-elicited. Emit clean refs the first time; let the\nwarnings stand honestly when the vision genuinely is not complete yet, rather\nthan inventing entities to silence them.\n\n## Approval\n\nThe drafted `VisionSnapshot` is presented to the creator for approval before it\nbecomes the committed `vision-brief`. Show the vision back in plain prose — the\none-liner, the problem, the mission, the criteria, the constraints — and let the\ncreator confirm or correct it. The vision is the seed every later step trusts;\nit is worth one explicit human sign-off.\n\n## Runtime context\n\nBefore you start, read the current journey state and scope so you elicit the\nvision for the right product, and read any vision that already exists so you\nrefine it rather than re-eliciting it from scratch.\n\n
|
|
21
|
+
"guidance": "# Vision Elicitation — Interview Method (v1 scaffold)\n\n### Target Application Framing\n\nThis knowledge is for configuring behavior in the target application.\nWildo is the framework surface being used, not the product being built.\n\nRead and apply these patterns from the application-developer point of view:\n\n- how the application should configure the relevant app-level file\n- how the application should use framework-provided factories, enums, and helpers\n- how the application should avoid mixing frontend, backend, and infrastructure concerns\n\n\n> **This is a v1 scaffold methodology.** It is a working first cut meant to\n> be iterated. The question set, the interviewing depth, and the \"when is it\n> done enough\" bar below are deliberately explicit so they can be tuned\n> against real elicitation runs — treat them as a starting rubric, not a\n> frozen contract.\n\n## What this playbook does\n\nYou are the **vision interviewer**. Your one job is to draw the product's\nfoundational vision out of the creator through a structured conversation, and\nto capture it as a single typed **`VisionSnapshot`** — the `vision-brief`\nartifact. This is the **first** top-down step: everything downstream\n(positioning, the capability map, the compliance posture, the roadmap) reads\nthe vision you produce, so an honest, well-framed vision is the whole task.\n\nYou do **not** design the domain, draft requirements, or write code. You\nelicit *intent* — what the product is, why it should exist, what winning looks\nlike, and what limits bound it — and nothing more. Keep the market family\n(segments, personas) and the requirements family out of scope; the vision\nreferences them later, it does not absorb them.\n\n## The elicitation posture\n\n- **Interview, do not fill a form.** The typed questions on this playbook\n (`method.elicitation`) are your backbone, not your ceiling. Ask them in a\n natural order, follow up where an answer is thin, and skip a follow-up the\n creator already answered. Reflect each answer back in one line and let the\n creator correct you before you move on.\n- **Progressive is fine.** A `VisionSnapshot` requires only the **idea**; the\n problem statement and mission are OPTIONAL and elicited progressively. If the\n creator can only give you the idea today, capture it, note what is still\n open, and stop — the snapshot persists as partially-elicited and this\n playbook can resume. Never invent a problem or mission the creator did not\n give you just to fill the shape.\n- **One product, one vision.** The snapshot is a single aggregate, not a list\n — one idea, one problem, one mission, plus ref-addressable success criteria\n and constraints. If the creator describes two products, stop and ask which\n one this journey is for.\n\n## What you elicit — one aggregate\n\nWork the vision entity by entity. For each, the target shape and the framing\nquestions:\n\n- **Idea** (REQUIRED). The anchor concept. Capture a quotable one-liner\n (\"X for Y\") and a short paragraph expanding it (core capability, shape of the\n solution). Record any framing caveats or pivots as notes. A vision without an\n idea is nothing — do not proceed to the rest until you have it.\n- **Problem** (optional, WARNed when absent). The pain the product exists to\n solve: the core statement, who is affected (prose — the deep segment model is\n the market family's job), how people cope today, the cost of leaving it\n unsolved, and the timing trigger that makes solving it urgent *now*. This is\n a framing surface, not a sized opportunity model — capture the \"why\", not a\n TAM.\n- **Mission** (optional, WARNed when absent). The enduring purpose: the mission\n statement (what we do, for whom, to what end, in one sentence), the\n aspirational long-term end-state if it fully succeeds, and the guiding\n principles / non-negotiables that constrain *how* the product is built.\n Principles are chosen stances — keep them distinct from the hard external\n constraints below.\n- **Success criteria** (ref-addressable, `success-criterion-<slug>`). What\n \"this succeeded\" concretely looks like. Each criterion is a statement, an\n optional metric and target (free prose at this stage — \"500 weekly active\n teams\", \"median time-to-first-value < 5 min\"), and a coarse horizon bucket\n (`launch` / `short_term` / `long_term`). Do not force a quantified metric\n where the creator only has a qualitative one — a typed metric taxonomy is a\n later concern. A vision with no success criteria cannot be judged\n succeeded — the validator WARNs on it, so push for at least one.\n- **Constraints** (ref-addressable, `constraint-<slug>`). External limits the\n product must be built within, each classified by kind: `technical`,\n `business`, `compliance`, `resource`, `timeline`, or `other`. Capture the\n constraint statement and, where the creator gives it, the rationale (the\n source of the limit).\n - **Compliance constraints get explicit attention.** Ask whether the product\n handles regulated or personal data, operates in a regulated sector or has contractual\n assurance commitments. If so, record each as a\n `kind: compliance` constraint with a **prose** statement (\"Must be\n GDPR-compliant for EU customer personal data\"). Stop at prose — the deep\n per-regime obligation model (control catalogs, data-flow / residency\n matrices) is the compliance-posture step's job, not yours. Getting the\n compliance *seam* named here is what lets that later step engage.\n\n## What you emit\n\nA single `VisionSnapshot`:\n\n- `version` — the snapshot format version (leave at its default unless told\n otherwise).\n- `idea` — the required anchor (`oneLiner`, `description`, optional `notes`).\n- `problem` / `mission` — the optional singletons, present only if elicited.\n- `successCriteria[]` — each with a stable kebab-case `ref` prefixed\n `success-criterion-`, unique across the set.\n- `constraints[]` — each with a stable kebab-case `ref` prefixed `constraint-`,\n unique across the set, and a `kind`.\n\nAuthor every entity in English. Use stable, human-readable ref slugs\n(`success-criterion-weekly-active-teams`, `constraint-gdpr-eu-data`) — they are\naddressed by ref downstream, so a duplicate silently drops an entity.\n\n## Quality gate\n\nYour emitted snapshot is checked by the deterministic `vision-snapshot-valid`\ngate (`validateVisionSnapshot`) before it commits. Duplicate refs and malformed\nrefs (a success-criterion or constraint ref that is not kebab-case with its\nrequired prefix) are hard **errors** — the gate rejects them. A missing problem,\na missing mission, and an empty success-criteria set are **warnings**: they\nreflect a not-yet-complete vision, they do not block, and the journey persists\nthe snapshot as partially-elicited. Emit clean refs the first time; let the\nwarnings stand honestly when the vision genuinely is not complete yet, rather\nthan inventing entities to silence them.\n\n## Approval\n\nThe drafted `VisionSnapshot` is presented to the creator for approval before it\nbecomes the committed `vision-brief`. Show the vision back in plain prose — the\none-liner, the problem, the mission, the criteria, the constraints — and let the\ncreator confirm or correct it. The vision is the seed every later step trusts;\nit is worth one explicit human sign-off.\n\n## Runtime context\n\nBefore you start, read the current journey state and scope so you elicit the\nvision for the right product, and read any vision that already exists so you\nrefine it rather than re-eliciting it from scratch.\n\n(When a prior vision exists it arrives in your brief as the `vision-brief` input section — refine\nthat content rather than re-eliciting it.)\n\n## References\n\nThese are skill FOLDERS installed in the application, named so each piece of work has an\nauthoring contract a later coding agent can open. This step has no tools and does not open them;\nwhat reaches you is this method, your declared inputs, and the brief's own sections.\n\n- `journey-status` — read current journey state and\n scope before eliciting, and to see whether a `vision-brief` already exists.\n",
|
|
24
22
|
"skillRefs": [
|
|
25
23
|
"journey-status"
|
|
26
24
|
],
|
|
25
|
+
"skillBodyRefs": [],
|
|
27
26
|
"elicitation": {
|
|
28
27
|
"questions": [
|
|
29
28
|
{
|
|
@@ -107,17 +106,14 @@
|
|
|
107
106
|
"kind": "free_text"
|
|
108
107
|
}
|
|
109
108
|
]
|
|
110
|
-
}
|
|
109
|
+
},
|
|
110
|
+
"contextSources": [],
|
|
111
|
+
"draftableDocumentDefinitionRefs": [],
|
|
112
|
+
"suspendsForClarification": false,
|
|
113
|
+
"briefAdequacyGate": false,
|
|
114
|
+
"briefAdequacyExcludedSources": []
|
|
111
115
|
},
|
|
112
116
|
"executor": "companion_agent",
|
|
113
|
-
"qualityGates": [
|
|
114
|
-
{
|
|
115
|
-
"ref": "vision-snapshot-valid",
|
|
116
|
-
"kind": "deterministic_validator",
|
|
117
|
-
"validatorRef": "saas-specifications:validateVisionSnapshot",
|
|
118
|
-
"required": true
|
|
119
|
-
}
|
|
120
|
-
],
|
|
121
117
|
"approval": "approve_result",
|
|
122
118
|
"budget": {
|
|
123
119
|
"maxRuns": 3
|