RepairGrid

An autonomous civic infrastructure operations layer powered by AWS Bedrock and Strands Multi-Agent architecture.

๐Ÿ’ก Inspiration

Across cities, university campuses, and residential neighborhoods, public infrastructure maintenance is fundamentally broken.

When a streetlight goes dark, a storm drain clogs, or an asphalt cavity turns into a hazardous pothole, citizens are often forced to navigate clunky municipal portals or call 311 hotlinesโ€”where complaints can disappear into bureaucratic black holes.

Meanwhile:

  • Field maintenance crews operate on disconnected paper manifests.
  • Municipal dispatchers are overwhelmed by duplicate reports.
  • There is little real-time situational awareness.
  • Citizens have limited visibility into what happens after submitting a complaint.

We asked ourselves:

What if civic infrastructure operated like an intelligent, self-healing grid?

Inspired by the Good Neighbor Agents vision, we built RepairGridโ€”an autonomous operations layer powered by AWS Bedrock and the Strands Multi-Agent Framework.

RepairGrid connects residents, field technicians, and city supervisors in real time, transforming passive complaints into swift, verified physical repairs without chatbot friction or endless municipal delays.


๐Ÿš€ What It Does

RepairGrid coordinates civic maintenance through three integrated portals, powered by an autonomous and deterministic Strands Agent graph.

1. ๐Ÿ  Resident Hub

Routes: /resident ยท /report

Frictionless 3-Step Reporting

Citizens can:

  • ๐Ÿ“ธ Capture photos of infrastructure problems.
  • ๐ŸŽ™๏ธ Use hands-free voice-to-text reporting.
  • ๐Ÿ“ Pin precise GPS coordinates.

Radical Transparency

A real-time 5-stage lifecycle stepper keeps residents informed:

Submitted โ†’ Triaged โ†’ Dispatched โ†’ Repaired โ†’ Verified

Agent telemetry is streamed directly to the citizen interface.

Citizen Quality Confirmation

Route: /resident/verify/[id]

Residents can compare Before & After repair photos and confirm the fix with a single tap.


2. ๐Ÿ› ๏ธ Field Technician Portal

Route: /worker

Trade-Specialized Dispatch

A mobile-first dashboard designed for:

  • โšก Electricians
  • ๐Ÿ›ฃ๏ธ Road crews
  • ๐Ÿ’ง Drainage specialists

Optimized Route Navigation

Technicians receive:

  • Automated travel routing
  • Proximity-based mapping
  • Assigned work orders

Autonomous Lifecycle Execution

Technicians can progress through work orders with one tap:

Accept โ†’ En Route โ†’ On Site โ†’ Start Repair

Proof-of-Repair Submission

Field crews submit:

  • ๐Ÿ“ธ Completion photos
  • ๐Ÿ“ Attestation notes
  • โœ… Repair completion status

directly from the field.


3. ๐Ÿข Supervisor Mission Control

Route: /operations

Dynamic Community Health Index

A real-time mathematical score measuring infrastructure health across:

  • ๐Ÿ’ก Lighting
  • ๐Ÿ›ฃ๏ธ Roads
  • ๐Ÿ’ง Drainage

Living GIS Map

Provides real-time geospatial visibility into:

  • Infrastructure incidents
  • Risk levels
  • Technician positions

Human-in-the-Loop Decision Inbox

High-risk hazards and policy exceptions automatically pause the agent workflow and require human operator approval.

Multimodal AI Verification Queue

Amazon Bedrock / Nova vision models automatically analyze repair evidence by comparing pre- and post-repair imagery.

Trust & Governance Center

Provides:

  • SHA-256 evidence integrity
  • Immutable audit logging
  • Transparent action history

๐Ÿงฎ Mathematical Model

Community Health Score

RepairGrid evaluates community infrastructure health using a deterministic formula:

$$

\text{Community Health}

\max\left(10,\min\left(100,100-P+B\right)\right) $$

Where:

Hazard Penalty

$$ P = (4 \cdot N_{\text{critical}}) + (1 \cdot N_{\text{active}}) $$

Resolution Bonus

$$ B = \min(2 \cdot N_{\text{resolved}},10) $$

Each infrastructure categoryโ€”lighting, roadways, and drainageโ€”is independently evaluated:

$$

H_{\text{category}}

\max\left(20,100-(5\cdot N_{\text{open_issues}})\right) $$

This ensures that the Community Health Score reflects objective physical infrastructure conditions rather than subjective estimations.


๐Ÿ› ๏ธ How We Built It

RepairGrid was architected as a distributed, multi-role web platform.

System Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Resident Portal    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Field Worker Portal  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Mission Control    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ”‚
           โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚      Next.js 14 App        โ”‚
โ”‚     REST API + Auth        โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
             โ”‚
             โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚     FastAPI Backend Core   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
             โ”‚
       โ”Œโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”
       โ–ผ           โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Strands   โ”‚ โ”‚   AWS Bedrock      โ”‚
โ”‚ Agent Graphโ”‚ โ”‚                    โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ Intake     โ”‚ โ”‚ Amazon Nova        โ”‚
โ”‚ Enrichment โ”‚ โ”‚ Multimodal Vision  โ”‚
โ”‚ Dedup      โ”‚ โ”‚                    โ”‚
โ”‚ Risk       โ”‚ โ”‚ Claude 3.5 Sonnet  โ”‚
โ”‚ Ownership  โ”‚ โ”‚ Reasoning          โ”‚
โ”‚ Dispatch   โ”‚ โ”‚                    โ”‚
โ”‚ Matching   โ”‚ โ”‚ Proof Analysis     โ”‚
โ”‚ Guardian   โ”‚ โ”‚ Embeddings         โ”‚
โ”‚ Verificationโ”‚ โ”‚ Triage             โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿค– Autonomous Agent Layer

The system is orchestrated using the Strands Multi-Agent Graph SDK.

The pipeline contains 10 specialized deterministic agent nodes:

  1. Intake
  2. Location Enrichment
  3. Spatial Deduplication
  4. Physical Verification
  5. Risk Assessment
  6. Department Ownership
  7. Mission Dispatch
  8. Resource Matching
  9. Guardian Policy Evaluation
  10. Completion Verification

This architecture allows RepairGrid to combine autonomous AI reasoning with deterministic execution and safety controls.


๐Ÿง  AI & Vision Backbone

Powered by AWS Bedrock, including:

  • Amazon Nova for multimodal vision.
  • Claude 3.5 Sonnet for reasoning.
  • Automated proof-of-repair analysis.
  • Embeddings and intelligent triage.

Nova analyzes:

  • Resident complaint imagery
  • Technician completion photos
  • Surface defects
  • Debris clearance
  • Bounding-box evidence
  • Physical repair cues

๐Ÿ’ป Frontend & UX

Built using:

  • Next.js 14 โ€” App Router
  • TypeScript
  • Tailwind CSS
  • Responsive mobile layouts
  • Dark-mode glassmorphism
  • Interactive SVG lifecycle steppers
  • Browser voice recognition APIs

โš™๏ธ Backend & Safety Engine

Built with FastAPI and Python, providing:

  • Role-based mock authentication
  • Geospatial distance clustering
  • Haversine-based deduplication
  • 30-meter duplicate detection radius
  • Deterministic Guardian Policy enforcement

โšก Challenges We Faced

1. Preventing Infinite Loops & Hallucinations

Large language models operating in autonomous loops can hallucinate tool parameters or repeatedly trigger actions.

Our Solution

We structured the Strands architecture as a:

  • Directed deterministic graph
  • Strictly typed schema system
  • Guardrail-controlled execution pipeline

This limits uncontrolled agent behavior.


2. Safety Gating for Consequential Actions

An autonomous agent should never have unilateral authority to:

  • Dispatch expensive heavy equipment.
  • Close high-voltage electrical cases.
  • Approve high-risk infrastructure repairs.

Our Solution

We built a Human-in-the-Loop (HITL) Decision Inbox.

When an action exceeds predefined risk thresholds:

Agent Decision
      โ”‚
      โ–ผ
Risk Threshold Check
      โ”‚
 โ”Œโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”
 โ”‚         โ”‚
Low Risk  High Risk
 โ”‚         โ”‚
 โ–ผ         โ–ผ
Execute   HITL Review
            โ”‚
            โ–ผ
     Human Authorization
            โ”‚
            โ–ผ
          Execute

The Strands graph pauses execution until the required authorization is provided.


3. Computer Vision Under Variable Lighting

Comparing a broken streetlight photographed at night with a daytime repair photo creates a difficult visual verification problem.

Our Solution

We designed multimodal prompts for Amazon Bedrock that focus on structural physical evidence, including:

  • Fixtures
  • Wires
  • Pole numbers
  • Physical placement
  • Infrastructure geometry

rather than relying purely on ambient lighting or image appearance.


๐Ÿ† Accomplishments

End-to-End Working System

Built three fully synchronized, role-based portals:

  • Resident
  • Technician
  • Mission Control

All communicate through the same autonomous infrastructure workflow.

โšก Sub-Second Agent Execution

The Strands pipeline evaluates incoming civic reports, performs deduplication, and dispatches work in under 1.5 seconds.

๐Ÿ“ˆ 97%+ Autonomous Action Rate

Routine civic repairs are processed autonomously, while 100% of high-risk scenarios are gated to human operators.

๐Ÿ“ธ Citizen Verification

Created a complete accountability loop where residents can directly verify physical repairs using Before & After evidence.


๐Ÿ“š What We Learned

Trust Is Essential for Good Neighbor Agents

Autonomous AI in municipal governance must be transparent.

Exposing:

  • Agent telemetry
  • Lifecycle progress
  • Repair evidence
  • Verification status

can create substantially more trust than hiding the process behind a generic chatbot.

Determinism Beats Unrestricted Autonomy for Physical Safety

The most reliable architecture combines:

Deterministic Rules

  • Guardian safety checks
  • Risk thresholds
  • Distance calculations
  • Policy enforcement

with:

Generative AI

  • Vision inspection
  • Voice transcription
  • Reasoning
  • Evidence analysis

This provides a balance between autonomy, speed, reliability, and safety.


๐Ÿ”ฎ What's Next

๐Ÿš Autonomous Drone Inspection

Integrate automated drone flyovers to inspect:

  • Roof gutters
  • Bridge crevices
  • Storm drainage
  • Hard-to-reach infrastructure

before dispatching field crews.

๐Ÿ“Š Predictive Infrastructure Health

Train predictive time-series models using historical repair data to identify infrastructure likely to fail.

The goal:

Repair infrastructure before it breaks.

Potential applications include:

  • Water pipes
  • Transformers
  • Drainage systems
  • Road surfaces

๐Ÿ›๏ธ Municipal ERP Integration

Enable bi-directional synchronization with existing municipal work-order platforms, including:

  • Cityworks
  • SAP Plant Maintenance
  • Tyler Technologies

This would allow RepairGrid to operate as an intelligent autonomous layer on top of existing municipal infrastructure systems.

Built With

  • agents
  • amazon-nova
  • artificial-intelligence
  • autonomous-agents
  • aws-bedrock
  • civic-tech
  • computer-vision
  • fastapi
  • gis-mapping
  • human-in-the-loop
  • multi-agent-systems
  • multimodal-ai
  • nextjs
  • python
  • react
  • rest-api
  • safety-guardrails
  • smart-cities
  • speech-to-text
  • strands-agents
  • tailwind-css
  • typescript
Share this project:

Updates

Submission history