AGENTS.md ยท diff
git:20261005.6cd0890 to git:20261006.3b622ea
7 added, 6 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, 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`).
+ 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.