@wildo-ai/framework-knowledge 1.1.0
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/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -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-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spec-composite-view-update
|
|
3
|
+
description: Author or update `*.composite-view.specification.ts` for sections, embeds, translation refs, and `codeHandling` so composite specs stay aligned with the runtime composite definition. Use when the user says "update the composite spec", "add a section to this composite", "the composite view needs a new section description", "rewire this embed in the spec", "the spec sectionRefs don't match the React composite", or after authoring/editing a `*CompositeView.tsx`.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Spec Composite View Update
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Mechanism skill for **composite view specifications** — the
|
|
23
|
+
`compositeViewSpecificationFromDefinition({...}, () => ({...}))` calls
|
|
24
|
+
that author the spec layer for each composite view shipped by the app.
|
|
25
|
+
Composite specs serve two consumers:
|
|
26
|
+
|
|
27
|
+
1. The **i18n / labelling pipeline** — `translationRef` plus
|
|
28
|
+
per-section `textSlots.{title,description}` are how titles and
|
|
29
|
+
descriptions become label keys.
|
|
30
|
+
2. The **AI / companion / docs pipeline** — `purpose`, `uiRole`,
|
|
31
|
+
`useWhen`, per-section `purpose`, and `codeHandling` ground
|
|
32
|
+
downstream tools in the *meaning* of each composition.
|
|
33
|
+
|
|
34
|
+
A composite spec is the **truth contract** for the composite's section
|
|
35
|
+
inventory. The spec's `sectionRefs:[...]` array must mirror the
|
|
36
|
+
React composite's `<Section name="...">` JSX exactly.
|
|
37
|
+
|
|
38
|
+
## App Paths
|
|
39
|
+
|
|
40
|
+
| Surface | Glob (relative to app root) |
|
|
41
|
+
|--------------------------------------|--------------------------------------------------------------------------------------------------------|
|
|
42
|
+
| Resource-owned composite spec | `specifications/src/modules/<slug>/composite-views/<name>.composite-view.specification.ts` |
|
|
43
|
+
| App-/module-level composite spec | `specifications/src/modules/<slug>/composite-views/<name>.composite-view.specification.ts` |
|
|
44
|
+
| Companion exports (spec barrel) | `specifications/src/companion-exports.ts` (`compositeViewSpecifications` map) |
|
|
45
|
+
| Runtime composite component (parity) | `frontend/src/modules/<slug>/resources/**/*CompositeView.tsx` and `frontend/src/modules/<slug>/app-level-views/**/*CompositeView.tsx` |
|
|
46
|
+
| Composite view registration | `frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` (`compositeViews:`) or `frontend/src/modules/<slug>/app-level-views/index.ts` |
|
|
47
|
+
|
|
48
|
+
## When to Use
|
|
49
|
+
|
|
50
|
+
- Adding/removing/reordering composite sections (`sectionRefs` change)
|
|
51
|
+
- Changing or adding embeds inside a composite (host/related/op)
|
|
52
|
+
- Updating section titles, descriptions, or `purpose` prose
|
|
53
|
+
- Re-pointing a composite's `translationRef` after a rename or move
|
|
54
|
+
- After authoring a new `*CompositeView.tsx` (must be paired with a spec)
|
|
55
|
+
|
|
56
|
+
## When NOT to Use
|
|
57
|
+
|
|
58
|
+
- Pure React/styling tweak with no semantic / section change → no spec
|
|
59
|
+
edit needed (but verify `sectionRefs` parity if `<Section name>` was
|
|
60
|
+
touched)
|
|
61
|
+
- Authoring the runtime composite component itself → `views-composite-authoring`
|
|
62
|
+
- Resource field semantics → `spec-resource-update`
|
|
63
|
+
- Feature gating semantics → `spec-feature-update`
|
|
64
|
+
|
|
65
|
+
## Workflow
|
|
66
|
+
|
|
67
|
+
### Step 1: Mirror a sibling composite spec
|
|
68
|
+
|
|
69
|
+
Find the closest sibling spec under
|
|
70
|
+
`specifications/src/modules/<slug>/composite-views/` and copy its
|
|
71
|
+
`compositeViewSpecificationFromDefinition({...}, () => ({...}))`
|
|
72
|
+
shape. Sibling parity is the cheapest correctness signal.
|
|
73
|
+
|
|
74
|
+
### Step 2: Wire the translation ref
|
|
75
|
+
|
|
76
|
+
Resource-owned composites use `buildResourceCompositeViewTranslationRef(<R>, '<view-ref>')`;
|
|
77
|
+
app-level composites use the app-level builder. **Never hand-build the
|
|
78
|
+
ref string** — typed builders prevent drift between spec keys and
|
|
79
|
+
runtime label lookups.
|
|
80
|
+
|
|
81
|
+
### Step 3: Declare `sectionRefs` and `sections`
|
|
82
|
+
|
|
83
|
+
The `sectionRefs:[...]` array is the **single source of truth** for
|
|
84
|
+
the composite's section inventory at the spec layer. Each ref must
|
|
85
|
+
appear as a key in the `sections: { [ref]: { ... } }` map and as a
|
|
86
|
+
`<Section name="<ref>">` in the runtime JSX. Drift in any direction
|
|
87
|
+
silently breaks i18n key resolution or section ordering.
|
|
88
|
+
|
|
89
|
+
### Step 4: Author per-section prose
|
|
90
|
+
|
|
91
|
+
For each section: `purpose` (one sentence — what this section is *about*),
|
|
92
|
+
`textSlots.title.purpose` (what the title should communicate),
|
|
93
|
+
`textSlots.description.purpose` (what the description should communicate).
|
|
94
|
+
The labelling pipeline reads `purpose` to generate appropriate copy.
|
|
95
|
+
|
|
96
|
+
### Step 5: Wire `codeHandling`
|
|
97
|
+
|
|
98
|
+
`definitionOwner` declares which owner (engine / module / app) the
|
|
99
|
+
runtime definition lives under, so companion lookup uses the right
|
|
100
|
+
ownership posture. Add `notes` for any non-obvious wiring (e.g.
|
|
101
|
+
"resource-owned, must stay aligned with `<resource>.ui-behavior.tsx`
|
|
102
|
+
`compositeViews` entry").
|
|
103
|
+
|
|
104
|
+
### Step 6: i18n + verify parity
|
|
105
|
+
|
|
106
|
+
1. Re-run the labelling pipeline if titles/descriptions changed
|
|
107
|
+
(`i18n-rerun-pipeline`).
|
|
108
|
+
2. Verify `sectionRefs` ↔ `<Section name>` JSX parity (see grep
|
|
109
|
+
invariant below).
|
|
110
|
+
3. Verify the spec is exported through the spec barrel and lands in
|
|
111
|
+
`specificationsCompanionExports.compositeViewSpecifications`.
|
|
112
|
+
|
|
113
|
+
## Worked Example
|
|
114
|
+
|
|
115
|
+
An application's `todoWorkspaceCompositeViewSpecification` is the
|
|
116
|
+
canonical resource-owned composite spec — two sections (`tasks`,
|
|
117
|
+
`metrics`) anchored on a single todo, with each section declaring its
|
|
118
|
+
purpose and translation slots (note the deliberate absence of a
|
|
119
|
+
host-record section: the composite is embedded inside the todo READ
|
|
120
|
+
surface, which already renders the record):
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
## Usage Example
|
|
124
|
+
|
|
125
|
+
```typescript
|
|
126
|
+
export const todoWorkspaceCompositeViewSpecification = compositeViewSpecificationFromDefinition(
|
|
127
|
+
{
|
|
128
|
+
translationRef: todoWorkspaceTranslationRef,
|
|
129
|
+
// No host-record section (history: an `overview` section embedding the host
|
|
130
|
+
// READ existed until 2026-07 — removed because this composite is embedded
|
|
131
|
+
// inside the todo READ custom view, where the record renders directly above,
|
|
132
|
+
// so the overview duplicated the entire detail on one page).
|
|
133
|
+
sectionRefs: ['tasks', 'metrics'],
|
|
134
|
+
},
|
|
135
|
+
(): CompositeViewSpecificationDraft => ({
|
|
136
|
+
purpose: 'Provide the adjacent workflow context around one todo — its supporting tasks and execution metrics — without repeating the todo record itself, which the hosting read surface already renders.',
|
|
137
|
+
uiRole: 'Resource-owned workspace composition surface for todo execution and planning context.',
|
|
138
|
+
useWhen: 'Use when a single todo is the anchor, but the user needs surrounding workflow context before acting.',
|
|
139
|
+
textSlots: {
|
|
140
|
+
title: {
|
|
141
|
+
purpose: 'Name the overall workspace as the broader execution/planning surface around the current todo.',
|
|
142
|
+
},
|
|
143
|
+
description: {
|
|
144
|
+
purpose: 'Explain that the page expands beyond the todo detail itself into adjacent work and metrics.',
|
|
145
|
+
},
|
|
146
|
+
},
|
|
147
|
+
sections: {
|
|
148
|
+
tasks: {
|
|
149
|
+
purpose: 'Surface the related task collection that helps execute or refine the current todo.',
|
|
150
|
+
textSlots: {
|
|
151
|
+
title: {
|
|
152
|
+
purpose: 'Label the section as the adjacent task workspace connected to the todo.',
|
|
153
|
+
},
|
|
154
|
+
description: {
|
|
155
|
+
purpose: 'Tell the user this section lists the tasks that support the current todo.',
|
|
156
|
+
notes: [
|
|
157
|
+
'Plain end-user copy, e.g. "Tasks that support this todo." — never contrast against internal alternatives ("not unrelated work") the user cannot see.',
|
|
158
|
+
],
|
|
159
|
+
},
|
|
160
|
+
},
|
|
161
|
+
},
|
|
162
|
+
metrics: {
|
|
163
|
+
purpose: 'Summarize the quantitative execution signals attached to the todo and its surrounding tasks.',
|
|
164
|
+
textSlots: {
|
|
165
|
+
title: {
|
|
166
|
+
purpose: 'Frame this section as progress/status metrics rather than editable task content.',
|
|
167
|
+
},
|
|
168
|
+
description: {
|
|
169
|
+
purpose: 'Tell the user these charts summarize progress and status for this todo and its tasks.',
|
|
170
|
+
notes: [
|
|
171
|
+
'Plain end-user copy, e.g. "Charts summarizing progress on this todo." — describe what the user sees, not what the surface helps them "judge before leaving".',
|
|
172
|
+
],
|
|
173
|
+
},
|
|
174
|
+
},
|
|
175
|
+
},
|
|
176
|
+
},
|
|
177
|
+
codeHandling: {
|
|
178
|
+
definitionOwner: {
|
|
179
|
+
ownerId: 'tasks-manager',
|
|
180
|
+
ownerKind: SpecificationOwnerKind.DOMAIN_MODULE,
|
|
181
|
+
},
|
|
182
|
+
notes: [
|
|
183
|
+
'This translationRef is resource-owned and must stay aligned with the runtime composite definition built from the todos UI behavior.',
|
|
184
|
+
],
|
|
185
|
+
},
|
|
186
|
+
businessConstraints: [
|
|
187
|
+
'The workspace should still feel anchored to one todo, not to an unbounded project dashboard.',
|
|
188
|
+
],
|
|
189
|
+
}),
|
|
190
|
+
);
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
What earns its place:
|
|
194
|
+
|
|
195
|
+
- `compositeViewSpecificationFromDefinition({ translationRef,
|
|
196
|
+
sectionRefs }, () => ({...}))` — **typed factory**, not a literal
|
|
197
|
+
object. The factory enforces the shape and the `() => ({...})`
|
|
198
|
+
callback lets the framework lazily evaluate the prose payload.
|
|
199
|
+
- `translationRef: buildResourceCompositeViewTranslationRef(R.TODOS, 'todo-workspace')` —
|
|
200
|
+
**typed builder**, not a hand-written string. The builder is the
|
|
201
|
+
bridge between spec id and runtime label key resolution.
|
|
202
|
+
- `sectionRefs: ['tasks', 'metrics']` — **the canonical
|
|
203
|
+
section inventory**. The runtime composite must mirror these
|
|
204
|
+
exactly with `<Section name="tasks">` and
|
|
205
|
+
`<Section name="metrics">`. Drift breaks i18n + the
|
|
206
|
+
spec/runtime contract.
|
|
207
|
+
- Per-section prose (`purpose`, `textSlots.title.purpose`,
|
|
208
|
+
`textSlots.description.purpose`) — what AI / labelling pipelines
|
|
209
|
+
read to generate tone-appropriate copy. Each section is described
|
|
210
|
+
in terms of *what it's about*, not *how it looks*.
|
|
211
|
+
- `codeHandling.definitionOwner: { ownerId: 'tasks-manager',
|
|
212
|
+
ownerKind: SpecificationOwnerKind.DOMAIN_MODULE }` — typed enum,
|
|
213
|
+
not a string. Tells companion lookup which module owns the runtime
|
|
214
|
+
definition. Add `codeHandling.notes` for non-obvious wiring (e.g.
|
|
215
|
+
the spec/runtime parity contract for resource-owned composites).
|
|
216
|
+
- `businessConstraints` — guardrails the AI / docs layer should
|
|
217
|
+
preserve when it generates copy or migrations.
|
|
218
|
+
|
|
219
|
+
What is **not** in this block (and shouldn't be):
|
|
220
|
+
|
|
221
|
+
- No JSX — the spec is data-only; the React composite lives separately.
|
|
222
|
+
- No `<Embed*>` references — embeds are runtime concerns; the spec
|
|
223
|
+
describes section *meaning*, not what each section embeds.
|
|
224
|
+
- No raw label strings — `textSlots.*.purpose` describes intent;
|
|
225
|
+
the labelling pipeline generates the actual copy.
|
|
226
|
+
|
|
227
|
+
## References
|
|
228
|
+
|
|
229
|
+
- `references/composite-spec-sections.md` — section-id alignment with the JSX composite
|
|
230
|
+
- `references/framework-composite-view-specification-api.md` — `compositeViewSpecificationFromDefinition` factory + spec contract types
|
|
231
|
+
- `views-composite-authoring/SKILL.md` — runtime composite authoring (the parity counterpart)
|
|
232
|
+
|
|
233
|
+
## Verification
|
|
234
|
+
|
|
235
|
+
- [ ] Spec uses `compositeViewSpecificationFromDefinition({...}, () => ({...}))` (typed factory)
|
|
236
|
+
- [ ] `translationRef` uses `buildResourceCompositeViewTranslationRef(...)` or the app-level equivalent (no hand-written string)
|
|
237
|
+
- [ ] `sectionRefs:[...]` matches the runtime composite's `<Section name="...">` JSX exactly
|
|
238
|
+
- [ ] Every entry in `sectionRefs` has a matching key in `sections: { ... }` (and vice versa)
|
|
239
|
+
- [ ] Every section has a `purpose` and `textSlots.{title,description}.purpose`
|
|
240
|
+
- [ ] `codeHandling.definitionOwner.ownerKind` uses `SpecificationOwnerKind.*` (typed enum)
|
|
241
|
+
- [ ] Spec re-exported from the spec barrel and registered in `compositeViewSpecifications`
|
|
242
|
+
|
|
243
|
+
### Grep invariants
|
|
244
|
+
|
|
245
|
+
Run from the app root, substituting `<slug>` and `<view-ref>`:
|
|
246
|
+
|
|
247
|
+
| Invariant | Command |
|
|
248
|
+
|-----------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
249
|
+
| Spec uses the typed factory (no raw object) | `rg -n "compositeViewSpecificationFromDefinition\(" specifications/src/modules/<slug>/composite-views/` |
|
|
250
|
+
| `translationRef` uses the typed builder | `rg -n "translationRef:\s+build\w+CompositeViewTranslationRef\(" specifications/src/modules/<slug>/composite-views/<view-ref>.composite-view.specification.ts` |
|
|
251
|
+
| **No hand-written translation ref** (must be empty) | `rg -n "translationRef:\s+'" specifications/src/modules/<slug>/composite-views/` |
|
|
252
|
+
| `sectionRefs` declared in spec | `rg -oN "sectionRefs:\s+\[\K[^\]]+" specifications/src/modules/<slug>/composite-views/<view-ref>.composite-view.specification.ts` |
|
|
253
|
+
| `<Section name>` declared in JSX (must be the same set as `sectionRefs`) | `rg -oN "<Section\s+name=\"\K[^\"]+" frontend/src/modules/<slug>/**/*CompositeView.tsx` |
|
|
254
|
+
| Spec re-exported from companion bundle | `rg -n "<view-ref>CompositeViewSpecification" specifications/src/companion-exports.ts` |
|
|
255
|
+
|
|
256
|
+
The high-signal invariant is the **`sectionRefs` ↔ `<Section name>` set
|
|
257
|
+
parity**. Run both lists and `comm` / `diff` them — if they differ in
|
|
258
|
+
either direction, the spec/runtime contract is broken and i18n keys or
|
|
259
|
+
section ordering will silently misbehave.
|
|
260
|
+
|
|
261
|
+
## Common Rationalizations
|
|
262
|
+
|
|
263
|
+
| Rationalization | Reality |
|
|
264
|
+
|-----------------|---------|
|
|
265
|
+
| "Titles inline are fine" | Spec-driven titles flow through the labelling pipeline as keys; inline JSX strings short-circuit i18n + bypass companion / AI awareness. |
|
|
266
|
+
| "I can rename a section ref without touching the spec" | The `sectionRefs:[...]` array is the truth contract — renaming the JSX `<Section name>` without updating spec drops i18n keys + breaks companion. |
|
|
267
|
+
| "I'll skip `codeHandling` — it's optional" | Without `codeHandling.definitionOwner`, the companion can't locate the runtime definition; AI tools start hallucinating ownership. |
|
|
268
|
+
| "I can hand-build the translation ref string" | Hand-built refs drift the moment a builder convention changes; the typed builder is the only durable wiring. |
|
|
269
|
+
|
|
270
|
+
## Red Flags
|
|
271
|
+
|
|
272
|
+
- Spec section count differs from React `<Section name>` count without an intentional feature flag (catch with the **`sectionRefs` ↔ `<Section name>` set parity** check)
|
|
273
|
+
- Hand-written `translationRef:` string instead of the typed builder (catch with the **No hand-written translation ref** grep — must be empty)
|
|
274
|
+
- Spec exported from the file but missing from `specificationsCompanionExports.compositeViewSpecifications` — companion will silently 404 the view
|
|
275
|
+
- Spec authored without `codeHandling.definitionOwner` — downstream tools can't follow the spec → runtime symbol chain
|
|
276
|
+
|
|
277
|
+
## Related Skills
|
|
278
|
+
|
|
279
|
+
- `views-composite-authoring` — runtime composite authoring (the JSX/runtime counterpart this spec must mirror)
|
|
280
|
+
- `views-app-level` — app-level composite registration (registers the runtime composite the spec describes)
|
|
281
|
+
- `module-companion-exports` — wiring the spec into `companion-exports.ts`
|
|
282
|
+
- `spec-update-after-change` — orchestrating multi-file spec updates after a change
|
|
283
|
+
- `i18n-rerun-pipeline` — re-generating labels after section/title changes
|
package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
# Composite View Specification — Sections
|
|
2
|
+
|
|
3
|
+
- Each section entry needs **id**, **title labels**, and embed metadata matching React.
|
|
4
|
+
- Translation refs must exist for user-visible titles.
|
|
5
|
+
- Nested sections follow the same id stability rules as `views-composite-authoring`.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Composite view specification (source)
|
|
2
|
+
|
|
3
|
+
- `CompositeViewSpecificationCodeHandling`, `CompositeViewSpecificationConfig`, and keyed `CompositeViewSpecification` for `*.composite-view.specification.ts`.
|
|
4
|
+
|
|
5
|
+
## Import Origins
|
|
6
|
+
|
|
7
|
+
- `@wildo-ai/saas-specifications`
|
|
8
|
+
|
|
9
|
+
## Source Excerpts
|
|
10
|
+
|
|
11
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
*
|
|
15
|
+
* Composite view semantic overlay: `codeHandling`, section/translation slots, and keyed `CompositeViewSpecification` map.
|
|
16
|
+
*/
|
|
17
|
+
export interface CompositeViewSpecificationCodeHandling {
|
|
18
|
+
/** Module/application owner that authored the view. */
|
|
19
|
+
definitionOwner?: SpecificationOwnerRef;
|
|
20
|
+
/** Public symbol exposing the authored composite view component. */
|
|
21
|
+
viewComponentSymbol?: PublicCodeSymbolRef;
|
|
22
|
+
/** Public declarations where the composite view is wired into runtime registries. */
|
|
23
|
+
declarationSymbols?: PublicCodeSymbolRef[];
|
|
24
|
+
/** Extra caveats for coding/transposition consumers. */
|
|
25
|
+
notes?: string[];
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export interface CompositeViewSpecificationConfig {
|
|
29
|
+
/** Stable runtime translation identity for this composite surface. */
|
|
30
|
+
translationRef: string;
|
|
31
|
+
/** Why this composite surface exists from a product/workflow perspective. */
|
|
32
|
+
purpose: string;
|
|
33
|
+
/** Interaction role this composite plays in the surrounding UX. */
|
|
34
|
+
uiRole: string;
|
|
35
|
+
/** Situations where this composite surface is the right destination. */
|
|
36
|
+
useWhen?: string;
|
|
37
|
+
/** Situations where another surface should be preferred. */
|
|
38
|
+
avoidWhen?: string;
|
|
39
|
+
/** Meaning of the composite-view-level translatable slots. */
|
|
40
|
+
textSlots?: TranslationSlotSpecificationMap;
|
|
41
|
+
/** Meaning of each declared section inside the composite. */
|
|
42
|
+
sections?: Record<string, StructuralTranslationSlotSpecification>;
|
|
43
|
+
/** Additional domain constraints that matter beyond raw runtime structure. */
|
|
44
|
+
businessConstraints?: string[];
|
|
45
|
+
/** Import-oriented coding/transposition metadata. */
|
|
46
|
+
codeHandling?: CompositeViewSpecificationCodeHandling;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Keyed by the stable runtime translation identity (for example `app.foo`). */
|
|
50
|
+
export type CompositeViewSpecification = Record<string, CompositeViewSpecificationConfig>;
|
|
51
|
+
```
|
|
@@ -0,0 +1,300 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spec-family-update
|
|
3
|
+
description: Author or update product, role, and milestone family specifications with stable ids, cross-links, and `codeHandling` wiring. Use when the user says "spec out a new product tier", "rename a role spec", "update the milestone narrative", "add a new product/role/milestone spec", "the family spec ids drifted from the runtime enum", or any change to product / role / milestone definition family records.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Spec Family Update
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Mechanism skill for the three **definition-family specifications** —
|
|
23
|
+
product, role, and milestone — that share enough authoring shape to
|
|
24
|
+
warrant one skill instead of three near-duplicates. Family specs
|
|
25
|
+
serve three consumers:
|
|
26
|
+
|
|
27
|
+
1. The **AI / companion / docs pipeline** — `purpose`,
|
|
28
|
+
`businessRole`, `useWhen`, `avoidWhen`, and `businessConstraints`
|
|
29
|
+
ground tools in *what each family record means*.
|
|
30
|
+
2. The **definition lookup** — `codeHandling.definitionOwner`,
|
|
31
|
+
`definitionSymbol`, `definitionCollectionEntry`, and
|
|
32
|
+
`identifierDeclaration` let companion follow the spec back to the
|
|
33
|
+
runtime enum member + collection entry.
|
|
34
|
+
3. The **packaging / commerce / org structure layers** — product
|
|
35
|
+
specs feed pricing tables; role specs feed permission narratives;
|
|
36
|
+
milestone specs feed onboarding and progression UIs.
|
|
37
|
+
|
|
38
|
+
These three families are spec'd through the **same shape** as feature
|
|
39
|
+
specs (`*FamilySpecificationConfig`-style records) — the difference
|
|
40
|
+
is which collection (`CUSTOM_PRODUCT_DEFINITIONS`,
|
|
41
|
+
`CUSTOM_ROLE_DEFINITIONS`, `CUSTOM_MILESTONE_DEFINITIONS`) the spec
|
|
42
|
+
follows.
|
|
43
|
+
|
|
44
|
+
> **Anchor status**: no Tier A application example exists yet
|
|
45
|
+
> (the example app does not currently ship product / role / milestone
|
|
46
|
+
> family specs). Until one does, this skill follows
|
|
47
|
+
> `spec-feature-update` for the spec shape and points readers at the
|
|
48
|
+
> framework-feature anchor to mirror the `codeHandling` wiring
|
|
49
|
+
> pattern. Add a Tier A anchor as soon as an application ships a
|
|
50
|
+
> family-spec example.
|
|
51
|
+
|
|
52
|
+
### A fourth definition family: error-message specs
|
|
53
|
+
|
|
54
|
+
`ErrorMessageSpecificationConfig` shares the SAME definition base
|
|
55
|
+
(`ref` + `purpose` + `businessRole`) and adds a required `audience`
|
|
56
|
+
(`END_USER` / `ADMIN` / `DEVELOPER`). It differs from the three above in
|
|
57
|
+
two ways that change how you treat it:
|
|
58
|
+
|
|
59
|
+
- **Consumer is the i18n label generator**, not pricing/permissions/
|
|
60
|
+
onboarding. `purpose` is the user-facing intent (the
|
|
61
|
+
`errors_messages.<ref>.msg` seed); `audience` sets the writing register.
|
|
62
|
+
- **It is engine-authored and app-level only.** The engine ships an
|
|
63
|
+
exhaustive overlay over every `ErrorCustomMessageReference` (authored or
|
|
64
|
+
`null` for internal refs), so an application gets quality error copy
|
|
65
|
+
automatically — there is no per-app enum + collection to co-author. Reach
|
|
66
|
+
for `references/framework-error-message-specifications-api.md` only when
|
|
67
|
+
overriding a reference's wording register/intent or reviewing how
|
|
68
|
+
generated error copy is grounded.
|
|
69
|
+
|
|
70
|
+
## App Paths
|
|
71
|
+
|
|
72
|
+
| Surface | Glob (relative to repo root) |
|
|
73
|
+
|--------------------------------------|---------------------------------------------------------------------------------------------------------------|
|
|
74
|
+
| Product spec | `specifications/src/products/<product>.product.specification.ts` or `specifications/src/modules/<slug>/products/<product>.product.specification.ts` |
|
|
75
|
+
| Role spec | `specifications/src/roles/<role>.role.specification.ts` or `specifications/src/modules/<slug>/roles/<role>.role.specification.ts` |
|
|
76
|
+
| Milestone spec | `specifications/src/milestones/<milestone>.milestone.specification.ts` or `specifications/src/modules/<slug>/milestones/<milestone>.milestone.specification.ts` |
|
|
77
|
+
| Family spec barrels | `specifications/src/products/index.ts`, `specifications/src/roles/index.ts`, `specifications/src/milestones/index.ts` |
|
|
78
|
+
| Companion exports | `specifications/src/companion-exports.ts` (`productSpecifications`, `roleSpecifications`, `milestoneSpecifications` slots) |
|
|
79
|
+
| Family enums (parity) | `shared-lib/src/products/custom-products.ts`, `shared-lib/src/roles/custom-roles.ts`, `shared-lib/src/milestones/custom-milestones.ts` |
|
|
80
|
+
| Family definition collections | `shared-lib/src/products/custom-product-definitions.ts`, `shared-lib/src/roles/custom-role-definitions.ts`, `shared-lib/src/milestones/custom-milestone-definitions.ts` |
|
|
81
|
+
|
|
82
|
+
## When to Use
|
|
83
|
+
|
|
84
|
+
- Adding a new product tier, role, or milestone — author the spec
|
|
85
|
+
alongside the enum member + collection entry
|
|
86
|
+
- Renaming a family record — update the spec's
|
|
87
|
+
`identifierDeclaration` + collection entry + cross-references
|
|
88
|
+
- Updating tier pricing narrative, role permissions narrative, or
|
|
89
|
+
milestone progression narrative
|
|
90
|
+
- Re-pointing `definitionOwner` after a family record moves modules
|
|
91
|
+
|
|
92
|
+
## When NOT to Use
|
|
93
|
+
|
|
94
|
+
- Resource field semantics → `spec-resource-update`
|
|
95
|
+
- Feature flag semantics → `spec-feature-update`
|
|
96
|
+
- Component slot semantics → `spec-component-update`
|
|
97
|
+
- Composite view section semantics → `spec-composite-view-update`
|
|
98
|
+
- Wiring the spec into companion exports → `module-companion-exports`
|
|
99
|
+
- Zod **schema** family authoring (e.g. money, range, duration) →
|
|
100
|
+
`resource-schema-authoring` (distinct concept — schema families are
|
|
101
|
+
Zod-side, not definition-family specs)
|
|
102
|
+
|
|
103
|
+
## Workflow
|
|
104
|
+
|
|
105
|
+
### Step 1: Pick the family + locate the enum member
|
|
106
|
+
|
|
107
|
+
Use `references/family-spec-routing.md` to pick the file pattern.
|
|
108
|
+
Whichever family (product / role / milestone), the spec must follow
|
|
109
|
+
its runtime backbone:
|
|
110
|
+
|
|
111
|
+
1. Add the member to the family enum (e.g. `CustomProduct.PREMIUM`)
|
|
112
|
+
2. Add the matching entry to the family collection
|
|
113
|
+
(`CUSTOM_PRODUCT_DEFINITIONS[CustomProduct.PREMIUM] = {...}`)
|
|
114
|
+
3. Add cross-links if the family interacts with another (e.g. a
|
|
115
|
+
role spec that requires a product tier)
|
|
116
|
+
|
|
117
|
+
### Step 2: Mirror a sibling spec
|
|
118
|
+
|
|
119
|
+
Find the closest sibling family record under the same family folder
|
|
120
|
+
and copy the spec shape. Sibling parity is the cheapest correctness
|
|
121
|
+
signal.
|
|
122
|
+
|
|
123
|
+
### Step 3: Author the prose blocks
|
|
124
|
+
|
|
125
|
+
- `purpose` — what this family record means (one or two sentences)
|
|
126
|
+
- `businessRole` — what business outcome it drives
|
|
127
|
+
- `useWhen` / `avoidWhen` — explicit inclusion / exclusion criteria
|
|
128
|
+
- `businessConstraints` — guardrails the AI / docs / pricing /
|
|
129
|
+
permissions layer must preserve
|
|
130
|
+
|
|
131
|
+
### Step 4: Wire `codeHandling`
|
|
132
|
+
|
|
133
|
+
Same shape as the feature spec:
|
|
134
|
+
|
|
135
|
+
- `definitionOwner: { ownerId, ownerKind: SpecificationOwnerKind.* }`
|
|
136
|
+
- `definitionSymbol` — the family collection symbol
|
|
137
|
+
(`CUSTOM_PRODUCT_DEFINITIONS` etc.)
|
|
138
|
+
- `definitionCollectionEntry` — `identifierField: 'identifier'` +
|
|
139
|
+
`identifierValue: <FamilyEnum>.<MEMBER>`
|
|
140
|
+
- `identifierDeclaration` — typed enum reference (`packageName`,
|
|
141
|
+
`exportName: '<FamilyEnum>'`, `symbolKind: ENUM`,
|
|
142
|
+
`declarationKind: TYPESCRIPT_ENUM`, `memberName`)
|
|
143
|
+
- `supportingSymbols: [...]` — related runtime symbols (e.g. for a
|
|
144
|
+
product spec, the pricing-table symbol; for a role spec, the
|
|
145
|
+
permission-set symbol)
|
|
146
|
+
- `notes: [...]` — non-obvious wiring (e.g. cross-family
|
|
147
|
+
dependencies)
|
|
148
|
+
|
|
149
|
+
### Step 5: Register
|
|
150
|
+
|
|
151
|
+
1. Add the spec to the family map keyed by the enum member
|
|
152
|
+
2. Re-export from the family spec barrel
|
|
153
|
+
3. Verify it lands in `specificationsCompanionExports.<family>Specifications`
|
|
154
|
+
|
|
155
|
+
## Worked Example
|
|
156
|
+
|
|
157
|
+
Until an application ships a family-spec example, mirror the
|
|
158
|
+
`spec-feature-update` worked example for the spec shape — the
|
|
159
|
+
`codeHandling` wiring pattern is identical, only the collection
|
|
160
|
+
symbol and family enum change. The framework feature anchor
|
|
161
|
+
demonstrates the canonical typed `codeHandling` wiring you should
|
|
162
|
+
copy:
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
## Usage Example
|
|
166
|
+
|
|
167
|
+
```typescript
|
|
168
|
+
export const aiAssistantFeatureSpecification: FeatureSpecificationConfig = {
|
|
169
|
+
ref: ApplicationFeature.AI_ASSISTANT,
|
|
170
|
+
purpose: 'Gate AI-powered assistance that helps users turn task-management intent into faster action.',
|
|
171
|
+
businessRole: 'Premium capability flag controlling access to AI suggestion and automation experiences.',
|
|
172
|
+
availabilityRole: 'Addon-style paid capability that can be surfaced as an upsell boundary when the tenant has not enabled it.',
|
|
173
|
+
useWhen: 'Use this feature when the experience needs generative help, AI-assisted drafting, or automation that goes beyond standard task CRUD.',
|
|
174
|
+
avoidWhen: 'Avoid tying non-AI baseline task management to this flag; core todo creation and execution should remain available without the addon.',
|
|
175
|
+
businessConstraints: [
|
|
176
|
+
'This flag should stay focused on AI-augmented experiences, not become a catch-all switch for unrelated premium UX polish.',
|
|
177
|
+
'Because the authored unavailability policy suggests an addon product, prompts and generators should preserve the monetization posture instead of treating the feature as a hidden internal toggle.',
|
|
178
|
+
],
|
|
179
|
+
codeHandling: {
|
|
180
|
+
definitionOwner: {
|
|
181
|
+
ownerId: 'engine',
|
|
182
|
+
ownerKind: SpecificationOwnerKind.APPLICATION_ENGINE,
|
|
183
|
+
},
|
|
184
|
+
definitionSymbol: {
|
|
185
|
+
packageName: '@your-app/shared-lib',
|
|
186
|
+
exportName: 'CUSTOM_FEATURE_DEFINITIONS',
|
|
187
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
188
|
+
},
|
|
189
|
+
definitionCollectionEntry: {
|
|
190
|
+
collectionSymbol: {
|
|
191
|
+
packageName: '@your-app/shared-lib',
|
|
192
|
+
exportName: 'CUSTOM_FEATURE_DEFINITIONS',
|
|
193
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
194
|
+
},
|
|
195
|
+
identifierField: 'identifier',
|
|
196
|
+
identifierValue: ApplicationFeature.AI_ASSISTANT,
|
|
197
|
+
},
|
|
198
|
+
identifierDeclaration: {
|
|
199
|
+
declaration: {
|
|
200
|
+
packageName: '@your-app/shared-lib',
|
|
201
|
+
exportName: 'ApplicationFeature',
|
|
202
|
+
symbolKind: CodeSymbolKind.ENUM,
|
|
203
|
+
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
204
|
+
},
|
|
205
|
+
memberName: 'AI_ASSISTANT',
|
|
206
|
+
},
|
|
207
|
+
supportingSymbols: [
|
|
208
|
+
{
|
|
209
|
+
packageName: '@your-app/shared-lib',
|
|
210
|
+
exportName: 'FEATURE_PROFILES',
|
|
211
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
212
|
+
},
|
|
213
|
+
{
|
|
214
|
+
packageName: '@your-app/shared-lib',
|
|
215
|
+
exportName: 'CUSTOM_UNAVAILABILITY_POLICY',
|
|
216
|
+
symbolKind: CodeSymbolKind.CONFIG,
|
|
217
|
+
},
|
|
218
|
+
],
|
|
219
|
+
notes: [
|
|
220
|
+
'The runtime definition lives inside the public `CUSTOM_FEATURE_DEFINITIONS` collection; downstream tools should locate the matching entry by `identifier` rather than assume a dedicated per-feature export exists.',
|
|
221
|
+
'This feature is intentionally linked to paid availability posture, so generated UX or docs should preserve the addon/upgrades framing instead of describing it as always-on engine capability.',
|
|
222
|
+
],
|
|
223
|
+
},
|
|
224
|
+
};
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
When porting to a family spec, swap:
|
|
228
|
+
|
|
229
|
+
- `CUSTOM_FEATURE_DEFINITIONS` → `CUSTOM_PRODUCT_DEFINITIONS` /
|
|
230
|
+
`CUSTOM_ROLE_DEFINITIONS` / `CUSTOM_MILESTONE_DEFINITIONS`
|
|
231
|
+
- `ApplicationFeature` → `CustomProduct` / `CustomRole` /
|
|
232
|
+
`CustomMilestone`
|
|
233
|
+
- `featureSpecifications` map → `productSpecifications` /
|
|
234
|
+
`roleSpecifications` / `milestoneSpecifications`
|
|
235
|
+
- `availabilityRole` (feature-only) → drop in family specs (use
|
|
236
|
+
`businessRole` and family-specific prose instead)
|
|
237
|
+
|
|
238
|
+
## References
|
|
239
|
+
|
|
240
|
+
- `references/family-spec-routing.md` — file patterns per family
|
|
241
|
+
- `references/framework-family-specifications-api.md` — product / milestone / role spec types
|
|
242
|
+
- `references/framework-error-message-specifications-api.md` — error-message spec (engine-authored, label-generation register/intent)
|
|
243
|
+
- `spec-feature-update` — shape this skill mirrors (same `codeHandling` pattern)
|
|
244
|
+
- `resource-schema-authoring` → `references/framework-schema-family-api.md` — Zod **schema** families (distinct from definition-family specs above)
|
|
245
|
+
|
|
246
|
+
## Verification
|
|
247
|
+
|
|
248
|
+
- [ ] Family enum member exists for the spec
|
|
249
|
+
- [ ] Matching family collection entry keyed by `identifier`
|
|
250
|
+
- [ ] Spec uses the family-specific typed contract (`ProductSpecificationConfig` / `RoleSpecificationConfig` / `MilestoneSpecificationConfig`)
|
|
251
|
+
- [ ] `codeHandling.definitionOwner.ownerKind` uses `SpecificationOwnerKind.*`
|
|
252
|
+
- [ ] `codeHandling.definitionCollectionEntry.identifierField` is `'identifier'` and `identifierValue` is `<FamilyEnum>.<MEMBER>`
|
|
253
|
+
- [ ] `codeHandling.identifierDeclaration.declaration.exportName` is the family enum name (typed enum reference)
|
|
254
|
+
- [ ] Spec registered in the family map and exported through the family spec barrel
|
|
255
|
+
- [ ] Spec lands in `specificationsCompanionExports.<family>Specifications`
|
|
256
|
+
|
|
257
|
+
### Grep invariants
|
|
258
|
+
|
|
259
|
+
Run from the repo root, substituting `<family>` (`product` / `role`
|
|
260
|
+
/ `milestone`), `<FamilyEnum>` (`CustomProduct` / `CustomRole` /
|
|
261
|
+
`CustomMilestone`), and `<MEMBER>`:
|
|
262
|
+
|
|
263
|
+
| Invariant | Command |
|
|
264
|
+
|---------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
265
|
+
| Definition collection entry uses the typed enum member | `rg -n "identifierValue:\s+<FamilyEnum>\.<MEMBER>" specifications/src/**/<family>s/` |
|
|
266
|
+
| **No string-literal identifier value** (must be empty) | `rg -n "identifierValue:\s+'" specifications/src/**/<family>s/` |
|
|
267
|
+
| Identifier declaration points at the family enum | `rg -n "exportName:\s+'<FamilyEnum>'" specifications/src/**/<family>s/` |
|
|
268
|
+
| Spec registered in the family map | `rg -n "<MEMBER>\]:\s+\w+<Family>Specification" specifications/src/<family>s/index.ts` |
|
|
269
|
+
| Enum member exists in the family enum | `rg -n "<MEMBER>" shared-lib/src/<family>s/custom-<family>s.ts` |
|
|
270
|
+
| Collection entry exists in `CUSTOM_<FAMILY>_DEFINITIONS` | `rg -n "<FamilyEnum>\.<MEMBER>" shared-lib/src/<family>s/custom-<family>-definitions.ts` |
|
|
271
|
+
| **Unique ids across the family** (must return 0 duplicates) | `rg -oN "identifierValue:\s+<FamilyEnum>\.\K[A-Z_]+" specifications/src/**/<family>s/ \| sort \| uniq -d` |
|
|
272
|
+
|
|
273
|
+
The high-signal invariant is **"unique ids across the family"** —
|
|
274
|
+
two specs that share the same `identifierValue` mean one silently
|
|
275
|
+
shadows the other in the family map; companion will lose half the
|
|
276
|
+
narrative.
|
|
277
|
+
|
|
278
|
+
## Common Rationalizations
|
|
279
|
+
|
|
280
|
+
| Rationalization | Reality |
|
|
281
|
+
|-----------------|---------|
|
|
282
|
+
| "Rename id casually" | Analytics, billing, permission systems, and companion all cache by id; renaming without a migration record breaks all four. |
|
|
283
|
+
| "Two families can share the same id namespace" | Each family has its own enum and collection; cross-family id sharing breaks runtime resolution. |
|
|
284
|
+
| "I'll skip cross-family `supportingSymbols`" | When a role spec depends on a product tier, omitting the supporting symbol drops the cross-family link from companion / AI authoring. |
|
|
285
|
+
| "Schema families and definition families are the same thing" | They are not. Schema families (money, range, duration) are Zod factories under `resource-schema-authoring`; definition families (product, role, milestone) are this skill. |
|
|
286
|
+
|
|
287
|
+
## Red Flags
|
|
288
|
+
|
|
289
|
+
- Duplicate `identifierValue` across two specs in the same family (catch with the **Unique ids across the family** grep — must return 0 lines)
|
|
290
|
+
- Spec exists but family enum member does not (broken chain)
|
|
291
|
+
- Spec exists but no matching family collection entry (companion can't resolve definition)
|
|
292
|
+
- `identifierValue:` is a string literal instead of `<FamilyEnum>.<MEMBER>`
|
|
293
|
+
- Family record renamed in the enum but the spec's `memberName` still references the old name
|
|
294
|
+
|
|
295
|
+
## Related Skills
|
|
296
|
+
|
|
297
|
+
- `spec-feature-update` — sibling pattern (same `codeHandling` shape)
|
|
298
|
+
- `spec-update-after-change` — orchestrating multi-file spec updates after a change
|
|
299
|
+
- `module-companion-exports` — wiring the spec into `companion-exports.ts`
|
|
300
|
+
- `resource-schema-authoring` — Zod **schema** families (distinct concept; do not conflate)
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Family Specs — Product, Role, Milestone
|
|
2
|
+
|
|
3
|
+
| Family | Typical file glob |
|
|
4
|
+
|--------|-------------------|
|
|
5
|
+
| Product | `*.product.specification.ts` |
|
|
6
|
+
| Role | `*.role.specification.ts` |
|
|
7
|
+
| Milestone | `*.milestone.specification.ts` |
|
|
8
|
+
|
|
9
|
+
Shared rules:
|
|
10
|
+
|
|
11
|
+
- Stable ids for downstream analytics and companion
|
|
12
|
+
- Cross-links to features/resources when your model uses them
|
|
13
|
+
- Translation for user-visible names
|