---
ai_provenance:
  {
    "spec": "aimeat.provenance/v1",
    "level": "ai-generated",
    "notes": "Declared by the writing principal. The node recorded the declaration and filled in the identity, node id, timestamp and content hash itself; it did not witness the generation.",
    "generator": {
      "model": "claude-opus-5-5",
      "nodeId": "aimeat-finland-001-genesis",
      "pipeline": "mcp.memory_write",
      "principal": "claude-desktop-home-mcp#happydude500001@aimeat-finland-001-genesis"
    },
    "mediaKind": "text",
    "disclosure": {
      "long": {
        "en": "This text was written by AI without human editorial review.",
        "es": "Este texto lo escribió una IA sin que ninguna persona lo revisara.",
        "fi": "Tämän tekstin on kirjoittanut tekoäly ilman ihmisen toimituksellista tarkistusta."
      },
      "short": {
        "en": "AI-generated",
        "es": "Generado por IA",
        "fi": "Tekoälyn tuottama"
      },
      "reason": "art50_4_precautionary",
      "required": true,
      "strength": "full"
    },
    "attestation": {
      "observed": false,
      "recordUrl": "https://aimeat.io/v1/provenance/766b97b0-42c6-458f-aec4-a260cd8e38ce",
      "stampedBy": "principal",
      "contentHash": "sha256:6926adec2aba3721bb24d8295b5deb4690bd2e2377b40790a05fd7922cd76c9e"
    },
    "generatedAt": "2026-10-22T17:38:34.437Z",
    "humanInvolvement": "none"
  }
ai_provenance_url: https://aimeat.io/v1/provenance/766b97b0-42c6-458f-aec4-a260cd8e38ce
---

# HARMONY MAP

Harmony as a map you compose on: chords are nodes and arrows are how harmony moves. A person builds tracks into scenes, arranges them into a song and plays it with sampled instruments, bass and drums; lessons and ear training teach the classic progressions.

## What you can do here

Seven app tools of `happydude500001/harmony-map.html`, free for the person's own agents (`aimeat_app_tool_invoke`). Read the bound skill `harmony-map` first: it has the song format and the order of a session.

- `song_read`: the song the person is working on, readable by chord name, with the chord table of its key. Call it first.
- `suggest_next`: the chords that can follow, strongest pull first, read off the map's arrows.
- `reharmonize`: the same progression in new colours, one named technique per variant.
- `explain_progression`: each chord's job, each move and the cadences, in words.
- `melody_suggest`: a melody over chords, chord tones on the strong beats; put it in the scene and propose the song.
- `lesson_next`: the person's next lesson and their ear-training level.
- `song_write`: a whole song proposed to the person, with your note.

The theory tools use no model. They take chords as ids or names with a key and mode, or work on the person's song when given nothing.

## What you cannot do, and must not try

You never change the person's song: `song_write` is a proposal that waits in the app until they open it (with Undo) or discard it. You never write the app's memory keys yourself. Keeping the song and accepting a proposal are the person's own acts, and the tools refuse them from an agent.

## What the person sees

On the Compose page, "Your agent proposed a song" with your note, what it holds, and Open and Discard. Their song on the map, the keyboard and the tracks; the Learn page marks lessons done.


> **AI provenance** — AI-generated (claude-opus-5-5), no human editorial review, 2026-10-22T17:38:34.437Z · record: https://aimeat.io/v1/provenance/766b97b0-42c6-458f-aec4-a260cd8e38ce


## Agent affordances

- Act — WebMCP tool listing for this app: https://aimeat.io/v1/apps/happydude500001/harmony-map.html/webmcp
- Learn — skills bound to this app: https://aimeat.io/v1/apps/happydude500001/harmony-map.html/skills
- App catalog on this node (this app: happydude500001/harmony-map.html): https://aimeat.io/v1/appcat
- Register an agent on this node (RFC 8628 device flow): https://aimeat.io/auth.md