docs: trim the agent guidance and drop the dead build-push reference #23

Merged

gravityfargo merged 2 commits from docs/trim-agents-guidance into main

2026-08-02 00:54:22 +00:00

gravityfargo commented

2026-08-02 00:49:59 +00:00

Owner

README.md

Removes the sentence pointing at .forgejo/workflows/build-push.yaml. No file of that name has ever existed in this repo under any extension — the working example it meant to cite is build-version.yml, which consumes the version output. Deleted rather than repointed, as asked; say the word if you'd rather it point at build-version.yml.

AGENTS.md

Cut from 92 lines to 49, keeping only what an agent cannot work out by reading the repo.

Removed — the Toolchain and Commands sections (a restatement of the Makefile), the per-workflow CI listing (derivable from .forgejo/workflows/), the renovate config location, and "use conventional commit messages".

Kept — the three template divergences and why each must survive a rebuild; the bump.yml gotchas (the on.workflow_call secrets: parser bug, --no-raise 3,21, the pin-backward rule, unfetchable 0-second run logs); the node-in-job-container constraint; the broken local cz shim.

Added — one line recording that a release run reports cancelled even when it succeeded, because the bump-version wrapper job is cancelled by the bump's own push. Confirmed on run 4237 (0.3.1, all three inner jobs green) and on run 3380 back in July, so it predates the template rebuild and will recur on every release.

docs: is inert, so merging cuts no release.

## README.md Removes the sentence pointing at `.forgejo/workflows/build-push.yaml`. No file of that name has ever existed in this repo under any extension — the working example it meant to cite is `build-version.yml`, which consumes the `version` output. Deleted rather than repointed, as asked; say the word if you'd rather it point at `build-version.yml`. ## AGENTS.md Cut from 92 lines to 49, keeping only what an agent cannot work out by reading the repo. **Removed** — the Toolchain and Commands sections (a restatement of the Makefile), the per-workflow CI listing (derivable from `.forgejo/workflows/`), the renovate config location, and "use conventional commit messages". **Kept** — the three template divergences and why each must survive a rebuild; the `bump.yml` gotchas (the `on.workflow_call` `secrets:` parser bug, `--no-raise 3,21`, the pin-backward rule, unfetchable 0-second run logs); the node-in-job-container constraint; the broken local `cz` shim. **Added** — one line recording that a release run reports `cancelled` even when it succeeded, because the `bump-version` wrapper job is cancelled by the bump's own push. Confirmed on run 4237 (`0.3.1`, all three inner jobs green) and on run 3380 back in July, so it predates the template rebuild and will recur on every release. `docs:` is inert, so merging cuts no release.

gravityfargo added 1 commit

2026-08-02 00:49:59 +00:00

docs: trim the agent guidance and drop the dead build-push reference

PR Bump Preview / Preview version bump (pull_request) Successful in 5s

Details

0b2167fa0e