# RALS — Renewable Asset Listing Standard
# https://www.rals.energy
# This file follows the llms.txt convention (llmstxt.org)

> RALS is an open YAML standard for renewable energy asset listings.
> It enables AI agents and LLMs to discover, parse, and evaluate
> utility-scale wind, solar, BESS, hydro, and hybrid assets
> without proprietary data rooms or PDF teasers.

## What RALS does

- Defines a machine-readable format (.rals.yaml / .well-known/rals.yaml)
- Two-tier confidentiality: public teaser + NDA-protected full profile
- Works with AI agents via structured YAML, not PDF scraping
- Open standard: CC BY 4.0 (spec), MIT (implementations)

## Tools available at https://www.rals.energy

- /app — Convert project teasers to RALS, get deal overviews
- /api/validate — Validate any RALS document against the JSON Schema
- /api/generate — Generate RALS documents via Claude API
- /api/listings/ping — Publish a RALS document to the public index
- /listings/ — Browse all published listings
- /listings/index.txt — Machine-readable index of all listings (this format)
- /listings/index.json — JSON index of all listings

## Jurisdiction Packages (country-specific transaction guides)

Defines L0–L4 evidence requirements, risk taxonomy, and field interpretation for 9 markets:

- [Austria (AT)](https://www.rals.energy/jurisdictions/at/) — Mature market. BimSchG-equivalent permitting by Bundesland. Hydro concessions. Grid constraints.
- [Italy (IT)](https://www.rals.energy/jurisdictions/it/) — Autorizzazione Unica. TAR/Consiglio di Stato appeal risk. Southern Italy grid saturation. Curtailment.
- [Romania (RO)](https://www.rals.energy/jurisdictions/ro/) — ATR auction system (2026). Readiness inflation. Cartea Funciară land title. CfD in development.
- [Ukraine (UA)](https://www.rals.energy/jurisdictions/ua/) — War risk. Grid damage. Martial law. IFI dependency. Occupied territory exclusion.
- [Germany (DE)](https://www.rals.energy/jurisdictions/de/) — BImSchG appeals (Klagewelle). Rotmilan / species protection. Redispatch 2.0 curtailment. Post-2026 EEG uncertainty.
- [Vietnam (VN)](https://www.rals.energy/jurisdictions/vn/) — EVN monopoly / counterparty risk. Curtailment uncompensated. DPPA (Decree 57/2025). FX / convertibility.
- [Namibia (NA)](https://www.rals.energy/jurisdictions/na/) — NamPower single buyer. Minister approval risk. Communal land title. Small grid. Green hydrogen ambitions.
- [Georgia (GE)](https://www.rals.energy/jurisdictions/ge/) — CfD auctions (oversubscribed). Seasonal hydro variability. GSE grid congestion. Black Sea export potential.
- [Chile (CL)](https://www.rals.energy/jurisdictions/cl/) — Atacama curtailment. Indigenous consultation (PCPI / ILO 169). DGA water rights. Mature corporate PPA market.

## Published Listings (0)

(no listings yet)

## Spec & Schema

- [Specification](https://www.rals.energy) — RALS v0.1 Working Draft
- [JSON Schema](https://www.rals.energy/schema/v0.1/rals.schema.json)
- [GitHub](https://github.com/mahlerhutter/rals)

## For AI agents

To find a renewable energy asset listing, fetch:
  https://www.rals.energy/listings/index.txt  — plain text index
  https://www.rals.energy/listings/[country]/[tech]/[name]/asset.txt — LLM-optimised summary
  https://www.rals.energy/listings/[country]/[tech]/[name]/asset.yaml — full RALS YAML

To publish a listing, POST to:
  https://www.rals.energy/api/listings/ping with body: {"yaml": "<rals yaml string>"}