Trace component origin and declarations down the bill of materials

For: Supply chain compliance manager answering origin, forced-labour or conflict-mineral questions

Pattern: Hierarchical decompositionNeeds scaleDesigned for 30 to 1,000 agents

The pain today

A customer or customs authority asks where a product's parts come from. The answer sits in supplier declarations, certificates of origin and sub-tier questionnaires for thousands of components, held by different buyers.

The ask

I attached the bill of materials for the product line and the supplier declarations, certificates of origin and questionnaires we have collected. For each product, tell me which components have documented origin, which declarations are missing, expired or inconsistent, and show the documents.

Plain words, as you would say it to a colleague. Edit it to fit your case before you send it.

What you attach or connect

  • Bill of materials per product
  • Supplier origin and material declarations
  • Certificates of origin and smelter or site lists
  • Sub-tier supplier questionnaires
  • The rule or customer requirement being answered

The unit of work

One worker task per one component and its supplier declaration.

Why a swarm fits

A product breaks down into assemblies, components, suppliers and sites. Each leaf needs only one component's documents, and a product-level answer is only as good as every verified leaf beneath it.

Not for

A product with a short bill of materials from a few known suppliers: one person with the folder answers it directly.

The decision tree

6 typed decisions, each with an action for every answer

At fixed moments in a run, the engine puts one narrow question to a decision model. The decision model never writes text: it answers yes or no with a probability, picks from listed options, or gives a score, about a small slice of the material. The engine then does exactly what this tree says, which is what makes the run auditable. The thresholds are the template's design values, not measured results.

  1. Planner, while planning

    Split or keep serialYes or no, with a probability

    While planning

    Does this assembly contain components from more than one supplier, so that its origin cannot be answered from a single declaration?

    Sees only: One assembly's bill of materials lines with supplier names

    Why: Splits only where the tree really branches.

    • Yes: 0.60 or higherthenSplit the work
    • Unsure: 0.40 up to 0.60thenKeep serial
    • No: below 0.40thenKeep serial
  2. Split or keep serialYes or no, with a probability

    While planning

    Does this supplier's declaration name sub-tier sources or sites that need their own check?

    Sees only: One declaration's source and site section

    Why: Goes a level deeper only where the declaration itself points there.

    • Yes: 0.60 or higherthenSplit the work
    • Unsure: 0.40 up to 0.60thenKeep serial
    • No: below 0.40thenKeep serial
  3. Scope checkYes or no, with a probability

    Before work starts on a unit

    Is this component in scope of the rule being answered, given its material and customs classification?

    Sees only: One component line with material and classification, and the rule's scope sentence

    Why: Out-of-scope parts are most of a bill of materials and need no check.

    • Yes: 0.60 or higherthenAccept
    • Unsure: 0.30 up to 0.60thenAccept
    • No: below 0.30thenSkip this unit
  4. After workers, the judge checks

    Evidence checkYes or no, with a probability

    After a worker answers

    Does the declaration list this part number, cover the shipment period and carry a signatory from the supplying entity?

    Sees only: The component line and the declaration's part list, validity dates and signature block

    Why: A declaration for a neighbouring part number proves nothing about this one.

    • Yes: 0.90 or higherthenAccept
    • Unsure: 0.50 up to 0.90thenEscalate to a strong model
    • No: below 0.50thenReject and retry
  5. Reconciler, while merging

    Conflict checkA choice among options

    While reconciling

    Do the direct supplier's declaration and the sub-tier questionnaire name the same country and site of origin for this part?

    Sees only: The two origin statements for one part number

    Why: A branch with an origin conflict must not roll up as clean.

    • Same country and sitethenAccept
    • Different country or sitethenMark unresolved
    • They cover different parts or periodsthenReject and retry
  6. Accountable person, before anything is settled

    Person decidesYes or no, with a probability

    Before anything is reported as settled

    Would this roll-up be used in a statement of origin or due diligence sent to a customer or an authority?

    Sees only: The product-level roll-up with its open gaps and conflicts

    Why: The compliance manager signs external statements.

    Accountable: The compliance manager signs any origin or due diligence statement sent to a customer or authority.

    • Yes: 0.40 or higherthenAsk a person
    • Unsure: 0.15 up to 0.40thenAsk a person
    • No: below 0.15thenAccept

The fleet: who does what

Model tiers by role, not brands: you choose the models. Strong reasoning models plan and reconcile, small fast models do the wide work, and the judge is a decision model from a different family, so it does not share the workers' blind spots.

  1. Planner

    A strong reasoning model builds the tree from product to assembly, component, supplier and site, and sets the evidence each leaf needs.

    Decisions here:1. Split or keep serial2. Split or keep serial3. Scope check

  2. Workers

    Small fast workers from an open-weight family check one component's declaration for coverage, dates, site and signatory.

    Designed for 30 to 1,000 agents, one worker task per one component and its supplier declaration. Each worker receives only its own unit.

  3. Judge, from a different model family

    A decision model from a different family checks that the declaration really covers this part number and period.

    Decisions here:4. Evidence check

  4. Reconciler

    A strong reasoning model rolls verified leaves up per assembly and product and never rolls up a branch with an open gap as clean.

    Decisions here:5. Conflict check

  5. Accountable person

    The compliance manager signs any origin or due diligence statement sent to a customer or authority.

    Decisions here:6. Person decides

Checked before anything is accepted

  • Part numbers and supplier entities in the declaration are matched to the bill of materials
  • Validity period and signatory are checked on every declaration
  • A sub-tier answer that contradicts the direct supplier's declaration is kept as a conflict
  • Each level is verified before it contributes to the level above

What comes back

  • Origin coverage per product, assembly and component with documents
  • Missing, expired or inconsistent declarations by supplier
  • Conflicts between supplier and sub-tier statements
  • Request list to send to suppliers

What to measure

  • Components with documented origin before and after the run
  • Declaration defects confirmed by the compliance team
  • Hours to answer one customer or customs request

Names of measures only. No result is claimed for this template.

Templates open in the workspace chat with the ask filled in. Nothing runs until you send it.

Get early accessSign in to use

Reconcile agreed terms across supplier contracts and amendments

For: Procurement lead or category manager preparing renewals or a supplier performance review

The price, delivery date and penalty that apply to each supplier are spread over a master agreement, amendments and emails.

Pattern: Map, verify, reduceRuns today5 decisionsDesigned for 4 to 150 agents

Check tender bids against every mandatory and scored requirement

For: Sourcing manager or chair of a tender evaluation committee running a formal RFP

Each bid runs to hundreds of pages of technical, commercial, legal and sustainability annexes.

Pattern: Specialist panelNeeds live models5 decisionsDesigned for 8 to 300 agents