AGENTS.md — vllmScripts Agent Rules

Git Workflow

This project manages deployment scripts for vLLM and llama.cpp servers on dankserver and dankclaw.

All script edits must flow through git. Do not edit files on the remote machine directly.

Source the script from the target machine — fetch it from the server where it runs
Place it in this repo — commit the fetched version
Edit here — make all changes locally in the working tree
Commit and push — push to origin (Gitea on dankclaw)
Pull on the target — git pull on the remote machine before restarting
Restart the service — use the updated script on the target

Direct edits on the remote drift from version control. Future agents will not know what changed. Git is the single source of truth.

User request → Fetch script from remote → Commit here → Edit → Commit → Push → Pull on remote → Restart

Context	Action
Editing a deployment script	Work through git — fetch, commit, edit, push, pull, restart. Never edit on the remote directly.
Script exists only on remote	Pull it into the repo first — commit the fetched version before making changes.
Unstaged local changes	Commit or discard — check `git status` before starting work. Ask the user if unsure.
Tests exist	Run them — verify tests pass after every change. Do not commit failing tests.