Skip to content

Put the adoption rules where agents look first - #9

Merged
PavlosIsaris merged 1 commit into
mainfrom
agent-findings
Oct 1, 2026
Merged

PavlosIsaris merged 1 commit into
mainfrom
agent-findings

Conversation

@PavlosIsaris

Copy link
Copy Markdown
Contributor

A fresh Claude Code agent (Haiku) was asked to adopt the shared workflows in volunteering-matching-platform, read-only. It read the workflow files and the guide through the API, but not AGENTS.md. It then:

  • pinned @v0.1.4 because the release list shows it as Latest,
  • wrote the caller file from scratch (on: push only, no concurrency),
  • planned to delete dependabot_auto_merge.yml,
  • changed php-extensions without reading phpunit.xml.

This change puts five rules where the agent looked: at the top of the guide and in the header of each workflow file. AGENTS.md has the same rules. The repository description and all release notes now also say to use the short tag @v0.1.

A fresh agent asked to adopt the workflows read the workflow files and
the guide, not AGENTS.md. It pinned @v0.1.4, wrote the caller from
scratch, planned to delete an unrelated workflow and guessed inputs.

- Guide: five rules at the top; the procedure keeps unrelated workflows
  and forbids guessing inputs
- Workflow headers: start from the template, use the short tag @v0.1
- AGENTS.md: the same rules
@PavlosIsaris
PavlosIsaris merged commit c853f8c into main Oct 1, 2026
28 checks passed
@PavlosIsaris
PavlosIsaris deleted the agent-findings branch October 1, 2026 06:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant