Add the forge-groom skill #51

Merged
vnprc merged 2 commits from agent/forge-groom-skill into master 2026-09-09 23:46:19 +01:00
Member

Adds the forge-groom skill: the behavioural contract for a weekly tracker triage that any harness can run by hand and a timer will run unattended, plus its index entries in the README.
Nothing changes for a running machine; this is memory prose, and no timer exists yet.
The skill's action table is the whole autonomy boundary: close only on a merged Closes, set five named labels, write one plain-text report; everything else is forbidden, and Refs is reported rather than closed on because memory reserves it for non-final PRs.
Also retires the flake-status --upstream gotcha in allod.md, which described the bug fixed by allod/tools#177, replacing it with the current behaviour.
What proves it: the plan's slice 1 witness is a by-hand run of this skill over allod/tools reproducing the 2026-09-09 manual pass; that run happens after this merges.
If it is wrong, revert; nothing reads the skill yet.

Refs allod/strategy#48

The plan that schedules the rest (the forge pr list -s flag in tools, the archetypes timer and msmtp module, the private enablement) is allod/strategy dev-plans/forge-groom.md, opened alongside this PR.

Risk

R1. Prose only. The one behavioural risk is a future runner misreading the action table; the table is positive and enumerable for that reason, and the timer will additionally hold a token that cannot push or merge.

Validation

  • Skill frontmatter has name and description in the Agent Skills format that fleet-diff uses.
  • README layout and "Available skills" list both name the new skill.
  • allod.md line for flake-status matches the merged behaviour in allod/tools#177.
Adds the `forge-groom` skill: the behavioural contract for a weekly tracker triage that any harness can run by hand and a timer will run unattended, plus its index entries in the README. Nothing changes for a running machine; this is memory prose, and no timer exists yet. The skill's action table is the whole autonomy boundary: close only on a merged `Closes`, set five named labels, write one plain-text report; everything else is forbidden, and `Refs` is reported rather than closed on because memory reserves it for non-final PRs. Also retires the `flake-status --upstream` gotcha in `allod.md`, which described the bug fixed by allod/tools#177, replacing it with the current behaviour. What proves it: the plan's slice 1 witness is a by-hand run of this skill over allod/tools reproducing the 2026-09-09 manual pass; that run happens after this merges. If it is wrong, revert; nothing reads the skill yet. Refs allod/strategy#48 The plan that schedules the rest (the `forge pr list -s` flag in tools, the archetypes timer and msmtp module, the private enablement) is `allod/strategy` `dev-plans/forge-groom.md`, opened alongside this PR. ## Risk R1. Prose only. The one behavioural risk is a future runner misreading the action table; the table is positive and enumerable for that reason, and the timer will additionally hold a token that cannot push or merge. ## Validation - Skill frontmatter has `name` and `description` in the Agent Skills format that `fleet-diff` uses. - README layout and "Available skills" list both name the new skill. - `allod.md` line for `flake-status` matches the merged behaviour in allod/tools#177.
The skill is the behavioural contract for a weekly tracker triage that
any harness runs by hand and a timer runs unattended: close only on a
merged Closes, set five named labels, write one plain-text report, and
nothing else. Refs is reported, never closed on.

allod.md described the flake-status --upstream default-branch bug that
allod/tools PR 177 fixed; it now states the current behaviour.

Refs allod/strategy#48
The first commit indexed the skill but record stages tracked files only,
so the new directory was left out. Refs allod/strategy#48
vnprc approved these changes 2026-09-09 23:46:13 +01:00
vnprc merged commit c57b654853 into master 2026-09-09 23:46:19 +01:00
vnprc deleted branch agent/forge-groom-skill 2026-09-09 23:46:19 +01:00
Sign in to join this conversation.
No description provided.