Commit

Commits with conventional format suited for this repo.

Format

<type>(<scope>): <short description>

Scope is purely optional — only when truly required.

Types

Scopes (purely optional)

Subfolder names. Only use when truly needed for clarity.

Both lists evolve — check actual structure.

Rules

1. •Lowercase, no period at end
2. •Imperative mood ("add" not "added")
3. •Body optional — only when context needed
4. •Body format: bullet points, past tense, period at end
5. •Never add AI attribution (no "Co-Authored-By", "Generated with", etc.)

Examples

voice: add model reference for narrator
scripts: add upload samples script
ai: add commit skill
chore: restructure folders
docs: update README
infra: add dprint config

With body (when needed):

scripts(voice_cloning): update upload with transcript support

- Added companion .txt file reading.
- Added --enhance flag for audio enhancement.
- Updated error handling for missing API key.

Workflow

1. •

   git status — see what changed

2. •

   git diff — review changes

3. •

   Propose commits:

   • •If conversation discussed a specific topic → propose single commit for that topic only
   • •Otherwise → propose multiple commits, one per logical change
4. •

   Always preview — for each proposed commit show:

   code

   Commit 1:
     <message>
     git add <files>
   

   (repeat for each commit if multiple)

5. •

   Wait for user approval — never commit without explicit approval

6. •

   Execute approved commits

7. •

   Don't push unless asked