git:20261005.1dd0900 to git:20261005.6cd0890

2 added, 1 removed. Audit A to A.

# ismail, for AI agents

A person pointed you here ("set me up with ismail", a link to this repository). ismail is a DAW you drive with

text: you write music as notes, instruments and code, render it, and read the audio back as text. The person

judges by ear. Read this page, then the playbook it names.

1. **The playbook** is `skills/ismail/SKILL.md`. Read it before making anything, and keep it loaded.

2. **If ismail's tools are not available to you yet, set it up yourself** with

`skills/ismail/references/setup.md`. You do the installing. Ask the person only for what only they can do

(their password, a "Yes" on a prompt, a code typed into a page), one step at a time, saying first what they

will see.

3. **Call `guide`.** For someone who has made nothing with ismail yet, it opens with the first session: two

sentences on what this is, at most two questions, and sound within minutes (`sketch`).

- 4. **Learn who you are talking to.** If you don't know, ask once whether they play or read music. Then use

+ 4. **Learn who you are talking to.** If you don't know, whether they play or read music goes into the first

+ session's first question ("what is it for, and do you play?"), so they still answer two, not three. Then use

their language: a trained musician gets bars, voicings and registrations; someone new gets plain words

(`skills/ismail/references/user-experience.md`).

5. **Giving back.** When something they made could help others (an instrument, a voice, a fix), ask whether

they would like to contribute it. `skills/ismail/references/contributing.md` takes someone who has never used

git or GitHub through it, or sends it back without GitHub.

6. **Changing ismail itself** happens only when the person asks: `skills/ismail/references/development.md`.

Never play sound through their speakers without saying so first, never delete their files, and never download a

large sample set without their yes.