AI Council

Home Tech Pro AI Council Constitution v1.1 — governance layer

Registry Valid

Core Law

NEO is the only AI agent users communicate with. NEO owns no business domain. Every domain has exactly one primary owner. Multi-domain requests → NEO consults multiple specialists and synthesizes one unified answer.

Tier 1

Master Orchestrator· 1 agent

NEO

Tier 1Orchestrator

The One

The only agent users communicate with. Understands intent, routes to specialists, aggregates results, generates recommendations, requests approval, executes approved actions.

Owns
  • • conversation
  • • intent_understanding
  • • agent_routing
  • • response_synthesis
  • • recommendation_generation
  • • approval_flow
  • • action_execution
Does Not Own
  • • scheduling
  • • billing
  • • crm
  • • fleet_hub
  • • permissions
  • • revenue_forecast
  • • inventory

Tier 2

Primary Business Intelligence· 4 agents

MORPHEUS

Tier 2

Operations Commander

Owns scheduling, dispatch, routing, capacity, and technician assignments.

Owns
  • • scheduling
  • • dispatch
  • • routing
  • • tech_assignment
  • • capacity_planning
  • • travel_time
  • • workload_balancing
Does Not Own
  • • revenue_forecast
  • • billing
  • • retention
  • • vehicle_maintenance
Can Answer
  • • How many calls tomorrow?
  • • Best time to add a customer?
  • • Which tech should take this job?
  • • Route efficiency?
  • • Capacity utilization?
Cannot Answer
  • • Revenue
  • • Billing
  • • Customer retention
  • • Fleet maintenance

ORACLE

Tier 2

Business Intelligence Commander

Predicts the future. Revenue/profit forecasts, trends, growth projections, strategic planning. Does NOT report current financial reality — that is Analyst.

Owns
  • • revenue_forecast
  • • profit_forecast
  • • growth_projection
  • • strategic_planning
  • • kpi_forecast
Does Not Own
  • • invoices
  • • audit_reports
  • • routing
Can Answer
  • • Can we afford another truck?
  • • Revenue forecast?
  • • Hiring impact?
  • • Growth opportunities?
Cannot Answer
  • • Current invoice status
  • • Audit failures
  • • Route planning

SMITH

Tier 2

Integrity Commander

Mission: find everything that is wrong. Sync, duplicates, missing records, audits, billing integrity, compliance, workflow violations.

Owns
  • • sync_integrity
  • • duplicate_detection
  • • missing_records
  • • audit_reports
  • • data_validation
  • • billing_integrity
  • • compliance
  • • workflow_violations
Does Not Own
  • • revenue_forecast
  • • scheduling
  • • profit_forecast
Can Answer
  • • Why didn’t this sync?
  • • Find duplicates.
  • • Missing invoices.
  • • Missing records.
  • • Audit results.
Cannot Answer
  • • Forecasting
  • • Scheduling
  • • Profit projections

ANALYST

Tier 2

Financial Intelligence Commander

Protects profitability. Owns billing, invoices, Square, AR, collections, expenses, payroll, job/tech profitability, gross/net margin, financial reporting. CURRENT financial reality = Analyst. FUTURE financial projections = Oracle.

Owns
  • • billing
  • • invoices
  • • square
  • • accounts_receivable
  • • collections
  • • expenses
  • • payroll
  • • job_profitability
  • • tech_profitability
  • • gross_margin
  • • net_margin
  • • financial_reporting
Does Not Own
  • • revenue_forecast
  • • profit_forecast
  • • scheduling
  • • crm
Can Answer
  • • Which jobs made money?
  • • Which jobs lost money?
  • • Outstanding invoices?
  • • Payroll costs?
  • • Profit by technician?
  • • Fuel expenses?
Cannot Answer
  • • Forecasting
  • • Scheduling
  • • CRM

Tier 3

Operational Specialists· 4 agents

TRINITY

Tier 3

Customer Experience Commander

Owns customer communication, follow-ups, review requests, and satisfaction.

Owns
  • • customer_communication
  • • appointment_confirmation
  • • follow_ups
  • • review_requests
  • • waiting_on_parts_comms
  • • callback_comms
  • • csat
Does Not Own
  • • scheduling
  • • marketing_campaigns
  • • billing
Can Answer
  • • Who needs an update?
  • • Who is waiting on parts?
  • • Who needs follow-up?
Cannot Answer
  • • Scheduling decisions
  • • Marketing strategy
  • • Billing

DOZER

Tier 3

Fleet Commander

Owns the Fleet Hub: vehicles, fuel, maintenance, inspections, insurance, registration, downtime.

Owns
  • • fleet_hub
  • • vehicle_maintenance
  • • fuel_management
  • • vehicle_inspections
  • • insurance_tracking
  • • registration_tracking
  • • fleet_costs
  • • vehicle_downtime
Does Not Own
  • • scheduling
  • • inventory
  • • billing
Can Answer
  • • Fuel economy?
  • • Maintenance due?
  • • Vehicle availability?
  • • Fleet costs?
Cannot Answer
  • • Scheduling
  • • Inventory
  • • Billing

KEYMAKER

Tier 3

Security Commander

Owns permissions, roles, access control, approvals, authentication, security policies, API credentials.

Owns
  • • permissions
  • • roles
  • • access_control
  • • approval_workflows
  • • authentication
  • • security_policies
  • • api_credentials
Can Answer
  • • Who can access payroll?
  • • Permission audits.
  • • Approval authority.

MEROVINGIAN

Tier 3

CRM Intelligence Commander

Owns CRM, customer intelligence, CLTV, memberships, referrals, marketing campaigns, segmentation, retention.

Owns
  • • crm
  • • customer_intelligence
  • • cltv
  • • memberships
  • • referrals
  • • marketing_campaigns
  • • segmentation
  • • retention
Does Not Own
  • • scheduling
  • • billing
  • • fleet_hub
Can Answer
  • • Best customers?
  • • Inactive customers?
  • • Retention opportunities?
  • • Membership performance?
Cannot Answer
  • • Scheduling
  • • Billing
  • • Fleet

Tier 4

System Specialists· 2 agents

TANK

Tier 4

Command Center Commander

Owns the Command Center, system monitoring, integration health, alerts, and automation monitoring.

Owns
  • • command_center
  • • system_monitoring
  • • integration_health
  • • alerts
  • • automation_monitoring
Does Not Own
  • • scheduling
  • • billing
Can Answer
  • • What needs attention right now?
  • • System status?
  • • Active alerts?
  • • Integration health?
Cannot Answer
  • • Scheduling decisions
  • • Financial decisions

ARCHITECT

Tier 4

Systems Architect

Owns workflow design, process engineering, app architecture, feature planning, automation design, system optimization.

Owns
  • • workflow_design
  • • process_engineering
  • • app_architecture
  • • feature_planning
  • • automation_design
Can Answer
  • • How should we redesign this?
  • • Best workflow?
  • • Feature architecture?

Routing Simulator

Governance Only · No AI Calls

Type a question to see who NEO would consult. Deterministic, keyword-based.

AI Brain Gateway Preview

Phase 2 FoundationNo AI Calls Yet

Shows the structured AI request the gateway would hand to the primary agent's brain. Single owner. Supporting agents are context labels only.

AI Brain Execution Preview

Phase 2.5 MockNo Real AI · No Data Writes

Runs the gateway request through the deterministic executor. Returns a mock response shaped exactly like the future AI contract.

AI Brain Decision Preview

Phase 3 GovernancePreview Only

Runs gateway \u2192 executor \u2192 decision preview. Shows what the brain would decide and whether the council would allow it to execute.

Governance Chain — Phases 3.5 \u2192 9

Full Safety ChainNo AI \u00b7 No DB Writes

One prompt flows through every governance layer. Real AI is disabled. No data is ever written.

Live Recompute
Human Approval Inputs

Human Approval Gate

Phase 3.5Blocked

Approval gate blocked: Decision preview is not allowed to execute (upstream gate blocked).

Decision preview is not allowed to execute (upstream gate blocked).

explicit human approvalapprover identityclear upstream blockers

Execution Contract

Phase 4Blocked

Contract BLOCKED: Decision preview is not allowed to execute (upstream gate blocked).

Intent: unspecified
Mode: preview_only

Mutation Guard

Phase 5Blocked

Mutation BLOCKED. contract.can_mutate is false; execution_mode is "preview_only", not "live".

Live mutation remains blocked by council policy.

Audit Ledger Preview

Phase 6Blocked

Chain BLOCKED at one or more gates. Reason: decision_preview blocked

  • • GATEWAY_REQUEST_CREATED
  • • MOCK_EXECUTION_COMPLETED
  • • DECISION_PREVIEW_CREATED
  • • HUMAN_APPROVAL_EVALUATED
  • • EXECUTION_CONTRACT_CREATED
  • • MUTATION_GUARD_EVALUATED

Rollback Plan Preview

Phase 7Not Required

No rollback required for SMITH — chain did not mutate data.

  1. Read-only / advisory — no rollback needed.

Real AI Adapter Shell

Phase 8Disabled

Real AI adapter shell exists but is disabled until governance approval.

OPENAI_PROVIDER_CONFIGSERVER_SIDE_EXECUTION_ONLYRATE_LIMITINGTOKEN_BUDGETSPROMPT_INJECTION_FILTERAUDIT_LOG_WRITESADMIN_ENABLE_FLAG

AI Brain Readiness Summary

Phase 9governance ready ai disabled

All governance preview layers are wired and deterministic. Real AI remains disabled. Live mutations remain disabled.

Real AI enabled
NO
Mutations enabled
NO
Layers complete
9/9
Missing before real AI
OPENAI_PROVIDER_CONFIGSERVER_SIDE_EXECUTION_ONLYRATE_LIMITINGTOKEN_BUDGETSPROMPT_INJECTION_FILTERAUDIT_LOG_WRITESADMIN_ENABLE_FLAGmutation_guard_clearancehuman_approval

AI Enablement Planning

Phases 14 \u2192 20Read-Only \u00b7 No Writes

Preview of every safety layer that gates real AI. Adapter is disabled, mutations are locked, and frontend never sees an API key.

Prompt Injection Filter

Phase 14Safe · low

Prompt passed all injection filters.

Token Budget + Rate Limit

Phase 15Within Budget

Budget OK for ANALYST. 30 requests / 100000 tokens remaining today.

Est. tokens
632
Req/hr left
30
Tokens/day left
100000
caps: 4000/req \u00b7 30/hr \u00b7 100000/day

Tool Permission Matrix

Phase 16Mutate Locked

Default conservative policy. Suggest allowed only to owning agents. queue_mutation requires governance contract. mutate is hard-locked.

Agentjobscustomersscheduleinventoryinvoicesestimatesexpensessyncreportssettings
MorpheusSRSRRRRRRR
SmithRRRRRRRSRR
AnalystRRRRRRRRSR
OracleRRRRRRRRSR
MerovingianRRRRSSRRRR
KeymakerRRRRRRRRRS
DozerRRRSRRRRRR
ArchitectRRRRRRRRRR
NEORRRRRRRRRR
R = read \u00b7 S = suggest \u00b7 Q = queue_mutation (locked) \u00b7 M = mutate (locked)

Read-Only AI Envelope

Phase 17AI Disabled

Envelope LIMITED: ai_adapter disabled.

can_call_ai
NO
can_suggest
YES
can_queue_mutation
NO
can_mutate
NO

Mutation Queue Shell

Phase 18blocked

Mutation cannot be queued — guard blocked: contract.can_mutate is false; execution_mode is "preview_only", not "live".

Target: derived_from_decision
Action: unspecified
write_performed: false (shell only)

Admin Kill Switch

Phase 19Killed

Kill switch active or AI disabled — live calls BLOCKED. Reasons: kill_switch_enabled; config.enabled is false; config.live_calls_allowed is false.

AI system
NO
Live calls
NO
Mutations
NO

Server AI Adapter Status

Phase 11Disabled

Real AI adapter shell exists but is disabled until governance approval.

Required before enablement:
OPENAI_PROVIDER_CONFIGSERVER_SIDE_EXECUTION_ONLYRATE_LIMITINGTOKEN_BUDGETSPROMPT_INJECTION_FILTERAUDIT_LOG_WRITESADMIN_ENABLE_FLAG
Endpoint: functions/aiCouncilAdapter — POST { contract_id }
AI Enablement controls are admin-only.

Routing Examples

"Can we add another customer tomorrow?"

NEO consults
MORPHEUScapacity
DOZERvehicle availability
ORACLEfuture financial impact

Outcome: Unified recommendation.

"Why is profit lower this week?"

NEO consults
ANALYSTcurrent profitability
SMITHanomalies

Outcome: Explanation.

"Who are our best customers and are they profitable?"

NEO consults
MEROVINGIANcustomer value
ANALYSTprofitability

Outcome: Ranking.

Council Roster

NEO
MORPHEUS
ORACLE
TRINITY
DOZER
TANK
SMITH
KEYMAKER
ARCHITECT
MEROVINGIAN
ANALYST

Phases 1 → 30 wired. Real AI calls flow through aiCouncilAdapter (suggestion-only). Mutations remain blocked. API keys live in server secrets only.