AGENTS.md git:20261006.3b622eaA

Immutable. This exact content never changes and is served at /api/v1/blob/e4dea1d89983afcd.

# 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, and that
   block is the one opening: follow it, and ask nothing before it (a recording is welcome, never required). Two
   sentences on what this is, at most two questions ("what is it for, and do you play?", then a mood or a
   reference if they have one), and sound within minutes (`sketch`).
4. **Their first answer decides your words.** `guide(first_answer=<their words>)` says whether they are a musician
   (they named an instrument they play, a style they trained in, or reading music) or want plain words, and you
   keep to it from then on (`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.