name: crossbeam-ops
version: "1.0"
description: "Operations manual for the CrossBeam ADU Permit Assistant. Teaches AI agents how to operate the deployed system — trigger flows, check status, read results, navigate the UI, and query the database."
CrossBeam Operations Manual
This skill teaches you how to operate the CrossBeam system programmatically and via browser.
Decision Tree Router
| What you want to do |
Load these references |
| Trigger a flow, check results, or reset via API |
references/api-endpoints.md |
| Query the database directly (Supabase MCP or SQL) |
references/data-model.md |
| Understand what each flow does and its phases |
references/flows.md |
| Navigate the UI via Chrome browser |
references/ui-navigation.md |
| Work with demo/test projects |
references/demo-projects.md |
Quick Reference
Fastest Path: Run a Full Test
# 1. Reset the demo project
curl -X POST https://cc-crossbeam.vercel.app/api/reset-project \
-H "Authorization: Bearer $CROSSBEAM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project_id":"b0000000-0000-0000-0000-000000000002"}'
# 2. Trigger corrections analysis
curl -X POST https://cc-crossbeam.vercel.app/api/generate \
-H "Authorization: Bearer $CROSSBEAM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"project_id":"b0000000-0000-0000-0000-000000000002","flow_type":"corrections-analysis"}'
# 3. Poll until done (check project.status)
curl -s https://cc-crossbeam.vercel.app/api/projects/b0000000-0000-0000-0000-000000000002 \
-H "Authorization: Bearer $CROSSBEAM_API_KEY" | jq '.project.status'
By