Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -99,3 +99,8 @@ logs/
# Participants' own reports and local notes never ship.
atlan-readiness-report.md
.dev/

# The builder's yard is built locally; eval answers and agent files from a run never ship.
yard/fixit.duckdb
.atlan-analytics/
.claude/agents/
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,12 @@ of questions. Apart from the use case, each one is a choice you click rather tha
to type. It asks before it runs anything against your warehouse, and it asks again before it
sends the report.

## Practise first

No warehouse connected yet? The [builder's yard](yard/) is a small made-up firm with five tables
and a Power BI dashboard, for trying the week-one steps on your laptop. Paste:
`Set up the builder's yard and show me its dashboard`.

## What the agent does

| Step | What happens |
Expand Down Expand Up @@ -102,6 +108,8 @@ skills/accelerator-readiness/
references/bi-tools.md what to look for and the two questions
references/report.md the report template and where it goes
references/builder.md the Builder: start frame, quips, site pass and inspection
skills/builders-yard/SKILL.md set up the practice yard and show its dashboard
yard/ the builder's yard: data, dashboard, query history
```

## Contact us
Expand Down
22 changes: 22 additions & 0 deletions skills/builders-yard/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
name: builders-yard
description: Sets up the accelerator's practice estate, the builder's yard (Fixit & Co., a small made-up building firm), on the participant's laptop - builds its DuckDB from CSV, shows the Power BI dashboard it starts from, and answers questions on it read-only. Use when the user asks to set up or try the builder's yard, the practice data, Fixit, or wants to try the accelerator steps before using their own data.
compatibility: Any coding agent with a shell and Python 3.10+. Needs the duckdb Python package (uv run --with duckdb, or pip install duckdb after a yes).
---

# The builder's yard

Everything lives in `yard/` (read `yard/README.md` first). Nothing leaves the laptop.

1. **Build the yard.** If `yard/fixit.duckdb` is missing, run `python yard/load.py`. If `duckdb`
is not importable, ask once, then use `uv run --with duckdb python yard/load.py` (or
`pip install duckdb`). Show the row counts.
2. **Show the dashboard.** Read the measures in `yard/powerbi/model.bim`. List the four tiles,
each with its measure and value, computed with `python yard/q.py` from the measure's
definition and the table's SQL in `yard/powerbi/rowsets.json`. One line per tile.
3. **Hand over to the build.** In one line, say the next step: convert the Power BI report
`yard/powerbi/hard-hat-area-site-performance.pbit` to an agent with the Atlan analytics plugin, as `yard/README.md` shows.
4. **Questions.** Answer questions about the yard with `python yard/q.py` only (read-only). State
the definition you used in one line under each answer.

Rules: read-only SQL; keep each reply to a status line and one next action.
63 changes: 63 additions & 0 deletions yard/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# The builder's yard

A small, made-up building firm to practise on before you build on your own data. You take the
same steps as week one: start from a dashboard, generate metrics and evals, run your agent, and
see the score.

## The firm

Fixit & Co. has ten jobs from July to October 2026: a pergola, a barn, a skate park, a cat flap,
and one very expensive wind turbine base. Rob runs the yard, Wanda does the building, and Sprout
"helps". The machines are crew too, and they bill by the hour: Dig digs, Tipper hauls, Whirl
mixes, Flatt rolls and Lanky lifts. Kipper the cat isn't crew, but turns up in the snag log more
than anyone would like.

## Set up (2 minutes)

In your coding agent, from the repository root:

```text
Set up the builder's yard and show me its dashboard
```

Or by hand:

```bash
pip install duckdb # or prefix each command with: uv run --with duckdb
python yard/load.py
python yard/q.py "SELECT crew_name, catchphrase FROM fixit.site.crew"
```

## Build an agent on it

The dashboard is a Power BI report saved as a file, `yard/powerbi/hard-hat-area-site-performance.pbit`, so no
Power BI account is needed. With the Atlan analytics plugin installed:

```text
Convert this Power BI report to an agent: yard/powerbi/hard-hat-area-site-performance.pbit
The warehouse is yard/fixit.duckdb (run SQL with python yard/q.py),
and the query history is yard/history/querylog.jsonl.
```

The plugin turns the dashboard's four tiles into metrics, writes eval questions, registers your
agent and runs a baseline.

## The question to finish on

**Which job ate our margin last quarter, and what ate it?**

## What's in the yard

| Table | Rows | One row is |
|---|---|---|
| `site.projects` | 10 | a job |
| `site.crew` | 8 | a person or a machine |
| `site.work_logs` | 746 | one crew member, one job, one day, one task |
| `site.material_orders` | 51 | an order |
| `site.site_snags` | 11 | something that went wrong |

The dashboard, *Hard Hat Area: Site Performance*, has four tiles: gross margin, rework cost,
material waste and late jobs. It ships as a Power BI template,
`powerbi/hard-hat-area-site-performance.pbit` (report page and model, no data). `powerbi/model.bim` is the same
model as readable JSON, and `powerbi/rowsets.json` holds the SQL each table is built from. The 110 queries in
`history/querylog.jsonl` are what the yard's analysts ran.
9 changes: 9 additions & 0 deletions yard/data/crew.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
crew_id,crew_name,crew_type,role,hourly_rate_gbp,catchphrase
C01,Rob,human,foreman,45.00,"Measure twice, pour once."
C02,Wanda,human,builder,42.00,Already on it.
C03,Sprout,human,self-appointed apprentice,18.00,I'm helping!
C04,Dig,machine,digger,60.00,Dig deep.
C05,Tipper,machine,dumper,40.00,"If it's heavy, I'll tip it."
C06,Whirl,machine,cement mixer,25.00,Round and round!
C07,Flatt,machine,steamroller,35.00,Flat out.
C08,Lanky,machine,crane,85.00,"Er, how high?"
52 changes: 52 additions & 0 deletions yard/data/material_orders.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
order_id,project_id,material,unit,quantity,unit_cost_gbp,supplier,order_date,order_status,wasted_quantity
M001,P01,timber,m3,3.00,520.00,Hammerton Builders' Merchant,2026-07-14,delivered,0.10
M002,P01,timber,m3,2.00,520.00,Hammerton Builders' Merchant,2026-07-11,delivered,0.10
M003,P01,paint,tin,3.00,28.00,Hammerton Builders' Merchant,2026-07-10,delivered,0.20
M004,P01,paint,tin,2.00,28.00,Hammerton Builders' Merchant,2026-07-13,delivered,0.10
M005,P01,paint,tin,3.00,28.00,Hammerton Builders' Merchant,2026-07-11,delivered,0.20
M006,P01,nails,box,2.00,9.00,Hammerton Builders' Merchant,2026-07-06,delivered,0.20
M007,P01,nails,box,2.00,9.00,Hammerton Builders' Merchant,2026-07-15,delivered,0.20
M008,P01,nails,box,2.00,9.00,Hammerton Builders' Merchant,2026-07-08,delivered,0.20
M009,P02,bricks,pallet,8.00,380.00,Hammerton Builders' Merchant,2026-07-22,delivered,0.30
M010,P02,bricks,pallet,14.00,380.00,Hammerton Builders' Merchant,2026-07-07,cancelled,0.00
M011,P02,bricks,pallet,10.00,380.00,Hammerton Builders' Merchant,2026-07-05,delivered,0.20
M012,P02,cement,tonne,16.00,140.00,Buttercup Vale Quarry,2026-07-24,delivered,1.10
M013,P02,cement,tonne,12.00,140.00,Buttercup Vale Quarry,2026-07-18,delivered,0.80
M014,P02,cement,tonne,12.00,140.00,Buttercup Vale Quarry,2026-07-11,delivered,0.70
M015,P02,timber,m3,13.00,520.00,Hammerton Builders' Merchant,2026-07-22,delivered,0.60
M016,P02,timber,m3,14.00,520.00,Hammerton Builders' Merchant,2026-07-23,delivered,0.60
M017,P02,nails,box,9.00,9.00,Hammerton Builders' Merchant,2026-07-10,delivered,1.20
M018,P02,nails,box,10.00,9.00,Hammerton Builders' Merchant,2026-07-10,delivered,1.20
M019,P03,cement,tonne,16.00,140.00,Buttercup Vale Quarry,2026-08-04,delivered,6.00
M020,P03,cement,tonne,24.00,140.00,Buttercup Vale Quarry,2026-07-31,delivered,7.70
M021,P03,cement,tonne,18.00,140.00,Buttercup Vale Quarry,2026-08-07,delivered,6.90
M022,P03,steel rebar,tonne,16.00,900.00,Buttercup Vale Quarry,2026-07-31,delivered,0.20
M023,P03,steel rebar,tonne,28.00,900.00,Buttercup Vale Quarry,2026-07-29,delivered,0.40
M024,P03,bricks,pallet,29.00,380.00,Hammerton Builders' Merchant,2026-07-30,delivered,1.00
M025,P03,bricks,pallet,22.00,380.00,Hammerton Builders' Merchant,2026-07-28,cancelled,0.00
M026,P04,timber,m3,2.00,520.00,Hammerton Builders' Merchant,2026-08-03,delivered,0.10
M027,P04,timber,m3,2.00,520.00,Hammerton Builders' Merchant,2026-08-05,cancelled,0.00
M028,P04,paint,tin,2.00,28.00,Hammerton Builders' Merchant,2026-08-10,delivered,0.10
M029,P04,paint,tin,3.00,28.00,Hammerton Builders' Merchant,2026-08-08,delivered,0.20
M030,P04,nails,box,2.00,9.00,Hammerton Builders' Merchant,2026-08-06,delivered,0.20
M031,P05,cement,tonne,45.00,140.00,Buttercup Vale Quarry,2026-08-15,delivered,3.40
M032,P05,steel rebar,tonne,48.00,900.00,Buttercup Vale Quarry,2026-08-22,delivered,0.70
M033,P05,paint,tin,44.00,28.00,Hammerton Builders' Merchant,2026-08-10,delivered,3.80
M034,P05,paint,tin,46.00,28.00,Hammerton Builders' Merchant,2026-08-20,delivered,5.10
M035,P06,bricks,pallet,11.00,380.00,Hammerton Builders' Merchant,2026-09-05,delivered,0.30
M036,P06,bricks,pallet,6.00,380.00,Hammerton Builders' Merchant,2026-09-04,delivered,0.20
M037,P06,bricks,pallet,9.00,380.00,Hammerton Builders' Merchant,2026-09-23,delivered,0.30
M038,P06,timber,m3,9.00,520.00,Hammerton Builders' Merchant,2026-09-07,delivered,0.50
M039,P06,timber,m3,11.00,520.00,Hammerton Builders' Merchant,2026-09-14,delivered,0.30
M040,P08,timber,m3,8.00,520.00,Hammerton Builders' Merchant,2026-09-25,delivered,0.40
M041,P08,paint,tin,9.00,28.00,Hammerton Builders' Merchant,2026-09-28,delivered,0.60
M042,P08,nails,box,10.00,9.00,Hammerton Builders' Merchant,2026-10-14,delivered,0.80
M043,P08,nails,box,10.00,9.00,Hammerton Builders' Merchant,2026-09-28,cancelled,0.00
M044,P09,timber,m3,3.00,520.00,Hammerton Builders' Merchant,2026-10-03,delivered,0.10
M045,P09,steel rebar,tonne,3.00,900.00,Buttercup Vale Quarry,2026-10-05,delivered,0.00
M046,P09,steel rebar,tonne,4.00,900.00,Buttercup Vale Quarry,2026-10-08,delivered,0.10
M047,P09,nails,box,3.00,9.00,Hammerton Builders' Merchant,2026-10-08,delivered,0.40
M048,P09,nails,box,4.00,9.00,Hammerton Builders' Merchant,2026-10-04,delivered,0.40
M049,P10,timber,m3,1.00,520.00,Hammerton Builders' Merchant,2026-10-21,cancelled,0.00
M050,P10,nails,box,1.00,9.00,Hammerton Builders' Merchant,2026-10-20,delivered,0.10
M051,P03,cement,tonne,40.00,140.00,Buttercup Vale Quarry,2026-09-17,cancelled,0.00
11 changes: 11 additions & 0 deletions yard/data/projects.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
project_id,project_name,client_name,site_town,project_type,contract_value_gbp,start_date,planned_end_date,actual_end_date,status
P01,Mrs Kettle's Pergola,Mrs Kettle,Hammerton,residential,9800.00,2026-07-06,2026-07-24,2026-07-22,complete
P02,Farmer Marrow's Barn Extension,Farmer Marrow,Buttercup Vale,farm,72000.00,2026-07-01,2026-08-28,2026-08-27,complete
P03,Buttercup Vale Wind Turbine Base,Buttercup Vale Council,Buttercup Vale,civic,150000.00,2026-07-13,2026-09-25,2026-10-23,complete
P04,Sprout's Scarecrow Workshop,Sprout,Buttercup Vale,farm,10500.00,2026-08-03,2026-08-21,2026-09-04,complete
P05,Hammerton Skate Park,Hammerton Town Council,Hammerton,civic,96000.00,2026-08-10,2026-09-30,2026-09-29,complete
P06,Town Hall Clock Tower Repair,Hammerton Town Council,Hammerton,civic,54000.00,2026-09-01,2026-10-16,,on_hold
P07,Jojo's Yard Fence,Jojo,Hammerton,commercial,3200.00,2026-09-14,2026-09-25,,cancelled
P08,Mr Bramley's Office Refit,Mr Bramley,Hammerton,commercial,61000.00,2026-09-21,2026-11-20,,in_progress
P09,Buttercup Vale Bus Shelter,Buttercup Vale Council,Buttercup Vale,civic,21000.00,2026-10-01,2026-10-16,2026-10-15,complete
P10,Kipper's Cat Flap,Rob (personal job),Hammerton,residential,150.00,2026-10-20,2026-10-21,2026-10-27,complete
12 changes: 12 additions & 0 deletions yard/data/site_snags.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
snag_id,project_id,reported_date,caused_by,description,severity
S01,P03,2026-08-12,KIPPER,Kipper sat in the wet turbine-base concrete. Paw prints set overnight.,high
S02,P03,2026-08-27,C06,Whirl over-mixed batch 14. It came out as soup.,medium
S03,P03,2026-09-16,KIPPER,Kipper sat in the wet concrete again. Same spot. Same paws.,high
S04,P03,2026-09-30,C08,Lanky lowered the turbine base mould two feet left of the pegs.,high
S05,P04,2026-08-18,C03,Sprout built the scarecrow a door. On the roof.,medium
S06,P04,2026-08-25,C03,Sprout 'improved' the paint colour to turnip.,low
S07,P02,2026-08-04,WEATHER,Rain washed out the barn footings.,medium
S08,P05,2026-09-08,C07,Flatt rolled the half-pipe flat. It is now a quarter-pipe.,low
S09,P10,2026-10-21,C01,Cat flap fitted upside down. Kipper unimpressed.,low
S10,P09,2026-10-07,WEATHER,Wind blew the shelter roof panels into the duck pond.,low
S11,P08,2026-10-14,C05,Tipper delivered the office carpet to the farm.,low
Loading