Skip to main content
Challenge

Build a Bonsai IFC Gherkin Acceptance Specification Engine

Formulate automated Gherkin acceptance test scenarios for architectural IFC models using ifcbimtester principles. Validate deliverable models before client handover against contractual BIM specifications.

EngineeringHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Formulate automated Gherkin acceptance test scenarios for architectural IFC models using ifcbimtester principles. Validate deliverable models before client handover against contractual BIM specifications.

Design assurance manager

Parse design requirements into Gherkin feature files specifying mandatory IFC properties.

Execute ifcbimtester rules against incoming architectural IFC model structures.

Evaluate rule passes, warnings, and non-conformance failures across building levels.

Compile an interactive BIM quality assurance certificate detailing conformance metrics.

Web verification console showing Gherkin feature files, live run logs, and downloadable compliance certificates.

Use open-source Gherkin sample tests from the IfcOpenShell bimtester repository combined with synthetic IFC object attributes. Starter examples below are synthetic. They are not downloaded records.

IfcOpenShell Implements ifcbimtester, the Gherkin-based unit testing wrapper for IFC models listed in IfcOpenShell documentation.

anthropic-claude, behave, python-ifcopenshell. Claude accurately translates natural language contract clauses into strict Gherkin syntax without hallucinations. Hosted Claude API for natural-language-to-Gherkin scenario synthesis and validation check verification.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Converts textual contract clauses into executable Gherkin Given-When-Then test blocks.

Executes test runs identifying elements violating contractual IFC property rules.

Generates clean machine-readable test failure dossiers.

```json [ { "input": { "contract_rule": "Every external door must have an acoustic rating of at least 30dB and an explicit fire rating.", "test_target_model": [ { "guid": "DOOR-EXT-1", "type": "IfcDoor", "is_external": true, "AcousticRating": 32, "FireRating": "FD30" } ] }, "expected_output": { "gherkin_feature": "Feature: External Door Acoustic and Fire Compliance\n Scenario: Validate acoustic and fire attributes\n Given element IfcDoor is external\n Then AcousticRating must be >= 30\n And FireRating must be defined", "tested_elements": 1, "passed": 1, "failed": 0, "failures": [] } }, { "input": { "contract_rule": "All primary columns on Level 1 must declare structural material strength.", "test_target_model": [ { "guid": "COL-L1-A", "type": "IfcColumn", "level": "L1", "material_grade": null } ] }, "expected_output": { "gherkin_feature": "Feature: Column Material Strength Compliance\n Scenario: Validate column structural material\n Given element IfcColumn on level L1\n Then material_grade must be defined", "tested_elements": 1, "passed": 0, "failed": 1, "failures": [ { "guid": "COL-L1-A", "issue": "Missing material_grade attribute" } ] } } ] ```

Executes virtual validation tests on BIM files without altering construction documentation or signing off legal contracts. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Executes virtual validation tests on BIM files without altering construction documentation or signing off legal contracts. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Converts textual contract clauses into executable Gherkin Given-When-Then test blocks. Executes test runs identifying elements violating contractual IFC property rules. Generates clean machine-readable test failure dossiers.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Parse design requirements into Gherkin feature files specifying mandatory IFC properties. Execute ifcbimtester rules against incoming architectural IFC model structures. Evaluate rule passes, warnings, and non-conformance failures across building levels. Compile an interactive BIM quality assurance certificate detailing conformance metrics.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Converts textual contract clauses into executable Gherkin Given-When-Then test blocks. Executes test runs identifying elements violating contractual IFC property rules. Generates clean machine-readable test failure dossiers.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Web verification console showing Gherkin feature files, live run logs, and downloadable compliance certificates.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Executes virtual validation tests on BIM files without altering construction documentation or signing off legal contracts.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Parse design requirements into Gherkin feature files specifying mandatory IFC properties.

  • Execute ifcbimtester rules against incoming architectural IFC model structures.

  • Evaluate rule passes, warnings, and non-conformance failures across building levels.

  • Compile an interactive BIM quality assurance certificate detailing conformance metrics.

Resources and assets

Reference links and supporting material

Dataset notes

Use open-source Gherkin sample tests from the IfcOpenShell bimtester repository combined with synthetic IFC object attributes. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

Anthropic Claude

LLM for code generation & more

Evaluated output

No output checks are configured.

Evaluation checks
  • Parse design requirements into Gherkin feature files specifying mandatory IFC properties. Execute ifcbimtes...
  • Converts textual contract clauses into executable Gherkin Given-When-Then test blocks. Executes test runs i...
  • Web verification console showing Gherkin feature files, live run logs, and downloadable compliance certific...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 1 configured tool

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Anthropic Claude · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Bonsai IFC Gherkin Acceptance Specification Engine