sneak/prompts
1
0
Fork 0
Code Issues 6 Pull Requests 2 Actions Packages Projects Releases Wiki Activity

REPO_POLICIES: script/ entrypoints are the source of truth (closes #155)
check / check (push) Successful in 15s
Details

Browse Source 
The rule against invoking tools directly now names the script/ scripts
as the single source of truth and allows calling them directly. The
Makefile targets must still exist as thin shims. The one-package
go test exception is unchanged.

Model: opus-5-5
This commit is contained in:
sneak
2026-11-06 00:12:41 +00:00
parent 9389bf0172
commit 43814544ff
1 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
prompts/REPO_POLICIES.md
+6 -5
View File
@@ -1,6 +1,6 @@
--- ---
title: Repository Policies title: Repository Policies
last_modified: 2026-11-04 last_modified: 2026-11-06
--- ---
This document covers repository structure, tooling, and workflow standards. Code This document covers repository structure, tooling, and workflow standards. Code
@@ -199,14 +199,15 @@ style conventions are in separate documents:
README must document the provided scripts in an **Entrypoints** section (see README must document the provided scripts in an **Entrypoints** section (see
the README requirements below). the README requirements below).
- Always use Makefile targets (`make fmt`, `make test`, `make lint`, etc.) - Run the repo's own entrypoints, never the underlying tools directly. The
instead of invoking the underlying tools directly. The Makefile is the single `script/` scripts are the single source of truth for how each operation runs.
source of truth for how these operations are run. Calling them directly is fine, and so is calling the Makefile targets. The
Makefile targets must still exist, as the thin shims described above.
An agent whose work is confined to one package may run `go test` directly on An agent whose work is confined to one package may run `go test` directly on
that package's suite, or on individual tests in it, while iterating. This is that package's suite, or on individual tests in it, while iterating. This is
the only exception to this rule. `go build`, `go vet` and the linter still the only exception to this rule. `go build`, `go vet` and the linter still
go through make targets. A run while iterating is not a gate, so the full go through the entrypoints. A run while iterating is not a gate, so the full
`make check` is still required before every push. `make check` is still required before every push.
- The Makefile is authoritative documentation for how the repo is used. Beyond - The Makefile is authoritative documentation for how the repo is used. Beyond