See the stars

Municipal Resource Intelligence Specification

Home / Municipal Resource Intelligence / Municipal Resource Intelligence Specification

Municipal Resource Intelligence

From Municipal Data to Actionable Savings.


Overview

Municipal Resource Intelligence is an open source AI specification designed to help municipalities identify economical, efficient, transparent, and sustainable ways to manage public resources.

The system analyzes municipal services, expenditures, contracts, personnel, procurement, service delivery models, and property-tax requirements to identify opportunities for measurable savings. It evaluates the total economic effect of recommendations on both the municipality and its residents rather than treating reductions in municipal spending as savings when those costs are simply transferred to taxpayers.

Municipal Resource Intelligence is designed with a modular architecture. Core modules provide the fundamental municipal intelligence and optimization capabilities. Optional plugin modules extend the system with specialized integrations, analytical capabilities, data sources, and reporting functions.

The system is intended to remain vendor-neutral, auditable, transparent, human-governed, and adaptable to municipalities of different sizes and organizational structures.

Core Principles

  • Analyze every municipal service and material expenditure.
  • Examine the complete economic cost of municipal services.
  • Compare multiple service delivery models.
  • Distinguish municipal savings from community-wide savings.
  • Identify opportunities for recurring and one-time savings.
  • Track projected savings separately from verified savings.
  • Recalculate municipal financial requirements as verified recurring savings accumulate.
  • Calculate the property-tax effect of approved reforms.
  • Generate individual property-tax impact reports with each applicable reform.
  • Benchmark municipal positions according to duties, compensation, hours, and workload.
  • Provide transparent public records for material financial recommendations.
  • Preserve source data, assumptions, calculations, and methodology.
  • Maintain human authority over municipal decisions.
  • Never treat an AI recommendation as an automatic government decision.
  • Support continuous analysis rather than one-time budget review.
  • Avoid vendor lock-in.
  • Support local-first and self-hosted deployment.
  • Provide interoperable data and reporting capabilities.
  • Maintain a clear distinction between projected, approved, implemented, and verified financial results.

Core Modules

Municipal Data Intake Module

The Municipal Data Intake Module collects and normalizes municipal financial, operational, administrative, and public service information.

Features include:

  • Municipal budgets
  • Annual financial reports
  • Department expenditures
  • Revenue records
  • Tax levy information
  • Property-tax data
  • Procurement records
  • Vendor records
  • Contracts
  • Payroll records
  • Compensation records
  • Benefits information
  • Pension information
  • Overtime records
  • Service utilization records
  • Equipment records
  • Capital expenditures
  • Debt obligations
  • Insurance costs
  • Facilities costs
  • Maintenance costs
  • Utility costs
  • Grants
  • Fees
  • Permits
  • Public records
  • Service performance data
  • Historical financial information
  • Municipal operating data

The module shall identify missing, inconsistent, outdated, or incomplete data and disclose those limitations before the affected information is used for material recommendations.

Municipal Service Inventory Module

The Municipal Service Inventory Module maintains a complete inventory of municipal services, programs, departments, activities, and associated expenditures.

Features include:

  • Comprehensive service catalog
  • Department mapping
  • Program mapping
  • Service ownership identification
  • Service population identification
  • Service utilization tracking
  • Service cost assignment
  • Service frequency tracking
  • Service performance metrics
  • Service dependency mapping
  • Required versus discretionary service classification
  • Duplicate service identification
  • Overlapping service identification
  • Underutilized service identification
  • Historical service comparison
  • Service lifecycle tracking

Every municipal service shall be eligible for analysis. The system shall not exclude a service solely because it has traditionally been provided by government.

Service Cost Analysis Module

The Service Cost Analysis Module determines the complete economic cost of each municipal service.

Features include:

  • Direct expenditure analysis
  • Indirect expenditure analysis
  • Labor costs
  • Benefits
  • Pension costs
  • Overtime
  • Administrative overhead
  • Procurement costs
  • Equipment costs
  • Equipment depreciation
  • Facilities costs
  • Maintenance costs
  • Insurance
  • Utilities
  • Fuel
  • Capital expenditures
  • Debt-related costs
  • Contract administration
  • Technology costs
  • Compliance costs
  • Replacement costs
  • Long-term obligations
  • Cost per resident
  • Cost per household
  • Cost per service
  • Cost per transaction
  • Cost per unit of output

The module shall identify costs that are commonly excluded from simple service-price comparisons.

Service Delivery Optimization Module

The Service Delivery Optimization Module compares economically viable methods of delivering each municipal service.

Potential delivery models include:

  • Municipal operation
  • Private contracting
  • Competitive procurement
  • Multiple private providers
  • Fee-for-service
  • Citizen-selected providers
  • Regional service agreements
  • Intermunicipal cooperation
  • Shared services
  • Nonprofit providers
  • Cooperative providers
  • Hybrid delivery models
  • Other legally permissible delivery models

The module shall compare costs, service levels, administrative requirements, implementation costs, risks, and community-wide economic effects.

Citizen Service Cost Comparison Module

The Citizen Service Cost Comparison Module determines whether residents could obtain comparable services independently at a lower total cost than the existing municipal model.

Features include:

  • Current municipal cost per household
  • Current municipal cost per resident
  • Estimated direct citizen cost
  • Private provider pricing
  • Regional provider pricing
  • Service availability
  • Service quality comparison
  • Administrative savings
  • Transition costs
  • Contract termination costs
  • Resident participation assumptions
  • Aggregate citizen cost
  • Aggregate municipal savings
  • Net community savings
  • Distributional impact analysis

The system shall explicitly distinguish:

  • Municipal savings
  • Resident costs
  • Total community cost
  • Net community savings

A reduction in municipal spending shall not automatically be classified as a community savings if residents incur greater costs elsewhere.

Fee-for-Service Analysis Module

The Fee-for-Service Analysis Module identifies municipal services that may be economically appropriate for user-based fees rather than general taxation.

Features include:

  • Service eligibility analysis
  • Current taxpayer subsidy
  • Cost recovery analysis
  • Partial cost recovery analysis
  • Full cost recovery analysis
  • User fee modeling
  • Administrative cost modeling
  • Resident participation modeling
  • Equity impact analysis
  • Revenue projections
  • Tax levy impact
  • Alternative pricing scenarios
  • Public service accessibility analysis

The module shall distinguish essential public services from services where a fee-for-service model may be appropriate.

Provider Intelligence Module

The Provider Intelligence Module evaluates potential service providers and available market alternatives.

Features include:

  • Provider identification
  • Provider service area
  • Pricing comparison
  • Service offerings
  • Qualifications
  • Licensing
  • Insurance requirements
  • Capacity
  • Contract terms
  • Contract duration
  • Renewal provisions
  • Cancellation provisions
  • Performance information
  • Service-level comparison
  • Geographic availability
  • Competitive market analysis

The system may recommend providers or provider categories but shall not automatically award contracts.

Contract Analysis Module

The Contract Analysis Module evaluates existing municipal contracts for cost and structural optimization opportunities.

Features include:

  • Contract cost analysis
  • Contract duration
  • Renewal provisions
  • Automatic renewal detection
  • Escalation clauses
  • Minimum-volume requirements
  • Service-level requirements
  • Unused services
  • Duplicate services
  • Administrative charges
  • Vendor concentration
  • Market-price comparison
  • Competitive rebidding opportunities
  • Contract restructuring opportunities
  • Contract termination costs
  • Contract transition costs

Procurement Optimization Module

The Procurement Optimization Module evaluates municipal purchasing and procurement practices.

Features include:

  • Competitive pricing analysis
  • Vendor comparison
  • Bulk purchasing analysis
  • Cooperative purchasing analysis
  • Regional purchasing opportunities
  • Procurement frequency analysis
  • Contract consolidation
  • Duplicate purchasing detection
  • Price variance detection
  • Procurement timing analysis
  • Bid comparison
  • Renewal analysis
  • Long-term purchasing scenarios

Compensation, Workload, and Position Benchmarking Module

The Compensation, Workload, and Position Benchmarking Module evaluates every municipal position using duties, compensation, hours, workload, qualifications, and responsibilities.

Features include:

  • Complete position inventory
  • Position descriptions
  • Actual duties analysis
  • Required qualifications
  • Education requirements
  • Certification requirements
  • Experience requirements
  • Supervisory responsibilities
  • Employees supervised
  • Department assignment
  • Base salary
  • Overtime compensation
  • Bonuses
  • Benefits
  • Pension costs
  • Retirement contributions
  • Employer-paid costs
  • Scheduled hours
  • Actual hours worked
  • Overtime hours
  • On-call hours
  • Emergency response hours
  • Seasonal hours
  • Paid hours
  • Training hours
  • Total annual working hours
  • Effective hourly salary
  • Effective hourly total compensation
  • Statewide comparison
  • Regional comparison
  • Comparable public-sector positions
  • Comparable private-sector positions where appropriate
  • Workload-adjusted compensation
  • Services delivered per employee
  • Services delivered per labor hour
  • Cost per service delivered
  • Department staffing analysis
  • Management-layer analysis
  • Position consolidation analysis

The system shall compare positions according to actual duties and responsibilities rather than relying solely on job titles.

The system shall not classify an employee as overpaid solely because compensation exceeds an average. Differences in workload, qualifications, geographic conditions, responsibilities, tenure, labor agreements, staffing conditions, and specialized expertise shall be considered.

Department Optimization Module

The Department Optimization Module evaluates departments as complete operational units.

Features include:

  • Department spending analysis
  • Staffing analysis
  • Management structure analysis
  • Service output analysis
  • Administrative overhead
  • Department workload
  • Duplicate responsibilities
  • Interdepartmental overlap
  • Shared staffing opportunities
  • Consolidation scenarios
  • Outsourcing scenarios
  • Regional cooperation scenarios
  • Service-level impact
  • Long-term cost projections

Savings Tracking Module

The Savings Tracking Module records and monitors financial savings generated through approved reforms.

Features include:

  • Projected savings
  • Approved savings
  • Implemented savings
  • Verified savings
  • One-time savings
  • Recurring savings
  • Savings by service
  • Savings by department
  • Savings by reform
  • Savings by fiscal year
  • Cumulative savings
  • Projected versus actual savings
  • Savings verification
  • Savings reconciliation
  • Savings attribution
  • Future savings projections

Recurring savings shall be tracked separately from one-time savings because recurring savings have different implications for future municipal financial requirements.

Municipal Levy Recalculation Module

The Municipal Levy Recalculation Module continuously evaluates how verified recurring savings affect the municipality’s required property-tax levy.

Features include:

  • Current municipal levy
  • Required municipal revenue
  • Verified recurring savings
  • One-time savings exclusion from recurring calculations
  • Revenue changes
  • Debt obligations
  • Required expenditures
  • Reserve requirements
  • Financial obligations
  • Revised expenditure requirements
  • Revised levy requirements
  • Tax-rate modeling
  • Multi-year levy projections
  • Reform-specific levy impacts
  • Cumulative levy impacts

When verified recurring savings reduce the amount of revenue required from property taxation, the system shall calculate the resulting potential property-tax reduction.

The system shall not assume that every savings amount can legally or immediately reduce the levy. Applicable legal, financial, contractual, debt, reserve, and budgetary requirements must be incorporated into the calculation.

Individual Property Tax Impact Module

The Individual Property Tax Impact Module generates property-specific reports when approved municipal reforms affect the property-tax burden.

Features include:

  • Property identification
  • Property address
  • Property assessed value
  • Applicable municipal tax rate
  • Current municipal property-tax amount
  • Pre-reform levy
  • Post-reform levy
  • Reform description
  • Reform-specific savings
  • Property-specific tax impact
  • Dollar reduction
  • Percentage reduction
  • Cumulative savings
  • Historical reform impacts
  • Projected future impacts
  • Actual versus projected impacts

Each applicable reform shall be traceable to the property-tax impact it generates.

The system shall distinguish municipal tax impacts from taxes imposed by other taxing authorities.

Property Tax History Module

The Property Tax History Module maintains a longitudinal record of municipal reforms and their effect on individual properties.

Features include:

  • Original property-tax baseline
  • Reform-by-reform history
  • Annual municipal tax amount
  • Revised municipal tax amount
  • Annual savings
  • Cumulative savings
  • Percentage change
  • Projected savings
  • Verified savings
  • Actual savings
  • Historical levy changes

Scenario Modeling Module

The Scenario Modeling Module allows municipalities to evaluate proposed reforms before implementation.

Features include:

  • Service elimination scenarios
  • Service restructuring scenarios
  • Privatization scenarios
  • Fee-for-service scenarios
  • Citizen-direct-purchase scenarios
  • Contract replacement scenarios
  • Staffing scenarios
  • Department consolidation scenarios
  • Procurement scenarios
  • Regional cooperation scenarios
  • Tax levy scenarios
  • Property-tax scenarios
  • One-year projections
  • Three-year projections
  • Five-year projections
  • Ten-year projections
  • Sensitivity analysis
  • Risk analysis
  • Uncertainty analysis
  • Alternative comparison

Community Economic Impact Module

The Community Economic Impact Module evaluates the broader financial effects of municipal decisions.

Features include:

  • Municipal savings
  • Resident direct costs
  • Resident indirect costs
  • Total community cost
  • Net community savings
  • Cost distribution
  • Household impact
  • Service accessibility
  • Economic burden
  • Transition effects
  • Long-term economic impact

The module shall prevent the system from treating cost shifting as genuine economic savings.

Public Records & Transparency Module

The Public Records & Transparency Module generates public documentation for material municipal analyses and reforms.

Features include:

  • Public recommendation records
  • Public decision records
  • Service cost records
  • Contract analysis records
  • Provider comparison records
  • Compensation benchmarking records
  • Savings records
  • Property-tax impact summaries
  • Data source documentation
  • Calculation documentation
  • Assumption documentation
  • Methodology documentation
  • Alternative analysis
  • Implementation results
  • Verified savings
  • Historical records

Every material AI-generated financial recommendation shall produce a corresponding public transparency record unless disclosure is prohibited by applicable law.

Public Transparency Dashboard Module

The Public Transparency Dashboard Module presents municipal financial information in an accessible format.

Features include:

  • Municipal spending
  • Department spending
  • Service costs
  • Contract costs
  • Provider comparisons
  • Staffing costs
  • Compensation comparisons
  • Savings
  • Verified savings
  • Reforms
  • Property-tax impacts
  • Historical comparisons
  • Public records
  • Search
  • Filtering
  • Downloadable reports
  • Aggregate taxpayer impact

Individual property information shall be protected through appropriate access controls while aggregate municipal financial information remains publicly accessible where legally permitted.

Audit & Data Provenance Module

The Audit & Data Provenance Module provides traceability for financial analysis and recommendations.

Features include:

  • Source identification
  • Data provenance
  • Source timestamps
  • Calculation history
  • Assumption tracking
  • Recommendation history
  • Model output history
  • Human review records
  • Approval records
  • Rejection records
  • Revision history
  • Savings verification history
  • Tax recalculation history
  • Public record linkage

The system shall make it possible to determine how a recommendation was produced and which source information contributed to the conclusion.

Human Governance Module

The Human Governance Module maintains human authority over municipal decisions.

Features include:

  • Human review
  • Recommendation approval
  • Recommendation rejection
  • Recommendation modification
  • Human override
  • Decision documentation
  • Conflict disclosure
  • Uncertainty disclosure
  • Limitation disclosure
  • Review workflows
  • Administrative authorization
  • Elected-official decision records

The AI shall provide analysis and recommendations but shall not independently eliminate services, terminate contracts, alter compensation, impose fees, change taxes, or award contracts.

Continuous Optimization Module

The Continuous Optimization Module maintains an ongoing municipal optimization cycle.

The cycle includes:

  • Analyze
  • Compare
  • Recommend
  • Review
  • Approve or reject
  • Implement
  • Measure
  • Verify
  • Recalculate savings
  • Recalculate municipal financial requirements
  • Recalculate applicable property-tax impacts
  • Publish records
  • Monitor outcomes
  • Reassess opportunities

The system shall continuously compare projected outcomes with actual results and update future recommendations accordingly.

Data Validation Module

The Data Validation Module evaluates the quality and reliability of information used by the system.

Features include:

  • Missing-data detection
  • Duplicate-data detection
  • Conflicting-data detection
  • Outdated-data detection
  • Anomaly detection
  • Source reliability assessment
  • Calculation validation
  • Cross-source comparison
  • Confidence scoring
  • Data quality reporting

Material recommendations shall identify significant data limitations that could affect the recommendation.

Security & Access Control Module

The Security & Access Control Module protects municipal and property-specific information.

Features include:

  • Role-based access
  • Administrative permissions
  • Public access controls
  • Property-owner authentication
  • Restricted financial records
  • Audit logging
  • Data access logging
  • Data modification logging
  • Authentication
  • Authorization
  • Secure data handling
  • Separation of public and restricted information

Optional Plugin Modules

Optional plugins may extend the core system without changing the fundamental principles of Municipal Resource Intelligence.

State Data Integration Plugin

Provides integration with statewide public datasets, compensation databases, municipal financial records, procurement records, and other relevant state sources.

Municipal ERP Integration Plugin

Connects Municipal Resource Intelligence with municipal enterprise resource planning and financial management systems.

Payroll Integration Plugin

Imports payroll, compensation, benefits, hours, overtime, and employment data.

Property Assessment Integration Plugin

Connects the system with applicable property assessment and valuation systems for property-tax impact calculations.

Procurement Platform Plugin

Connects procurement records, bids, vendor information, contracts, and purchasing data.

Public Records Integration Plugin

Publishes approved transparency records to municipal public records systems.

GIS & Geographic Analysis Plugin

Adds geographic analysis of services, providers, facilities, properties, service areas, and regional alternatives.

Regional Municipality Comparison Plugin

Compares municipalities with similar populations, geographic characteristics, service requirements, tax bases, and operational structures.

Market Pricing Plugin

Connects service and procurement analyses with available market pricing information.

Provider Discovery Plugin

Expands provider discovery and comparison capabilities using approved external data sources.

Legislative & Regulatory Analysis Plugin

Identifies applicable laws, regulations, mandates, procurement requirements, and restrictions that may affect a proposed municipal reform.

Public Engagement Plugin

Provides tools for public feedback, surveys, service prioritization, and resident participation in municipal reform discussions.

Notification Plugin

Provides notifications for new recommendations, savings verification, contract renewals, tax-impact updates, and public record publication.

Document Generation Plugin

Generates standardized municipal reports, financial analyses, public records, executive summaries, and property-tax reports.

Advanced Forecasting Plugin

Adds advanced forecasting, predictive modeling, sensitivity analysis, and long-term financial projections.

Comparative Compensation Database Plugin

Provides expanded statewide, regional, national, public-sector, and private-sector compensation benchmarking data.

Service Performance Plugin

Tracks service quality, response times, utilization, resident satisfaction, service output, and performance metrics alongside financial data.

Public Dashboard Plugin

Provides enhanced public visualization, filtering, comparison, historical analysis, and downloadable municipal financial information.

Reporting Requirements

Municipal Resource Intelligence shall support detailed reporting for:

  • Municipal budgets
  • Individual services
  • Departments
  • Contracts
  • Providers
  • Procurement
  • Positions
  • Compensation
  • Work hours
  • Workload
  • Staffing
  • Savings
  • Reforms
  • Municipal levy changes
  • Property-tax impacts
  • Community economic impacts
  • Public transparency
  • Historical outcomes

Reports shall identify whether financial values are:

  • Projected
  • Estimated
  • Approved
  • Implemented
  • Verified
  • Actual

Savings Verification Requirements

The system shall distinguish between anticipated savings and realized savings.

A projected saving shall not automatically become a verified saving.

Verified savings should be supported by appropriate financial records, implementation evidence, or subsequent municipal financial data.

The system shall reconcile projected savings with actual results and update future calculations when actual results differ from projections.

Property Tax Requirements

When verified recurring savings affect the amount of municipal revenue required from property taxation, the system shall recalculate the applicable municipal levy and determine the resulting property-tax impact.

Each applicable reform shall be traceable to:

  • The service or expenditure affected
  • The financial change
  • The verified savings
  • The resulting levy impact
  • The applicable property-tax impact
  • The cumulative taxpayer impact

Transparency Requirements

Transparency shall be a core system function.

The system shall make available, where legally permitted:

  • Source information
  • Methodology
  • Assumptions
  • Calculations
  • Recommendations
  • Alternatives considered
  • Projected savings
  • Verified savings
  • Implementation costs
  • Actual results
  • Municipal levy impacts
  • Aggregate property-tax impacts
  • Decision records
  • Reform histories

The system shall clearly identify information that is restricted by law or otherwise unsuitable for public disclosure.

AI Recommendation Requirements

AI-generated recommendations shall:

  • Identify the problem being analyzed.
  • Identify the data used.
  • Identify significant missing information.
  • Identify assumptions.
  • Identify alternatives.
  • Compare financial outcomes.
  • Compare service outcomes.
  • Identify risks.
  • Identify uncertainty.
  • Distinguish projected from verified savings.
  • Identify potential effects on residents.
  • Identify potential property-tax effects.
  • Provide an auditable explanation of the recommendation.
  • Remain subject to human review.

Vendor Neutrality

Municipal Resource Intelligence shall not require municipalities to use a particular vendor, provider, software platform, financial system, procurement platform, or service provider.

The specification shall support interoperable data formats and replaceable integrations.

Local-First Design

The system should support local-first operation, self-hosting, municipal control of data, and deployment without mandatory dependence on a centralized commercial service.

Municipalities should retain control over their data, configurations, analytical parameters, and deployment environment.

Open Source Requirements

Implementations of this specification should preserve the freedoms required by the AGPL-3.0+ license.

Network-deployed implementations must comply with applicable AGPL-3.0+ source availability requirements.

Core Economic Principle

Municipal Resource Intelligence shall optimize for total community economic efficiency, not merely reductions in municipal expenditures.

A municipal expenditure reduction shall not automatically be classified as a community saving if the resulting cost imposed on residents exceeds the municipal savings.

The system shall seek solutions that provide appropriate public services while minimizing the combined economic burden placed on the municipality and its residents.

Core Optimization Cycle

Municipal Resource Intelligence shall operate according to the following continuous model:

Analyze → Compare → Recommend → Review → Implement → Measure → Verify → Recalculate → Report → Disclose → Reassess

This cycle shall allow municipalities to continuously identify opportunities for more economical service delivery and continuously evaluate whether implemented reforms actually produced the expected results.


Specification Branding License (SBL)

Standard

Optional


License & Notice Requirements

Municipal Resource Intelligence is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.

Please note the following:

  • All contributions must comply with the AGPL-3.0+ terms.
  • Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to Roxanne Ardary and roxanneardary.com.
  • Municipal Resource Intelligence specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
  • The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update notice.md.
  • When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
  • Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.


Notice – Municipal Resource Intelligence

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

  • Roxanne Ardary, roxanneardary.com – August 24, 2026
    Created the repository for Municipal Resource Intelligence. Created the specification for an AI-driven municipal resource intelligence system designed to analyze municipal services and expenditures, identify actionable savings opportunities, compare service delivery and compensation costs, track verified savings, calculate property-tax impacts, and provide transparent public reporting.
  • [Add other contributors here] – [Date]
    [Describe contribution in one sentence]

License – Municipal Resource Intelligence

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points

  • You are free to use, modify, and distribute the code.
  • All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
  • The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.