build: Migrate from Makefile to justfile (#500)

## Summary
- Replace Makefile with justfile for task running
- Update documentation to reference just commands

## Changes
- Add root justfile with all project tasks
- Add docs/justfile for documentation tasks
- Remove Makefile and docs/Makefile
- Update AGENTS.md/CLAUDE.md with just commands
- Update docs/*.md with just commands

Author: tony

.github/workflows/docs.yml

@@ -52,10 +52,14 @@ jobs:
         if: env.PUBLISH == 'true'
         run: uv sync --all-extras --dev
 
+      - name: Install just
+        if: env.PUBLISH == 'true'
+        uses: extractions/setup-just@v2
+
       - name: Build documentation
         if: env.PUBLISH == 'true'
         run: |
-          pushd docs; make SPHINXBUILD='uv run sphinx-build' html; popd
+          cd docs && just html
 
       - name: Configure AWS Credentials
         if: env.PUBLISH == 'true'

AGENTS.md

@@ -47,7 +47,7 @@ uv pip install --editable . -G dev
 
 ```bash
 # Run all tests
-make test
+just test
 # or directly with pytest
 uv run pytest
 
@@ -58,7 +58,7 @@ uv run pytest tests/sync/test_git.py
 uv run pytest tests/sync/test_git.py::test_remotes
 
 # Run tests with test watcher
-make start
+just start
 # or
 uv run ptw .
 ```
@@ -67,26 +67,26 @@ uv run ptw .
 
 ```bash
 # Run ruff for linting
-make ruff
+just ruff
 # or directly
 uv run ruff check .
 
 # Format code with ruff
-make ruff_format
+just ruff-format
 # or directly
 uv run ruff format .
 
 # Run ruff linting with auto-fixes
 uv run ruff check . --fix --show-fixes
 
 # Run mypy for type checking
-make mypy
+just mypy
 # or directly
 uv run mypy src tests
 
 # Watch mode for linting (using entr)
-make watch_ruff
-make watch_mypy
+just watch-ruff
+just watch-mypy
 ```
 
 ### Development Workflow
@@ -103,13 +103,13 @@ Follow this workflow for code changes:
 
 ```bash
 # Build documentation
-make build_docs
+just build-docs
 
 # Start documentation server with auto-reload
-make start_docs
+just start-docs
 
 # Update documentation CSS/JS
-make design_docs
+just design-docs
 ```
 
 ## Code Architecture

CHANGES

@@ -20,6 +20,13 @@ $ uv add libvcs --prerelease allow
 
 _Upcoming changes will be written here._
 
+### Development
+
+#### Makefile -> Justfile (#500)
+
+- Migrate from `Makefile` to `justfile` for running development tasks
+- Update documentation to reference `just` commands
+
 ### Documentation
 
 - Migrate docs deployment to AWS OIDC authentication and AWS CLI