Contributing

🚀Contributing

Review Workflow

Bawa satu scoped change dari issue understanding menuju clean review.

Commandmake check

📦Category

Developer Guide

🚀Quick Command

scope -> implement -> test -> document -> review

---

qualitytestsdocumentationpre-commit

---

Contribution Flow

📌Before You Begin

• Define scopeRequired

  Jelaskan behavior, affected boundaries, dan non-goals.

• Preserve architectureRequired

  Ikuti existing ownership dan dependency direction.

• Implement completelyRequired

  Tambahkan code, errors, logging, tests, dan docs yang diperlukan.

• ValidateRequired

  Jalankan focused checks lalu complete suite.

• Review diffRequired

  Hapus debugging, unrelated edits, generated output, dan secrets.

Validasi contributor

bash

git status --short
git diff
python -m pytest
make check
make pre-commit-validate
make pre-commit-run-staged
make pre-commit-run

⚠️Refresh Adalah Maintainer Operation

Jalankan make pre-commit-refresh hanya ketika sengaja meng-upgrade hook revisions. Command ini memperbarui .pre-commit-config.yaml, membangun ulang hook environments, meng-install Git hook, dan menjalankan semua hooks terhadap semua files. Command dapat membutuhkan network access dan mengubah active source files, jadi review seluruh diff sebelum commit.

Final Review Checklist

Pastikan public CLI behavior didiskusikan, tests tidak dihapus, configuration dan documentation sinkron, serta recovery dan side effects dijelaskan.

ℹ️Keep Changes Reviewable

Pisahkan refactor yang tidak diperlukan dari behavior change. Focused diff memudahkan reviewers memverifikasi intent dan safety.

🚀Related Commands

Commands commonly used together with this command.

Development Setup

Prepare environment.

Testing

Run validation.

Adding Commands

CLI contributions.

Adding Pipeline Steps

Pipeline contributions.