FF KB

Log

9 min read

[2026-04-27] ingest | Collaboration That Compounds

Ingested Collaboration That Compounds. This is a renamed and rewritten version of the original “Repository as the Nerve Center” Confluence page (same page ID). Introduces the three-layer repo model (codebase, knowledge base, project toolkit) and a sharper “origin point” framing.

Details:

  • Updated repository-nerve-center with the three-layer model, “Claude as Origin Point” section, refined problem statement, and outcome framing
  • Bumped confidence to high — now backed by three independent sources
  • No new pages created; all content folded into the existing concept page

Pages touched: repository-nerve-center

[2026-04-23] ingest | Accessibility: Icon-Only Table Cells

Ingested Accessibility: Icon-Only Table Cells capturing the pattern for making icon-driven comparison tables announce correctly to screen readers.

Details:

  • Created accessibility under engineering/ as the home for a11y worked examples; added link in kb/index.md
  • Documented the symmetric fix (aria-label on the icon + sr-only span for the empty cell), surrounding table-structure requirements (caption, scope), VoiceOver verification steps, and the decorative-icon inverse pattern (aria-hidden="true")
  • Kept localization advisory — the pattern works single-language or i18n-routed

Pages touched: accessibility

[2026-04-23] update | Wiki Restructuring

Restructured KB directory layout and renamed pages.

Details:

  • Created engineering/shopify/ subfolder, moved bundles and combined-listings into it
  • Moved placeholder-development from process/ to engineering/ — it’s a development practice, not a planning methodology
  • Renamed pages to drop redundant suffixes: code-review-guidelines → code-review, pull-request-guidelines → pull-requests, core-skills-training → core-skills, hydrogen-development-training → hydrogen-development
  • Added intro paragraphs to all folder index pages
  • Updated all wikilinks across the wiki

Pages touched: code-review, pull-requests, core-skills, hydrogen-development, bundles, combined-listings, placeholder-development, repository-nerve-center

[2026-04-23] ingest | Hydrogen Combined Listings Recipe

Ingested Hydrogen Combined Listings Recipe and Hydrogen Combined Listings LLM Prompt from Shopify Hydrogen cookbook.

Details:

  • Updated combined-listings with Hydrogen storefront implementation section: tag-based detection, UI patterns (hide cart button, price range, featured image), parent filtering strategies, configuration, files touched
  • Promoted page status from seed to developing

Pages touched: combined-listings

[2026-04-23] ingest | Combined Listings (shopify.dev)

Ingested Combined Listings and Build for Combined Listings from shopify.dev.

Details:

  • Created combined-listings entity page covering parent-child structure, limits, Admin API (productSet + combinedListingUpdate), querying, editing, and relationship to bundles
  • Updated bundles with cross-references and sources

Pages touched: combined-listings, bundles

[2026-04-23] ingest | Shopify Bundles with Combined Listings

Ingested Shopify Bundles with Combined Listings (human note).

Details:

  • Updated bundles with combined listings deep-dive: why variant-fixed is required, option mapping (parent → component group, child → option value, child variants → secondary options), pricing formula, two-step save flow (productSet → productVariantRelationshipBulkUpdate), and API limits
  • Updated comparison table and “When to Use Each” to surface combined listings as key trigger for variant-fixed

Pages touched: bundles

[2026-04-23] lint | Bundles Pages Consolidation

Ran /kb-lint focused on bundles pages.

Details:

  • Merged the former shopify-bundles-api page into bundles — the two pages covered overlapping content from different angles (API reference vs recipe walkthrough). Consolidated into a single decision-oriented guide focused on helping developers pick the right bundle type for a Hydrogen storefront.
  • Reframed page away from “Hydrogen’s bundles recipe” framing (source-centric) toward a practical implementation guide (reader-centric)
  • Added comparison table, “When to Use Each” section, and analysis callout with default recommendation
  • Removed 4 index completeness warnings (directory index.md files are not listed in the KB index by convention)
  • 1 manifest drift issue noted: raw/notes/nerve-center-operational-details.md needs re-ingest

Pages touched: bundles

[2026-04-22] ingest | Form Factory Operating Model

Ingested Form Factory Operating Model from Confluence (FF space).

Details:

Pages touched: operating-model, repository-nerve-center, user-story-guide, placeholder-development

[2026-04-22] note | Nerve Center Operational Details

Captured human notes on the nerve center concept. Nerve Center Operational Details

Details:

  • Updated repository-nerve-center with per-project mono-repo scope, tools as sources of truth (risk of undermining them), drift reconciliation as primary goal, skills over infrastructure, meeting transcript handling
  • Key insight: the repo is per-project, and the main job is keeping existing tools in sync — not replacing them

Pages touched: repository-nerve-center

[2026-04-22] ingest | The Repository as the Nerve Center

Ingested The Repository as the Nerve Center from Confluence (FF space).

Details:

Pages touched: repository-nerve-center, slack-channel-structure, index

[2026-04-18] ingest | Turn On Bundle Publishing (shopify.dev)

Ingested Turn On Bundle Publishing from shopify.dev.

Details:

  • Updated bundles Sales Channel Support section: publishing disabled by default, only product fixed bundles supported, requires app to be sales channel. Added custom storefront publishing to Limitations.

Pages touched: bundles

[2026-04-18] ingest | Create Bundle App Tutorial (shopify.dev)

Ingested Create Bundle App from shopify.dev.

Details:

  • Updated bundles with Merge operation (linesMerge) alongside Expand, detailed metafield type information, component_parents JSON schema, and GID format note

Pages touched: bundles

[2026-04-18] ingest | Migrate Config Extension to CLI (shopify.dev)

Ingested Migrate Config Extension to CLI from shopify.dev.

Details:

  • Added migration note to bundles Product Configuration Extension section (Partner Dashboard → CLI TOML migration)

Pages touched: bundles

[2026-04-18] ingest | Add Merchant Config UI (shopify.dev)

Ingested Add Merchant Config UI from shopify.dev.

Details:

  • Updated bundles Admin UI section with product configuration extension details: two targets, ui_extension type, RFC 6570 edit links, CLI 3.76+ requirement, API version 2025-01

Pages touched: bundles

[2026-04-18] ingest | Add Customized Bundle Function (shopify.dev)

Ingested Add Customized Bundle Function from shopify.dev.

Details:

  • Updated bundles Customized Bundles section with Cart Transform Function details (API 2025-07+, Expand operations), cartTransformCreate activation mutation, access scopes (write_cart_transforms + write_products), data source comparison (metafields vs line item properties), and corrected component_reference metafield description

Pages touched: bundles

[2026-04-18] ingest | Add Variant Fixed Bundle (shopify.dev)

Ingested Add Variant Fixed Bundle from shopify.dev.

Details:

  • Updated bundles Variant Fixed Bundles section with two-step creation workflow, productVariantRelationshipBulkUpdate input structure, productVariantComponents relationship model, and requiresComponents detection link to bundles

Pages touched: bundles

[2026-04-18] ingest | Add Product Fixed Bundle (shopify.dev)

Ingested Add Product Fixed Bundle from shopify.dev.

Details:

  • Updated bundles Product Fixed Bundles section with mutation details (productBundleCreate/productBundleUpdate), async polling workflow, write_products scope, bundleComponents relationship model, consolidated options mechanism, app-exclusive management, and no-nesting constraint
  • Added new limitations: no nesting, app-exclusive management, quantity option combining restriction

Pages touched: bundles

[2026-04-18] ingest | Add a Fixed Bundle (shopify.dev)

Ingested Add a Fixed Bundle from shopify.dev.

Details:

  • Overview page with minimal new content; added as source reference to bundles
  • Added detail about automatic variant mapping for product fixed bundles

Pages touched: bundles

[2026-04-18] ingest | Start Building Bundles (shopify.dev)

Ingested Start Building Bundles from shopify.dev.

Details:

  • Updated bundles with pricing models (parent-derived vs component-derived), tax computation, oversell protection differences, storefront behavior, shared behaviors (discounts, cart display, fulfillment, refunds, reporting)

Pages touched: bundles

[2026-04-18] ingest | Shopify Bundles Overview (shopify.dev)

Ingested Shopify Bundles Overview from shopify.dev official docs.

Details:

  • Updated bundles with store eligibility (BundlesFeature), bundle lifecycle table, build surfaces, sales channel support, and limitations (selling plans restriction, Scripts sunset June 30, 2026)

Pages touched: bundles

[2026-04-18] ingest | Shopify Bundles

Ingested Shopify Bundles from Confluence (ENG space).

Details:

  • Created entity page covering Fixed Bundles (product-level and variant-level), Customized Bundles (mix-and-match via cart_transform), Admin API mutations, limits, metafields, and admin UI extensions
  • Added cross-reference from bundles to combined-listings

Pages touched: bundles, combined-listings

[2026-04-18] ingest | Hydrogen Bundles LLM Prompt

Ingested Hydrogen Bundles LLM Prompt.

Details:

  • Added raw source from Hydrogen’s official LLM prompt for bundles recipe
  • Updated bundles with adaptation guidance for non-skeleton projects and codegen note
  • Added second source reference

Pages touched: bundles

[2026-04-18] ingest | Hydrogen Bundles Recipe

Ingested code documentation from Shopify Hydrogen’s bundles cookbook recipe.

Details:

  • Generated raw source from codebase analysis (2 new components, 9 patch files)
  • Created KB page covering bundle detection pattern, components, GraphQL changes, and modified files
  • Cross-referenced with hydrogen-development

Pages touched: bundles

[2026-04-17] ingest | Slack Channel Structure

Ingested Slack Channel Structure.

Details:

  • Created summary page with channel list, naming conventions, and sidebar recommendations
  • Initialized Company section in KB index

Pages touched: slack-channel-structure

[2026-04-17] ingest | Hydrogen Development Training

Ingested Hydrogen Development Training.

Details:

  • Created summary page with three-tiered curriculum (37 resources across levels)
  • Added cross-references to core-skills and pull-requests

Pages touched: hydrogen-development, core-skills

[2026-04-17] ingest | Core Skills Training

Ingested Core Skills Training.

Details:

  • Created summary page with curated reading list across five skill categories
  • Initialized Training section in KB index

Pages touched: core-skills

[2026-04-17] ingest | Story Point Matrix

Ingested Story Point Matrix.

Details:

  • Created summary page with Fibonacci estimation scale
  • Added cross-references to user-story-guide (INVEST table)

Pages touched: story-point-matrix, user-story-guide

[2026-04-17] ingest | Product Backlog Example

Ingested Product Backlog Example.

Details:

  • Created summary page demonstrating the full user story process end-to-end
  • Added cross-reference to user-story-guide (writing process section)

Pages touched: product-backlog-example, user-story-guide

[2026-04-17] ingest | User Story Themes

Ingested User Story Themes.

Details:

  • Created summary page with theme taxonomy (Product Value, Platform Capability, Cross-Cutting Concerns)
  • Added cross-reference to user-story-guide (epics section)

Pages touched: user-story-themes, user-story-guide

[2026-04-17] ingest | User Story Guide

Ingested User Story Guide.

Details:

  • Created summary page covering frameworks (3Ws, INVEST, 3Cs), writing process, enablers, and Definition of Ready/Done
  • Added cross-reference to placeholder-development (enabler tickets)

Pages touched: user-story-guide, placeholder-development

[2026-04-17] ingest | Using Placeholders to Unblock End-to-End Development

Ingested Using Placeholders to Unblock End-to-End Development.

Details:

  • Created summary page covering placeholder types, conventions, and decision guide
  • Added cross-reference to code-review (non-blocking comments for follow-up tickets)

Pages touched: placeholder-development, code-review

[2026-04-17] ingest | Pull Request Guidelines

Ingested Pull Request Guidelines.

Details:

  • Created summary page for PR creation and management standards
  • Added cross-references to code-review

Pages touched: pull-requests, code-review

[2026-04-17] ingest | Code Review Guidelines

Ingested Code Review Guidelines.

Details:

  • Created summary page for Form Factory’s code review standards
  • Initialized KB index and log

Pages touched: code-review

Graph View