Building Reviewer

Regulatory Reasoning (RAG) & Guardrails

• Contextual Retrieval: Employs Vertex AI RAG Engine to retrieve relevant sections from the California Building Standards Code (Title 24) and San Paloma County local reach codes via a FunctionTool to ensure compatibility with multimodal interactions.
• Compliance Mapping: Matches extracted plan data against retrieved regulatory text to identify specific violations or approved elements.
• Actionable Feedback: Generates structured reports that include exact code sections, detailed descriptions of non-compliance, and specific suggestions for remediation.
• Model Armor (Safety & Liability): Protects conversational interfaces from prompt injection, toxicity, and enforces custom PII filtering (e.g., blocking "LEGAL_LIABILITY_PHRASES") to ensure the agent does not assume legal liability or certify engineering advice.

Shared Infrastructure & Persistent Context

• Vertex AI Session Management: Centralized session service for persistent, scalable conversation history across all agents in the ecosystem.
• Vertex AI Memorybank: Long-term memory service allowing agents to retrieve and reference past interactions, violations, and decisions (facilitated by the agent-engine).
• Agentic Memory (ADK): Utilizes Google ADK (Agent Development Kit) to maintain conversational state and long-term memory across sessions.

Agent Interoperability (A2A)

• Protocol Compliance: Adheres to the Agent-to-Agent (A2A) Protocol Specification for seamless communication between different AI agents.
• Agent Discovery: Exposes standardized "Agent cards" (.well-known/agent-card.json) that describe agent capabilities, security requirements, and endpoints.
• Inter-Agent Coordination: Uses a2a-sdk to enable agents (e.g., Compliance Agent and Contractor Agent) to discover and interact with each other to find licensed contractors and propose structural remediation.

2. Technical Stack & Infrastructure Skills

Assessor MCP Server (Data Retrieval)

• MCP Protocol: Implements the Model Context Protocol (MCP) to expose property data as structured tools via a Streamable HTTP connection on port 8002.
• Tool Integration: Provides lookup_parcel, get_zoning_classification, and get_setback_requirements tools to fetch fake San Paloma County property and zoning data.
• Data Management: Capabilities to add_parcel, rezone_address, and add_zoning_rule to the county's assessor SQLite database.

Microservices Architecture

• Polyglot Development: Seamless integration between a Go-based API Gateway, a Python-based AI Agent, and a React-based Frontend.
• Orchestration: The Go backend manages business logic, user state (SQLite/GORM), and acts as a secure proxy to the AI analysis engine.

Cloud Native Integrations

• Google Cloud Platform (GCP): Deep integration with Vertex AI, Document AI, BigQuery, and Cloud Trace.
• Observability: Built-in distributed tracing using OpenTelemetry (Go & Python) for monitoring analysis latency, and the BigQuery Agent Analytics plugin (google.adk.plugins.bigquery_agent_analytics_plugin) for tracking agent performance and user interactions over time.
• Scalability: Containerized workloads (Dockerfiles included) ready for deployment to Cloud Run or GKE.

3. Domain Knowledge: Building Compliance

Regulatory Frameworks

• CA Title 24 (California Building Standards Code): Expertise in Parts 6 (Energy) and 11 (CalGreen).
• Local Reach Codes: Specialized knowledge of San Paloma County requirements, including All-Electric building mandates and EV charging infrastructure.

Architectural Standards

• Plan Interpretation: Understanding of standard architectural scales, legends, and sheet types (Site Plans, Floor Plans, MEP).

4. Developer & Operational Skills

Automated Workflows

• Standardized Tooling: Comprehensive Makefile for unified management across services (start, build, test, install, stop).
• Package Management: Uses modern dependency managers: uv for Python, npm for Frontend, and go mod for the API.
• CI/CD Ready: Includes GitHub Actions for CodeQL security scanning and automated CI.

5. Usage Skills (What you can do)

1. Automated Triage: Upload a PDF and get an "Approved/Rejected" status in seconds.
2. Issue Tracking: View a list of specific violations mapped to the legal code.
3. History Management: Maintain a database of property permits and multiple submission versions.
4. Interactive Clarification: Ask follow-up questions about specific violations via an integrated chat interface powered by conversational AI.
5. Local Development: Spin up the entire stack locally for testing and customization using make all.