From 844ed2b820f5a9e997b3fae99e2a620f87ca16eb Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Thu, 23 Jul 2026 04:20:57 +0000
Subject: [PATCH 1/2] docs: add CONTRIBUTING.md

Adds a standard open-source contributing guide to the repository as requested.
It covers:
- Setting up the dev environment
- Building locally
- Running tests
- Code style expectations
- PR process
- Reporting issues / security vulnerabilities
---
 CONTRIBUTING.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..f902366
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Contributing to coldkey
+
+First off, thank you for considering contributing to coldkey! It's people like you that make open-source software such a great community to learn, inspire, and create.
+
+We welcome all contributions, from bug reports and feature requests to code contributions and documentation improvements.
+
+## Setting Up Your Development Environment
+
+To work on coldkey, you will need:
+
+- **Go**: The project is written in Go. You'll need a recent version installed.
+- **Make**: We use `make` to manage build tasks.
+
+To get started:
+
+1. Fork the repository on GitHub.
+2. Clone your fork locally:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/coldkey.git
+   cd coldkey
+   ```
+3. Run the CI pipeline locally to ensure everything works:
+   ```bash
+   make ci
+   ```
+
+## Building Locally
+
+To build the `coldkey` binary locally, run:
+
+```bash
+make build
+```
+
+This will produce the `coldkey` binary in the root directory.
+
+## Running Tests
+
+Testing is a crucial part of the development process. To run the test suite, use:
+
+```bash
+make test
+```
+
+## Code Style Expectations
+
+We follow standard Go formatting conventions and use linters to maintain code quality. Before submitting your code, please ensure it complies with our standards:
+
+- **Formatting**: Run `make fmt` to format your code using `gofumpt`.
+- **Linting**: Run `make lint` to catch common issues using `golangci-lint`.
+- **Vetting**: Run `make vet` for standard Go static analysis.
+
+## Pull Request Process
+
+When you're ready to submit your changes:
+
+1. **Fork and Branch**: Create a new branch for your feature or bug fix (`git checkout -b my-new-feature`).
+2. **Commit Messages**: Write clear, concise, and descriptive commit messages.
+3. **Push**: Push your branch to your fork (`git push origin my-new-feature`).
+4. **Open a PR**: Open a Pull Request against the `main` branch of this repository. Provide a detailed description of your changes and reference any related issues.
+
+## Reporting Issues and Security Vulnerabilities
+
+- **Bug Reports & Feature Requests**: Please use the GitHub Issues tracker to report bugs or request features. Search existing issues first to avoid duplicates.
+- **Security Vulnerabilities**: If you discover a security vulnerability, please do NOT open a public issue. Instead, responsibly disclose it by contacting the project maintainers privately (e.g., via a GitHub security advisory or email if provided).
+
+Thank you again for your time and contributions!

From d74fb62d23dae0c91ca5a9566991b00daed9c2a4 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Thu, 23 Jul 2026 23:24:41 +0000
Subject: [PATCH 2/2] docs: update CONTRIBUTING.md to use justfile

Address PR review feedback to use just instead of make.
---
 CONTRIBUTING.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f902366..e2f03b8 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -9,7 +9,7 @@ We welcome all contributions, from bug reports and feature requests to code cont
 To work on coldkey, you will need:
 
 - **Go**: The project is written in Go. You'll need a recent version installed.
-- **Make**: We use `make` to manage build tasks.
+- **Make/Just**: We use [`just`](https://github.com/casey/just) (a modern `make` alternative) to manage build tasks.
 
 To get started:
 
@@ -21,7 +21,7 @@ To get started:
    ```
 3. Run the CI pipeline locally to ensure everything works:
    ```bash
-   make ci
+   just ci
    ```
 
 ## Building Locally
@@ -29,7 +29,7 @@ To get started:
 To build the `coldkey` binary locally, run:
 
 ```bash
-make build
+just build
 ```
 
 This will produce the `coldkey` binary in the root directory.
@@ -39,16 +39,16 @@ This will produce the `coldkey` binary in the root directory.
 Testing is a crucial part of the development process. To run the test suite, use:
 
 ```bash
-make test
+just test
 ```
 
 ## Code Style Expectations
 
 We follow standard Go formatting conventions and use linters to maintain code quality. Before submitting your code, please ensure it complies with our standards:
 
-- **Formatting**: Run `make fmt` to format your code using `gofumpt`.
-- **Linting**: Run `make lint` to catch common issues using `golangci-lint`.
-- **Vetting**: Run `make vet` for standard Go static analysis.
+- **Formatting**: Run `just fmt` to format your code using `gofumpt`.
+- **Linting**: Run `just lint` to catch common issues using `golangci-lint`.
+- **Vetting**: Run `just vet` for standard Go static analysis.
 
 ## Pull Request Process