From ea17f18362062ab1129b5a69141f7a1d786d6ac5 Mon Sep 17 00:00:00 2001
From: Frank Odom <frank.odom.iii@gmail.com>
Date: Wed, 14 Jan 2026 16:21:08 -0500
Subject: [PATCH 1/3] Rework template repo for ruff/ty tooling; first draft of
 Gemini templatize workflow.

---
 .gemini/commands/templatize.toml          | 26 ++++++++++++++
 .github/FUNDING.yml                       |  5 ---
 .github/disabled-workflows/test-slow.yaml | 43 -----------------------
 .github/workflows/test.yaml               |  5 +--
 .gitignore                                |  1 +
 .pre-commit-config.yaml                   | 15 +++++---
 README.md                                 | 31 ++++++++--------
 pyproject.toml                            |  4 +--
 tests/conftest.py                         | 21 -----------
 9 files changed, 60 insertions(+), 91 deletions(-)
 create mode 100644 .gemini/commands/templatize.toml
 delete mode 100644 .github/FUNDING.yml
 delete mode 100644 .github/disabled-workflows/test-slow.yaml

diff --git a/.gemini/commands/templatize.toml b/.gemini/commands/templatize.toml
new file mode 100644
index 0000000..2d9f272
--- /dev/null
+++ b/.gemini/commands/templatize.toml
@@ -0,0 +1,26 @@
+description = "Templatize a new Python repo"
+prompt = """
+I want you to "templatize" a new Python repository (cloned from a GitHub repo template) by following these steps:
+
+1. Run the `templatize` script:
+    ```bash
+    ./templatize
+    ```
+    This updates placeholders like `{{REPO_NAME}}`, so everything is configured with my username, repo name, email, etc.
+2. Install the package, dev dependencies, and pre-commit hooks (see README).
+3. Use `pip list` or `uv pip list` to very which package versions were installed, and pin them in `pyproject.toml` for consistency.  Do not add any new packages to `pyproject.toml` -- just pin the ones that are already listed.
+4. Delete:
+    - this section of the README on templatization
+    - the `./templatize` script
+    - the `Templatize` step in `.github/workflows/test.yaml`
+    - the "templatize" slash-command file at `.gemini/commands/templatize.toml`
+5. Commit and push the changes.
+    ```bash
+    git add .
+    git commit -m "Templatize"
+    git push
+    ```
+    Type checking, linting, and formatting will run automatically on commit.  You may fix any issues and recommit as needed.
+
+Do not add any new files. Only modify or delete existing files.
+"""
\ No newline at end of file
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
deleted file mode 100644
index e1e6433..0000000
--- a/.github/FUNDING.yml
+++ /dev/null
@@ -1,5 +0,0 @@
-# These are supported funding model platforms
-
-github: [fkodom]
-custom: [fkodom.substack.com]
-# patreon: # Replace with a single Patreon username
diff --git a/.github/disabled-workflows/test-slow.yaml b/.github/disabled-workflows/test-slow.yaml
deleted file mode 100644
index 97a1474..0000000
--- a/.github/disabled-workflows/test-slow.yaml
+++ /dev/null
@@ -1,43 +0,0 @@
-name: Test Slow
-
-on:
-  workflow_dispatch: {}
-  pull_request:
-    types: [opened]
-
-jobs:
-  test:
-    name: Test
-    runs-on: ubuntu-latest
-    continue-on-error: true
-
-    strategy:
-      matrix:
-        python: ["3.10"]
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-        with:
-          python-version: ${{ matrix.python }}
-
-      - name: Templatize
-        # Templatize the repo before attempting to run tests.  (Tests will fail
-        # otherwise, due to syntax errors.)
-        # NOTE: Check if the 'templatize' script exists, so that this doesn't
-        # immediately fail for repos that have already run the script.
-        run: |
-          if test -f "templatize"; then
-              ./templatize
-          fi
-
-      - name: Install Package
-        run: |
-          uv pip install -e .[test]
-
-      - name: Test
-        run: |
-          uv run pytest --slow --cov --cov-report term-missing --cov-fail-under 80 tests/
diff --git a/.github/workflows/test.yaml b/.github/workflows/test.yaml
index 2913a60..30c4522 100644
--- a/.github/workflows/test.yaml
+++ b/.github/workflows/test.yaml
@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        python: ["3.10", "3.11", "3.12"]
+        python: ["3.11", "3.12"]
 
     steps:
       - name: Checkout
@@ -39,6 +39,7 @@ jobs:
 
       - name: Test
         run: |
+          uv run ruff format --check .
           uv run ruff check .
+          uv run ty check .
           uv run pytest --cov --cov-report term-missing --cov-fail-under 80 tests/
-          uv run mypy
diff --git a/.gitignore b/.gitignore
index 13f98a2..d2d6df2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 .vscode
+uv.lock
 worktrees/
 
 # Byte-compiled / optimized / DLL files
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 2255b1a..612acfc 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,16 +1,23 @@
 repos:
 - repo: local
   hooks:
-  - id: black
-    name: black
+  - id: ruff-format
+    name: ruff format
     stages: [pre-commit]
     language: system
-    entry: black
+    entry: ruff format
     types: [python]
 
-  - id: ruff
+  - id: ruff-check
     name: ruff check
     stages: [pre-commit]
     language: system
     entry: ruff check
     types: [python]
+
+  - id: ty-check
+    name: ty check
+    stages: [pre-commit]
+    language: system
+    entry: ty check
+    types: [python]
diff --git a/README.md b/README.md
index 95a4bac..ac6c1f1 100644
--- a/README.md
+++ b/README.md
@@ -6,29 +6,32 @@ A simple template for Python projects, with CI/CD configured through GitHub Acti
 ## Usage
 
 1. Create a new repository, using this one as a template.
-2. Run the `templatize` script:
+2. Install and open [Gemini CLI](https://github.com/google-gemini/gemini-cli), then run the `/templatize` command:
     ```bash
-    ./templatize
+    gemini run /templatize
     ```
 
-    This updates placeholders like `{{REPO_NAME}}`, so everything is configured with your username, repo name, email, etc.
-3. Commit and push the changes.
-    ```bash
-    git add .
-    git commit -m "Templatize"
-    git push
-    ```
-4. (Probably) delete this section of the README.
 
 ## Install
 
+> **Note:** For simplicity, I assume you are using [uv](https://docs.astral.sh/uv/getting-started/installation/), but this project is compatible with any virtual environment or package manager (`pip`, `venv`, `poetry`, `pipenv`, `conda`).
+
+If you have not already, create and activate a virtual environment for this project:
+```bash
+uv venv --python 3.12
+source .venv/bin/activate
+```
+
+Then, install the package:
 ```bash
-pip install "{{REPO_NAME}} @ git+ssh://git@github.com/{{REPO_OWNER}}/{{REPO_NAME}}.git"
+uv sync
+```
 
-# Install all dev dependencies (tests etc.)
-pip install "{{REPO_NAME}}[test] @ git+ssh://git@github.com/{{REPO_OWNER}}/{{REPO_NAME}}.git"
+### For Developers
 
-# Setup pre-commit hooks
+If you plan to contribute to the project, you should also install development dependencies and pre-commit hoooks:
+```bash
+uv sync --all-extras
 pre-commit install
 ```
 
diff --git a/pyproject.toml b/pyproject.toml
index c36ae85..ef44f6e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -10,7 +10,7 @@ description = "{{REPO_NAME}}"
 license = {text = "MIT"}
 dynamic = ["version", "readme"]  # NOTE: Must be in sync with [tool.setuptools.dynamic] below
 dependencies = []
-requires-python = ">=3.8"
+requires-python = ">=3.11"
 classifiers = ["Programming Language :: Python :: 3"]
 
 [tool.setuptools.dynamic]
@@ -24,12 +24,12 @@ exclude = ["tests"]
 # extra packages (e.g. pip install .[test])
 [project.optional-dependencies]
 test = [
-    "black",
     "mypy",
     "pre-commit",
     "pytest",
     "pytest-cov",
     "ruff",
+    "ty",
 ]
 
 
diff --git a/tests/conftest.py b/tests/conftest.py
index cf3859b..e69de29 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,21 +0,0 @@
-import pytest
-
-
-def pytest_addoption(parser):
-    parser.addoption("--slow", action="store_true")
-
-
-def pytest_configure(config):
-    config.addinivalue_line("markers", "slow: slow to run")
-
-
-def pytest_collection_modifyitems(config, items):
-    run_slow = config.getoption("--slow")
-    skip_fast = pytest.mark.skip(reason="remove --slow option to run")
-    skip_slow = pytest.mark.skip(reason="need --slow option to run")
-
-    for item in items:
-        if ("slow" in item.keywords) and (not run_slow):
-            item.add_marker(skip_slow)
-        if ("slow" not in item.keywords) and (run_slow):
-            item.add_marker(skip_fast)

From 8869093b892f6bdfcf8e1c0742990d66acf90fca Mon Sep 17 00:00:00 2001
From: Frank Odom <frank.odom.iii@gmail.com>
Date: Wed, 14 Jan 2026 16:31:57 -0500
Subject: [PATCH 2/3] Update README and templatize script

---
 .gemini/commands/templatize.toml |  5 +++--
 README.md                        | 19 ++++---------------
 2 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/.gemini/commands/templatize.toml b/.gemini/commands/templatize.toml
index 2d9f272..99cb87c 100644
--- a/.gemini/commands/templatize.toml
+++ b/.gemini/commands/templatize.toml
@@ -10,11 +10,12 @@ I want you to "templatize" a new Python repository (cloned from a GitHub repo te
 2. Install the package, dev dependencies, and pre-commit hooks (see README).
 3. Use `pip list` or `uv pip list` to very which package versions were installed, and pin them in `pyproject.toml` for consistency.  Do not add any new packages to `pyproject.toml` -- just pin the ones that are already listed.
 4. Delete:
-    - this section of the README on templatization
+    - the "usage" section of the README on templatization
     - the `./templatize` script
     - the `Templatize` step in `.github/workflows/test.yaml`
     - the "templatize" slash-command file at `.gemini/commands/templatize.toml`
-5. Commit and push the changes.
+5. Update the README to give a brief description of the project.  If you are unable to infer the description based on the repo, please ask me for more details.
+6. Commit and push the changes.
     ```bash
     git add .
     git commit -m "Templatize"
diff --git a/README.md b/README.md
index ac6c1f1..1daa861 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # {{REPO_NAME}}
 
-A simple template for Python projects, with CI/CD configured through GitHub Actions.  Compatible with any virtual environment manager (e.g. `uv`, `venv`, `pyenv`, `poetry`, `conda`).
+A simple template for Python projects, with CI/CD configured through GitHub Actions.
 
 
 ## Usage
@@ -16,21 +16,12 @@ A simple template for Python projects, with CI/CD configured through GitHub Acti
 
 > **Note:** For simplicity, I assume you are using [uv](https://docs.astral.sh/uv/getting-started/installation/), but this project is compatible with any virtual environment or package manager (`pip`, `venv`, `poetry`, `pipenv`, `conda`).
 
-If you have not already, create and activate a virtual environment for this project:
 ```bash
+# Create and activate a new virtual environment
 uv venv --python 3.12
 source .venv/bin/activate
-```
-
-Then, install the package:
-```bash
-uv sync
-```
-
-### For Developers
 
-If you plan to contribute to the project, you should also install development dependencies and pre-commit hoooks:
-```bash
+# Install development dependencies and pre-commit hoooks
 uv sync --all-extras
 pre-commit install
 ```
@@ -40,11 +31,9 @@ pre-commit install
 
 | Tool | Description | Runs on |
 | --- | --- | --- |
-| [black](https://github.com/psf/black) | Code formatter | - `git commit` (through `pre-commit`) <br> - `git push` <br> - pull requests |
 | [ruff](https://github.com/astral-sh/ruff) | Code linter | - `git commit` (through `pre-commit`) <br> - `git push` <br> - pull requests |
+| [ty](https://docs.astral.sh/ty/) | Static type checker | - `git commit` <br> - pull requests |
 | [pytest](https://github.com/pytest-dev/pytest) | Unit testing framework | - `git push` <br> - pull requests |
-| [mypy](https://github.com/python/mypy) | Static type checker | - `git push` <br> - pull requests |
-| [pre-commit](https://github.com/pre-commit/pre-commit) | Pre-commit hooks | - `git commit` |
 | [twine](https://github.com/pypa/twine) $\dagger$ | PyPI package uploader | - New release (`git tag`) |
 
 > $\dagger$ Requires enabling the `publish.yaml` workflow.  To activate, move the file from `.github/disabled-workflows/publish.yaml.disabled` to `.github/workflows/publish.yaml`, and set a valid PyPI token as `PYPI_API_TOKEN` in the repo secrets.

From 2ca4ffdd3c502321816c39ba91153914695a87e6 Mon Sep 17 00:00:00 2001
From: Frank Odom <frank.odom.iii@gmail.com>
Date: Wed, 14 Jan 2026 16:38:30 -0500
Subject: [PATCH 3/3] Fix one small hiccup with /templatize command

---
 .gemini/commands/templatize.toml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gemini/commands/templatize.toml b/.gemini/commands/templatize.toml
index 99cb87c..4fe2537 100644
--- a/.gemini/commands/templatize.toml
+++ b/.gemini/commands/templatize.toml
@@ -17,6 +17,8 @@ I want you to "templatize" a new Python repository (cloned from a GitHub repo te
 5. Update the README to give a brief description of the project.  If you are unable to infer the description based on the repo, please ask me for more details.
 6. Commit and push the changes.
     ```bash
+    # you'll need to re-activate the virtual environment here
+    source .venv/bin/activate
     git add .
     git commit -m "Templatize"
     git push