The Site Book Site Ready

Site Ready is a Slack agent for construction teams that checks CDM documents, worker sign-offs and site risks to answer: can this building site start tomorrow?

Comment

Inspiration

Construction teams do not usually fail because nobody cared about compliance. They fail because the answer lives across folders, sign-off links, RAMS PDFs, access records and the Slack channel where the foreman mentioned a late change. The question before a job starts is simple: can this site start work tomorrow?

Site Ready brings that question into Slack. A manager can ask @Site Ready can we start at Orchard House tomorrow? and get an evidence-led readiness digest instead of chasing documents manually.

What it does

Site Ready connects Slack to The Site Book, our CDM compliance platform for UK construction. The agent finds the relevant project, checks Site Book records, searches recent Slack context with Real-Time Search, classifies site-specific risks, and returns a green/amber/red readiness view with blockers, warnings, source links and next actions.

It can:

  • resolve a construction project from a Slack prompt;
  • check RAMS, CPP, site induction, emergency plan, sign-off, Site Access and credential readiness;
  • use Slack Real-Time Search to surface recent channel context;
  • classify Slack context into structured findings without storing raw Slack messages;
  • create sign-off reminder links and audit-pack/share links;
  • record manager decisions back to the audit trail.

The agent never claims a site is legally safe. It reports readiness based on available records and routes safety-critical changes to human review.

How we built it

We built a separate Node 22 TypeScript Slack app using Bolt for JavaScript in HTTP mode, connected to the existing Site Book app through internal APIs protected by a shared service token. The Site Book side reuses existing readiness logic, account scoping, encrypted integration tokens and plan gates for Business and Site Control accounts.

Slack provides the agent surface, app mentions, buttons, modals, OAuth and Real-Time Search. MCP tools expose Site Book actions such as finding projects, checking readiness, extracting Slack risk findings, creating audit links and recording decisions. AI classification runs through The Site Book's existing JSON provider wrapper so output stays structured and raw Slack message bodies are not stored.

Challenges

The hardest part was making the demo useful without overselling safety. Construction compliance is high-stakes, so the agent has to be decisive about records while staying clear that a competent human owns the final call. We also had to separate staging and live Slack apps, wire OAuth and app credentials safely across DigitalOcean, keep the feature limited to the right paid plans, and make Slack context useful without retaining raw messages.

What we learned

Slack agents are strongest when they do more than chat. The winning pattern is Slack as the place where work starts, MCP tools as the action layer, product records as the source of truth, and AI as a classifier that turns messy context into reviewable evidence.

What's next

Next we would add richer private-channel controls, scheduled morning readiness digests, deeper Site Access workflows, and Marketplace-ready onboarding for construction firms that already use Slack to run site operations.

Built With

  • ai-json-classification
  • bolt-for-javascript
  • clerk
  • digitalocean-app-platform
  • next.js
  • node.js-22
  • postgresql
  • prisma
  • slack-agent-builder
  • slack-mcp
  • slack-real-time-search-api
  • typescript
Share this project:

Updates