8.8 KiB
Commit conventions / Соглашения по коммитам / コミット規約
Sections below: English, Русский, 日本語. Prefix tokens are always in English; only the descriptions are localized.
English
Format: [prefix] description or [prefix:scope] description.
Keep it a concise summary. The scope is optional and names an instrument or
section, e.g. [mix:vox], [track:gtr].
Prefixes
| Prefix | When to use | Example |
|---|---|---|
sketch |
Early phase: composition, arrangement and mix are still intertwined | [sketch] Rough verse and chorus, draft balance |
comp |
Material: melody, harmony, structure | [comp] Rewrite the bridge, drop the pre-chorus |
arr |
Arrangement, instrumentation | [arr] Add string pad to the chorus |
track |
Recording live audio | [track:gtr] Solo guitar (Artem), 3 takes |
midi |
MIDI and virtual instruments | [midi] Verse drums, fix the groove |
edit |
Processing recordings: comping, timing, tuning, cleanup | [edit:vox] Comp the lead, clean up breaths |
mix |
Mixing | [mix:vox] De-esser on lead, +1.5 dB in chorus |
master |
Mastering (the process) | [master] Limiter, target -9 LUFS |
export |
Emitting files into Out/ (audio, PDF) | [export] Master v1, instrumental, stems |
score |
Notation source (.mscz) | [score] Solo guitar part, clean copy |
asset |
Non-audio resources: presets, FX chains, cover art | [asset] Cover v2, master-bus preset |
docs |
Documentation, README | [docs] Update the description |
chore |
Repo plumbing: structure, gitignore/gitattributes, LFS | [chore] Track .mscz with LFS |
fix |
Fixes: bad take, clipping, wrong file, revert | [fix] Remove clipping at 2:13, re-export stem |
Core day-to-day flow: sketch -> comp/arr -> track/midi/edit -> mix -> master -> export.
Rarely used: fix, chore, asset.
Русский
Формат: [префикс] описание или [префикс:scope] описание.
Краткое, конкретное описание. Скоуп необязателен — это инструмент или секция,
например [mix:vox], [track:gtr].
Префиксы
| Префикс | Когда применять | Пример |
|---|---|---|
sketch |
Ранний этап: композиция, аранжировка и микс ещё нераздельны | [sketch] Набросок куплета и припева, грубый баланс |
comp |
Материал: мелодия, гармония, структура | [comp] Переписал бридж, убрал предприпев |
arr |
Аранжировка, инструментовка | [arr] Подклад струнных в припев |
track |
Запись живого аудио | [track:gtr] Соло-гитара (Артём), 3 дубля |
midi |
MIDI и виртуальные инструменты | [midi] Барабаны куплета, поправил грув |
edit |
Обработка записи: компинг, тайминг, тюнинг, чистка | [edit:vox] Компинг лида, чистка дыханий |
mix |
Сведение | [mix:vox] Де-эссер на лиде, +1.5 dB в припеве |
master |
Мастеринг (процесс) | [master] Лимитер, целевой -9 LUFS |
export |
Выпуск файлов в Out/ (аудио, PDF) | [export] Мастер v1, инструментал, стемы |
score |
Ноты (исходник .mscz) | [score] Партия соло-гитары набело |
asset |
Не-аудио: пресеты, FX-цепи, обложка | [asset] Обложка v2, пресет мастер-шины |
docs |
Документация, README | [docs] Обновил описание |
chore |
Обвязка репозитория: структура, gitignore/gitattributes, LFS | [chore] .mscz в LFS |
fix |
Исправления: плохой дубль, клиппинг, не тот файл, откат | [fix] Убрал клиппинг в 2:13, перезалил стем |
Ядро повседневного потока: sketch -> comp/arr -> track/midi/edit -> mix -> master -> export.
Редко: fix, chore, asset.
日本語
形式:[プレフィックス] 説明 または [プレフィックス:scope] 説明。
説明は簡潔に要点をまとめる。スコープは任意で、楽器またはセクションを指す
(例:[mix:vox]、[track:gtr])。プレフィックスは常に英字。
プレフィックス
| プレフィックス | 用途 | 例 |
|---|---|---|
sketch |
初期段階:作曲・アレンジ・ミックスがまだ一体 | [sketch] Aメロとサビのラフ、仮バランス |
comp |
素材:メロディ、ハーモニー、構成 | [comp] ブリッジを書き直し、Bメロを削除 |
arr |
アレンジ、楽器編成 | [arr] サビにストリングスパッドを追加 |
track |
生音の録音 | [track:gtr] ギターソロ(Artem)、3テイク |
midi |
MIDI・ソフト音源 | [midi] Aメロのドラム、グルーヴを修正 |
edit |
録音の処理:コンピング、タイミング、ピッチ補正、整理 | [edit:vox] リードのコンピング、ブレスを整理 |
mix |
ミックス | [mix:vox] リードにディエッサー、サビで +1.5 dB |
master |
マスタリング(作業) | [master] リミッター、目標 -9 LUFS |
export |
Out/ へのファイル書き出し(オーディオ、PDF) | [export] マスター v1、インスト、ステム |
score |
楽譜のソース(.mscz) | [score] ギターソロのパート譜を清書 |
asset |
非オーディオ:プリセット、エフェクトチェイン、ジャケット | [asset] ジャケット v2、マスターバスのプリセット |
docs |
ドキュメント、README | [docs] 説明を更新 |
chore |
リポジトリの整備:構成、gitignore/gitattributes、LFS | [chore] .mscz を LFS で管理 |
fix |
修正:不良テイク、クリッピング、ファイル違い、取り消し | [fix] 2:13 のクリッピングを除去、ステムを再書き出し |
日常の基本フロー:sketch -> comp/arr -> track/midi/edit -> mix -> master -> export。
まれに使用:fix、chore、asset。