Diff: architecture/vertical-seed-packs-marketplace.es
From bf9d2e1 to bf9d2e1
+0 / −0 lines
| Before | After |
|---|---|
| --- | --- |
| schema: foundry-doc-v1 | schema: foundry-doc-v1 |
| title: "Vertical seed packs marketplace" | title: "Vertical seed packs marketplace" |
| slug: vertical-seed-packs-marketplace | slug: vertical-seed-packs-marketplace |
| category: architecture | category: architecture |
| type: topic | type: topic |
| quality: complete | quality: complete |
| short_description: "PointSav intends to distribute curated industry-specific seed packs as starter taxonomies, enabling tenants to contribute refinements back through a planned marketplace." | short_description: "PointSav intends to distribute curated industry-specific seed packs as starter taxonomies, enabling tenants to contribute refinements back through a planned marketplace." |
| status: active | status: active |
| bcsc_class: public-disclosure-safe | bcsc_class: public-disclosure-safe |
| last_edited: 2026-05-01 | last_edited: 2026-05-01 |
| editor: pointsav-engineering | editor: pointsav-engineering |
| cites: [] | cites: [] |
| paired_with: vertical-seed-packs-marketplace.es.md | paired_with: vertical-seed-packs-marketplace.es.md |
| --- | --- |
| The **Vertical Seed Packs Marketplace** is a planned distribution mechanism for industry-specific starter taxonomies that provision the knowledge graph of a new customer tenant. Each pack bundles [[archetypes-and-chart-of-accounts|Archetypes, a Chart of Accounts]], Domains, Themes, a glossary, and [[mcp-substrate-protocol|MCP]] server extensions suited to a particular business vertical. Customers may install packs at provisioning, update them as new versions are released, and are intended to be able to contribute refinements back to the marketplace for other operators in the same vertical. See [[seed-taxonomy-as-smb-bootstrap|the seed-taxonomy SMB bootstrap]]. | The **Vertical Seed Packs Marketplace** is a planned distribution mechanism for industry-specific starter taxonomies that provision the knowledge graph of a new customer tenant. Each pack bundles [[archetypes-and-chart-of-accounts|Archetypes, a Chart of Accounts]], Domains, Themes, a glossary, and [[mcp-substrate-protocol|MCP]] server extensions suited to a particular business vertical. Customers may install packs at provisioning, update them as new versions are released, and are intended to be able to contribute refinements back to the marketplace for other operators in the same vertical. See [[seed-taxonomy-as-smb-bootstrap|the seed-taxonomy SMB bootstrap]]. |
| ## Pack content | ## Pack content |
| Each pack is a curated bundle in open formats: | Each pack is a curated bundle in open formats: |
| - Archetypes JSON file — industry-specific role identities | - Archetypes JSON file — industry-specific role identities |
| - Chart of Accounts JSON file — industry-specific business profiles | - Chart of Accounts JSON file — industry-specific business profiles |
| - Domains JSON file — macro work categories | - Domains JSON file — macro work categories |
| - Themes JSON file — starter time-bound initiatives (typically sparse; the customer adds their own) | - Themes JSON file — starter time-bound initiatives (typically sparse; the customer adds their own) |
| - Glossary CSV — terms in common use in the vertical | - Glossary CSV — terms in common use in the vertical |
| - MCP server extensions configuration — vertical-specific tools (for example, a point-of-sale integration for a restaurant or an electronic health record integration for a hospital) | - MCP server extensions configuration — vertical-specific tools (for example, a point-of-sale integration for a restaurant or an electronic health record integration for a hospital) |
| - Pack manifest — metadata, version, license, and contributors | - Pack manifest — metadata, version, license, and contributors |
| ## Reference packs | ## Reference packs |
| [[pointsav-overview|PointSav]] intends to develop and maintain a set of reference packs at Phase 5 launch. The planned set includes a pack for small and mid-size restaurants, one for law firms of thirty to three hundred lawyers, one for small and rural hospitals, one for mid-size property development firms, and a universal default pack for businesses that do not fit a specific vertical. | [[pointsav-overview|PointSav]] intends to develop and maintain a set of reference packs at Phase 5 launch. The planned set includes a pack for small and mid-size restaurants, one for law firms of thirty to three hundred lawyers, one for small and rural hospitals, one for mid-size property development firms, and a universal default pack for businesses that do not fit a specific vertical. |
| The Woodfine real estate pack is the current reference implementation, derived from the Woodfine deployment's existing seed taxonomy and validated in production operation. | The Woodfine real estate pack is the current reference implementation, derived from the Woodfine deployment's existing seed taxonomy and validated in production operation. |
| ## How packs are intended to be distributed | ## How packs are intended to be distributed |
| The planned distribution mechanism routes through the marketplace gateway. Operators are intended to browse available packs within the TUI, install a pack with a single command, and receive a diff preview before applying future pack updates. The install process imports the pack's JSON files into the per-tenant knowledge graph in [[service-content|`service-content`]] and immediately enables content classification. The operator then customizes the installed taxonomy for their specific business. | The planned distribution mechanism routes through the marketplace gateway. Operators are intended to browse available packs within the TUI, install a pack with a single command, and receive a diff preview before applying future pack updates. The install process imports the pack's JSON files into the per-tenant knowledge graph in [[service-content|`service-content`]] and immediately enables content classification. The operator then customizes the installed taxonomy for their specific business. |
| ## Customer contribution | ## Customer contribution |
| When a customer extends their pack with additions useful to others in the same vertical, they may be able to contribute the additions back. The intended flow guides the operator through review, sanitization, and consent before creating a marketplace contribution. Accepted contributions are intended to land in the next pack version, benefiting other tenants in the vertical without requiring [[pointsav-overview|PointSav]] to author all pack content. | When a customer extends their pack with additions useful to others in the same vertical, they may be able to contribute the additions back. The intended flow guides the operator through review, sanitization, and consent before creating a marketplace contribution. Accepted contributions are intended to land in the next pack version, benefiting other tenants in the vertical without requiring [[pointsav-overview|PointSav]] to author all pack content. |
| This contribution mechanism is the structural opening for community-driven vertical evolution. Its governance model — how contributions are reviewed and accepted — is a pending operator decision that will be determined during Phase 5 implementation. | This contribution mechanism is the structural opening for community-driven vertical evolution. Its governance model — how contributions are reviewed and accepted — is a pending operator decision that will be determined during Phase 5 implementation. |
| ## Pack licensing | ## Pack licensing |
| Reference packs are intended to ship under a permissive license. Customer-contributed additions would retain customer copyright but grant distribution rights for marketplace inclusion. | Reference packs are intended to ship under a permissive license. Customer-contributed additions would retain customer copyright but grant distribution rights for marketplace inclusion. |
| The [[customer-owned-graph-ip]] principle applies at the instance level, not the pack level: the customer's running knowledge graph (their customized instance of a pack) is their intellectual property; the pack itself is permissively licensed material that the customer customized from. | The [[customer-owned-graph-ip]] principle applies at the instance level, not the pack level: the customer's running knowledge graph (their customized instance of a pack) is their intellectual property; the pack itself is permissively licensed material that the customer customized from. |
| ## Composition | ## Composition |
| Vertical Seed Packs are the distribution mechanism for the [[seed-taxonomy-as-smb-bootstrap]] pattern — they carry the canonical form of the four-part taxonomy for a specific industry. The planned [[reverse-flow-substrate]] marketplace is intended to include packs as first-class inventory alongside data listings and adapter weights. | Vertical Seed Packs are the distribution mechanism for the [[seed-taxonomy-as-smb-bootstrap]] pattern — they carry the canonical form of the four-part taxonomy for a specific industry. The planned [[reverse-flow-substrate]] marketplace is intended to include packs as first-class inventory alongside data listings and adapter weights. |
| ## See also | ## See also |
| - [[seed-taxonomy-as-smb-bootstrap]] — the four-part taxonomy structure that packs instantiate | - [[seed-taxonomy-as-smb-bootstrap]] — the four-part taxonomy structure that packs instantiate |
| - [[customer-owned-graph-ip]] — the customer's customized instance is their IP; the pack itself is licensed | - [[customer-owned-graph-ip]] — the customer's customized instance is their IP; the pack itself is licensed |
| - [[reverse-flow-substrate]] — the planned marketplace gateway that would distribute packs | - [[reverse-flow-substrate]] — the planned marketplace gateway that would distribute packs |
| - [[mcp-substrate-protocol]] — pack MCP server extensions plug into the Doorman's tool discovery | - [[mcp-substrate-protocol]] — pack MCP server extensions plug into the Doorman's tool discovery |