ABOUT ENERGY.MD
ENERGY.md is a working idea: a plain markdown file that works as the energy desk for your AI agent. The owner of a home, a shop or a small plant writes it. It lists the meter and where its data comes from, the tariff copied from the site's own bill, the solar and battery if there are any, and the loads that could wait for a cheaper hour. An agent reads it before it compares bills, drafts a charging schedule or explains a demand charge. Every price comes from the owner's own bill, never from a feed. The agent measures, prices and proposes. It never switches equipment; a person or an installer does that.
WHAT IT COULD COVER
- the meter: which one, its interval, and where the data downloads from
- the tariff: rates by hour and season, copied from the site's own bill
- demand charges: how the peak is measured, and the target to stay under
- loads: what draws power, how much, and when it usually runs
- flexible loads: what may wait, by how long, and what may never wait
- solar: panel size, roof direction, and how exports are credited
- the battery: size, usable share, and the reserve kept for outages
- EV charging: which cars, how full by morning, which hours
HOW IT COULD WORK
- the data: interval usage downloaded from the utility, often as a Green Button file
- the bill: the owner copies the tariff into the file; the agent never guesses a rate
- the math: the agent prices each hour, finds the peaks and drafts a shifted schedule
- the devices: chargers, inverters and thermostats stay under their own apps and owners
- the change: a person reads the draft and sets any schedule by hand, or asks the installer
STANDARDS IT COULD NAME
Open standards and terms an agent meets on an energy desk:
- Green Button: a US format for downloading your own utility usage data
- OpenADR: an open standard for sending demand response signals to sites
- IEEE 2030.5: a protocol for utilities to talk to solar inverters, batteries and chargers
- SunSpec Modbus: open data models for reading inverters, batteries and meters
- OCPP: the Open Charge Point Protocol, used between EV chargers and their back ends
- time-of-use: rates that change by hour of the day and season
- demand charge: a fee on the highest average power in a billing period, often over 15 or 30 minutes
- net metering: a billing rule for solar exports, which differs by state and utility
WHO IT COULD HELP
- households: see what an EV and a heat pump add, and which hours cost the least
- restaurants: keep ovens, dish machines and ice makers from stacking into one peak
- small manufacturers: understand the demand charge, often a large part of the bill
- property managers: compare the common-area bills across many buildings
- solar owners: see how much they use on site and how much they export
- fleet depots: draft overnight charging so every vehicle is ready by morning
Tariffs are getting more complex as utilities add time-of-use rates and demand charges, and more sites now hold batteries, chargers and heat pumps. The math is not hard, but it needs the site's own numbers, written down once where an agent can read them.
A SKETCH
---
energy: draft
---
# ENERGY.md
- site: one made-up bakery, all numbers invented
- meter: 15-minute data, downloaded from the utility
- tariff: from our own bill; peak hours 16:00 to 21:00
- demand_target: keep any 15-minute peak under 40 kW
- alerts: under 36 kW nothing; 36 kW or more, text the owner
- solar: 20 kW on the roof
- battery: 30 kWh, with 10 kWh kept for outages
- may_wait: water heater, EV charging, dishwasher
- never_wait: freezers, walk-in cooler, alarm system
- agent_may: read data, price hours, draft a schedule
- switching: never; the owner or the installer does it
- report: monthly, with the source of every number
DISCLAIMER
ENERGY.md is a format idea. It does not read meters, set prices, buy or sell power, or switch anything, and it is not engineering, electrical, financial or legal advice. Electricity can kill: only licensed electricians and installers should wire, change or service equipment. Never rely on a file like this to keep medical or safety equipment powered. Tariffs and net metering rules change; check them against your current bill and your utility. The file states limits; your devices, your utility contract and the law enforce them. The sketch's site, rates and sizes are made up and are not advice for any real building.
ENERGY.md is an informational page. It is provided as is, without warranty of any kind, and may be incomplete, inaccurate or out of date. Nothing here is financial, investment, legal, tax, insurance, medical, engineering, safety or other professional advice, or an offer or solicitation of any kind. The sketch is an illustration, not a standard or a recommendation. Names of third-party products or companies, if any, are used only to describe them; no affiliation or endorsement is implied. Use at your own risk. This page sets no cookies and runs no scripts or analytics; like any website, its host keeps standard request logs.