m4l-project
Skill2 starsChanged 19 days agoMITView on GitHub
Max for Liveデバイス、`.maxpat` / `.amxd`、Max JS、MIDI/Audio I/O、Presentation UI、Ableton User Libraryへのインストール、リリース梱包を追加・変更するときに参照する。細分化されたM4L知識を実務向けに統合し、生成元・生成物・検証・Freeze/Export上の注意を一つの判断軸にまとめる。
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- analyticsSkill
- api-designSkill
- commit-and-gitSkill
- conventionsSkill
- cursor-hook-authoringSkill
- data-migrationSkill
- dbSkill
- e2e-testingSkill
- e2etestSkill
- errorpageSkill
- githubSkill
- google-analyticsSkill
- honoSkill
- issue-branch-pr-flowSkill
- japaneseSkill
- japanese-writingSkill
- knowledge-elicitationSkill
- refresh-skillsSkill
- skill-escalationSkill
- skill-selectionSkill
- turborepoSkill
- typescript-monorepoSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
23 rules. About 0 are common, 8 are distinctive, and 15 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
15
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 13
MUST: デバイスごとに packages/<device>/ を作り、少なくとも devices/, scripts/, assets/, releases/, DESIGN.md, VERSION, LICENSE の責務を分ける。
- Very specific: line 14
MUST: UI寸法、色、余白、表示ロジック、MIDI仕様、同期仕様を変えたら packages/<device>/DESIGN.md に記録する。
- Distinctive: line 15
SHOULD: Max patcher JSONは構造化データとして扱い、文字列置換で編集しない。
- Very specific: line 21
MUST: MIDI Effectは midiin / notein から入力し、midiout / noteout へ出力する。
- Very specific: line 22
MUST: Audio Effect / Instrument / MIDI Effect のデバイスタイプを決めてから、I/Oと .amxd typeを合わせる。
- Very specific: line 23
MUST: MIDI Effectの .amxd は FOURCC mmmm と project.amxdtype = 1835887981 を持つ。
- Very specific: line 25
MUST: visible UI object は presentation: 1 と整数 presentation_rect を持つ。
- Very specific: line 31
MUST: Max for Liveデバイスの高さは 169px 固定として設計する。
- Distinctive: line 32
MUST: UIを変更したら、Presentation boundsを機械的に検査する。
- Very specific: line 34
SHOULD: live.* UIはLiveテーマとの整合性を優先し、必要以上に色を上書きしない。
- Distinctive: line 40
MUST: Note OnとNote Offの対応を崩さない。
- Distinctive: line 44
SHOULD: Max JSの関数名はMaxメッセージ名との対応が分かるようにする。
- Very specific: line 45
SHOULD: JS Task は低優先度イベントであることを前提にし、Freeze/Exportで厳密なMIDIタイミングが必要な処理には慎重に使う。
- Very specific: line 49
MUST: Live API (live.object, live.observer, LiveAPI) を発音クロックとして使わない。Live APIは低優先度・非同期で、Freeze/Export中のタイミング源として信頼しない。
- Distinctive: line 50
SHOULD: Transport同期が必要な場合は、Maxのtransport/tempo-relative clockなど、Live transportに同期するMax側の仕組みを使う。
- Distinctive: line 51
MUST: 重い処理でscheduler tickが飛んだとき、過去イベントを現在時刻にまとめて発音するcatch-up実装にしない。遅れた過去音は捨てるか、明示した別モードにする。
- Distinctive: line 52
MUST: 同じtransport位置・同じdegree・同じtickが複数回来ても、同じイベントを再発音しない。
- Very specific: line 53
SHOULD: Freeze/Exportで問題が出る場合は、JS内の発音スケジューリングよりもMax標準オブジェクト (makenote, pipe, flush, midiformat など) へ逃がすことを検討する。
- Very specific: line 57
MUST: .amxd のバイナリ容器を書き出す場合は、生成後に最低限、期待する .maxpat / JS / 画像名が含まれていることを検査する。
- Very specific: line 59
MUST: リリース成果物には VERSION, LICENSE, .amxd, .maxpat, JS、参照画像を含める。
- Very specific: line 60
SHOULD: Ableton User Libraryへインストールする場合、古い同名ファイルを削除してから新しい .amxd をコピーする。
- Very specific: line 67
SHOULD: 生成後に .maxpat のPresentation boundsとpatchline endpointを検査する。
- Distinctive: line 69
SHOULD: Liveでの挙動確認が必要な場合は、Max Console / Open Max Windowのエラー有無を確認する。
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
M4L Project
このスキルは、Max for LiveデバイスをLLMが作るときに必要な実務ルールだけを残した統合スキルである。網羅的なリファレンスではなく、壊れやすい判断を避けるためのチェックリストとして使う。
基本方針
- MUST: 生成スクリプトを正本として扱う。
.maxpat/.amxdは生成物であり、直接編集した場合も必ず生成スクリプトへ反映する。 - MUST: デバイスごとに
packages/<device>/を作り、少なくともdevices/,scripts/,assets/,releases/,DESIGN.md,VERSION,LICENSEの責務を分ける。 - MUST: UI寸法、色、余白、表示ロジック、MIDI仕様、同期仕様を変えたら
packages/<device>/DESIGN.mdに記録する。 - SHOULD: Max patcher JSONは構造化データとして扱い、文字列置換で編集しない。
- NEVER:
.amxdを.maxpatのリネームで作らない。 - NEVER: 生成物だけを直して、生成元と乖離させない。
Max for Live生成
- MUST: MIDI Effectは
midiin/noteinから入力し、midiout/noteoutへ出力する。 - MUST: Audio Effect / Instrument / MIDI Effect のデバイスタイプを決めてから、I/Oと
.amxdtypeを合わせる。 - MUST: MIDI Effectの
.amxdは FOURCCmmmmとproject.amxdtype = 1835887981を持つ。 - MUST:
.maxpatはopeninpresentation: 1を持つ。 - MUST: visible UI object は
presentation: 1と整数presentation_rectを持つ。 - MUST: 全visible UI objectは
x + w <= devicewidthかつy + h <= 169を満たす。 - SHOULD: 画像、JS、外部依存を使う
.amxdは単体ロードできるように依存ファイルを同梱する。
UI / Presentation
- MUST: Max for Liveデバイスの高さは
169px固定として設計する。 - MUST: UIを変更したら、Presentation boundsを機械的に検査する。
- MUST: 背景panelを使う場合は、操作UIを覆わない重なり順にする。
- SHOULD:
live.*UIはLiveテーマとの整合性を優先し、必要以上に色を上書きしない。 - SHOULD: 固定サイズの入力欄、アイコン、キャンバス、ロゴは安定した
presentation_rectを持たせ、値変更でレイアウトが動かないようにする。
JS / MIDIロジック
- MUST: 表示上のドット判定と発音判定は同じ関数、または同じデータから導出する。
- MUST: Note OnとNote Offの対応を崩さない。
- MUST: 入力MIDIを使う仕様では、入力が無いときに勝手にフォールバック音を鳴らさない。
- MUST: Randomの対象は仕様で明示された値だけに限定する。
- MUST: 「ヒットした瞬間だけ鳴る」仕様では、同じヒット範囲内にいる間に再発音しないエッジ判定を入れる。
- SHOULD: Max JSの関数名はMaxメッセージ名との対応が分かるようにする。
- SHOULD: JS
Taskは低優先度イベントであることを前提にし、Freeze/Exportで厳密なMIDIタイミングが必要な処理には慎重に使う。
Transport / Freeze / Export
- MUST: Live API (
live.object,live.observer,LiveAPI) を発音クロックとして使わない。Live APIは低優先度・非同期で、Freeze/Export中のタイミング源として信頼しない。 - SHOULD: Transport同期が必要な場合は、Maxのtransport/tempo-relative clockなど、Live transportに同期するMax側の仕組みを使う。
- MUST: 重い処理でscheduler tickが飛んだとき、過去イベントを現在時刻にまとめて発音するcatch-up実装にしない。遅れた過去音は捨てるか、明示した別モードにする。
- MUST: 同じtransport位置・同じdegree・同じtickが複数回来ても、同じイベントを再発音しない。
- SHOULD: Freeze/Exportで問題が出る場合は、JS内の発音スケジューリングよりもMax標準オブジェクト (
makenote,pipe,flush,midiformatなど) へ逃がすことを検討する。
AMXD / Packaging
- MUST:
.amxdのバイナリ容器を書き出す場合は、生成後に最低限、期待する.maxpat/ JS / 画像名が含まれていることを検査する。 - MUST: 依存ファイルの
dependency_cacheは配布環境で解決できるパスにする。ローカル絶対パスへ依存させない。 - MUST: リリース成果物には
VERSION,LICENSE,.amxd,.maxpat, JS、参照画像を含める。 - SHOULD: Ableton User Libraryへインストールする場合、古い同名ファイルを削除してから新しい
.amxdをコピーする。 - MUST: ユーザーへ最終報告するとき、既存Liveインスタンスの挿し直しが必要なら明記する。
検証
- MUST: JS変更後は
node --check <device>.jsを実行する。 - SHOULD: Python生成スクリプト変更後は
python3 -m py_compile <script>.pyを実行する。 - SHOULD: 生成後に
.maxpatのPresentation boundsとpatchline endpointを検査する。 - SHOULD:
.amxd生成後に、デバイスタイプ、同梱依存、主要JS文字列が入っていることを検査する。 - SHOULD: Liveでの挙動確認が必要な場合は、Max Console / Open Max Windowのエラー有無を確認する。
削減した旧スキルの扱い
旧構成では、overview、maxpat format、amxd conversion、presentation layout、live api、javascript、gen、debugging、py2maxを別skillに分けていた。しかし実作業では、必要な判断が分断され、Live APIをクロックに使うなど局所知識に引っ張られるリスクがあった。
今後はこの統合スキルを入口にし、詳細な公式ドキュメントや既存実装は必要になった時点で個別に確認する。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

