norma

Norma — Maldonado UY zoning plugin for Claude Code

Norma is a Claude Code plugin for working with Maldonado department zoning rules: pick parcels (on the Mapa app or by padron number), get a written envelope analysis grounded in the TONE (Texto Ordenado de Normas Edilicias, Volumen V del Digesto Departamental), and render a printable report.

The plugin ships one entry point — /norma — that dispatches to two sub-skills:

Slash command	Does	When
/norma	Dispatcher — reads your task, routes to the right sub-skill	Always start here
/norma-analyze	Envelope analysis (FOS, FOT, height, retiros, scenario filtering)	Padrón + locality, ArcGIS JSON, or selection.v1.json from the Mapa
/norma-informe	Printable A4 HTML report	An existing *.normativa.v1.json envelope

Install

Option A — Claude Code marketplace (recommended)

/plugin marketplace add Estudio-Local/normativa
/plugin install norma@normativa

That's it. /norma, /norma-analyze, and /norma-informe all become available.

Option B — Symlink (local dev)

git clone https://github.com/Estudio-Local/normativa.git
ln -s "$(pwd)/normativa" ~/.claude/plugins/norma

End-to-end flow

selection.v1.json (optional, from Mapa)
        │
        ▼
 /norma --input selection.v1.json
        │
        ▼ (dispatcher routes to /norma-analyze)
 /norma-analyze --input selection.v1.json
        │
        ├─→ <basename>.md                    (humans read this; carries
        │                                     norma:requires-disclaimer marker)
        └─→ <basename>.normativa.v1.json     (validated against
                                │             normativa-v1-schema.md
                                │             before exit)
                                ▼
                         /norma --input <basename>.normativa.v1.json
                                │
                                ▼ (dispatcher routes to /norma-informe)
                         /norma-informe --input <basename>.normativa.v1.json
                                │
                                └─→ <basename>.informe.html  (printable A4)

You can also call the sub-skills directly if you know what you need (/norma-analyze 130,131,132 en la-juanita, /norma-informe path/to/envelope.normativa.v1.json).

Three files per analysis:

File	Reader	Purpose
*.md	human	Full written analysis (with disclaimer + marker)
*.normativa.v1.json	machine	Structured envelope — feeds /norma-informe
*.informe.html	human	Printable A4 report (open in browser, print to PDF)

The *.normativa.v1.json filename and its internal schema: "estudio-local.normativa.v1" field are versioned data contracts — they intentionally preserve the historical token across skill renames so downstream consumers (the Mapa app, other tools) don't break. /norma-analyze runs normativa-v1-validate.py against its own output before exiting; if validation fails, the envelope is fixed before /norma-informe ever sees it.

Try it

Without installing anything, render the bundled example:

git clone https://github.com/Estudio-Local/normativa.git && cd normativa
python3 skills/norma-analyze/normativa-v1-validate.py \
  examples/padrones-130-132-la-juanita.normativa.v1.json
python3 skills/norma-informe/norma-informe-render.py \
  examples/padrones-130-132-la-juanita.normativa.v1.json
open examples/padrones-130-132-la-juanita.informe.html

Validates the canonical envelope, renders a 4-page printable report, opens it in your browser. ⌘P / Ctrl+P → "Save as PDF" to share.

Repo layout (v0.8 architecture)