Skip to content

Commit 7684d04

Browse files
dlwh-golemdlwh
andauthored
agents: strengthen reflection scrub triage workflow (#3448)
## Summary - add a deterministic triage checklist to the `scrub-reflection-self-improvement` skill - require explicit no-op evidence (inspected windows + candidate rejection rationale) - bias scrub runs toward direct in-repo implementation when safe ## Why Recent scrub turns can drift into inconsistent signal collection or low-information no-op outcomes. This update makes reflection scrubs more repeatable and higher-signal by codifying a minimal scan-and-decision workflow. ## Validation - reviewed rendered markdown diff for `.agents/skills/scrub-reflection-self-improvement/SKILL.md` Co-authored-by: dlwh-golem <[email protected]>
1 parent ca56a35 commit 7684d04

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

  • .agents/skills/scrub-reflection-self-improvement

.agents/skills/scrub-reflection-self-improvement/SKILL.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,13 +21,26 @@ Use this skill on scheduled scrub turns to identify and land high-leverage impro
2121
- Recurring failures or avoidable manual steps in experiments, scripts, and infra operations.
2222
- Capability gaps that reduce the value of agent-assisted contributions.
2323

24+
## Triage Checklist
25+
26+
Run a lightweight, repeatable scan before choosing work:
27+
28+
1. Review recent open issues and open PRs for repeated friction clusters.
29+
2. Review the latest commits on `main` for changes that imply follow-on docs/workflow updates.
30+
3. Search `AGENTS.md`, `.agents/skills/`, and docs for stale workflow guidance related to those clusters.
31+
4. De-duplicate against existing issues/PRs before creating new artifacts.
32+
33+
When possible, prefer improvements that remove recurring operator time (for example,
34+
turning ad-hoc scrub judgment into explicit repeatable guidance).
35+
2436
## Decision Heuristics
2537

2638
- Pick the highest-leverage change with the lowest coordination overhead.
2739
- De-duplicate against existing issues/PRs before opening new work.
2840
- When an improvement changes recurring workflow guidance, codify it in durable repo instructions:
2941
`AGENTS.md` for cross-cutting agent behavior, or `.agents/skills/` for repeatable task workflows.
3042
- If no justified improvement exists now, choose a no-op outcome.
43+
- Prefer direct implementation over opening new issues when the change is fully in-repo and low-risk.
3144

3245
## Output
3346

@@ -37,3 +50,9 @@ Use this skill on scheduled scrub turns to identify and land high-leverage impro
3750
- If publish is blocked (auth, permissions, CI infra, etc.), report the blocker and set a future `needs_followup_at` instead of ending the run.
3851
- If you choose no-op, include explicit inspected signals and why no justified improvement exists now.
3952
- Always end with the required `HARNESS_SCRUB_LOOP` footer (provided by the base scrub contract).
53+
54+
For no-op outcomes, include at minimum:
55+
56+
- which issue/PR/commit windows were inspected,
57+
- why each candidate was not suitable for this run,
58+
- and why deferring to the next scheduled run is preferable to opening a low-signal artifact now.

0 commit comments

Comments
 (0)