vole
Clone
Read only, no credentials:
https://rodent.software/vole.git
Write over SSH with a registered key:
git clone ssh://git@rodent.software:2222/vole.git
A free and open-source forge that lives in your Git repo.
update readme and agents
75708127c031e40d026f165ee2de3b5fe219af9c · Keenan Nemetz · 2d ago · parent e73d453f
AGENTS.md +1−26
| @@ -1,11 +1,9 @@ | |||
| 1 | 1 | # Agent instructions | |
| 2 | 2 | ||
| 3 | This repository uses **Vole** as its forge, not GitHub. Read | ||
| 4 | [CONTRIBUTING.md](CONTRIBUTING.md) before writing; it is the canonical workflow. | ||
| 3 | This repository uses **Vole** as its forge. Read [CONTRIBUTING.md](CONTRIBUTING.md) before writing; it is the canonical workflow. | ||
| 5 | 4 | ||
| 6 | 5 | ## Non-negotiables | |
| 7 | 6 | ||
| 8 | - Do not use `gh`, the GitHub API, or GitHub issue/PR URLs. | ||
| 9 | 7 | - Discover before assuming: | |
| 10 | 8 | ||
| 11 | 9 | ```sh | |
| @@ -37,29 +35,6 @@ This repository uses **Vole** as its forge, not GitHub. Read | |||
| 37 | 35 | - If the CLI cannot do what is needed, ask rather than inventing a second | |
| 38 | 36 | workflow. | |
| 39 | 37 | ||
| 40 | ## Copy | ||
| 41 | |||
| 42 | Interface text is part of the product. Write it for someone who uses the project | ||
| 43 | but does not know how it is built. | ||
| 44 | |||
| 45 | - A page subtitle says what the page is for, in one sentence a newcomer could | ||
| 46 | repeat. It describes the user's goal, not the schema or the Git operations | ||
| 47 | behind it. | ||
| 48 | - Use the reader's words: *proposed update*, *review*, *merge*, *saved version*. | ||
| 49 | Avoid *base branch*, *head commit*, *land*, *ref*, *metadata branch*, and other | ||
| 50 | internal names unless the page is specifically about that concept and there is | ||
| 51 | no shorter phrase. | ||
| 52 | - Name the outcome, not the mechanism. "Proposed updates, reviewed before they | ||
| 53 | are merged" beats "Branches proposed for a base branch, with review and | ||
| 54 | approvals before they land." | ||
| 55 | - Labels stay labels; sentences stay sentences. A button says *New change*, not | ||
| 56 | *Create a change request document*. | ||
| 57 | - Read it aloud before committing. If it sounds like a commit message, a schema | ||
| 58 | comment, or an API error, rewrite it for the person looking at the screen. | ||
| 59 | |||
| 60 | The web UI calls a change request a **Change**. The formal documents in this | ||
| 61 | repository can keep the longer name for the concept. | ||
| 62 | |||
| 63 | 38 | ## Where to look | |
| 64 | 39 | ||
| 65 | 40 | - [CONTRIBUTING.md](CONTRIBUTING.md) — issue, change-request, review, CI, and | |