Contributor insight: 4 recurring error pattern(s) from superdav42

[superdav42]

Contributor Insight: Error Patterns

Detected from real usage sessions by contributor superdav42.
These recurring tool failure patterns may indicate framework gaps.

• bash:other — 42x across 5 model(s)
• edit:not_read_first — 39x across 6 model(s)
• webfetch:other — 39x across 4 model(s)
• read:file_not_found — 35x across 5 model(s)

---

Filed automatically by contributor-insight-helper.sh (t2147).

---

aidevops.sh v3.13.0 plugin for OpenCode v1.3.17 with claude-sonnet-4-6 spent 27m and 48,753 tokens on this as a headless worker.

[superdav42]

DISPATCH_CLAIM nonce=e9cf779196f9294611ad627886a89e7d runner=superdav42 ts=2026-04-27T12:09:37Z max_age_s=1800 version=3.13.0

[superdav42]

Dispatching worker (deterministic).

• Worker PID: 5248
• Model: anthropic/claude-sonnet-4-6
• Tier: standard
• Runner: superdav42
• Issue: Contributor insight: 4 recurring error pattern(s) from superdav42 #954

[superdav42]

What

Expands AGENTS.md agent guidance with four targeted additions for the recurring error patterns reported in issue #954 by contributor superdav42.

Why

The contributor-insight scanner detected 155 total tool failures in four categories. Previous PRs (#944, #949, #952) addressed documentation gaps; issue #954 shows the counts are still increasing for bash:other (+13) and edit:not_read_first (+13). This PR targets two new undocumented failure modes for each.

Changes per error pattern

bash:other (42x, +13 from prior filing) — Two new failure modes added to "Common bash:other Failures":

• PHPUnit --filter not matching: vendor/bin/phpunit --filter NonExistentClass exits 1 with "No tests executed!" — agents should verify test class/method names first using git ls-files 'tests/**/*Test.php'.
• Unquoted glob patterns: git ls-files inc/**/*.php (unquoted) shell-expands before git sees the pattern, producing wrong results. Always quote: git ls-files 'inc/**/*.php'.
  edit:not_read_first (39x, +13 from prior filing) — Added a new "New files use Write, not Edit" paragraph clarifying that:
• Edit is for EXISTING files only and requires a prior Read.
• Write is for NEW files and does NOT require a prior Read.
• Before writing a new file, verify the parent directory exists with git ls-files.
  read:file_not_found (35x, +2 from prior filing) — Added three new entries to the non-existent paths table:
• inc/class-checkout.php (root-level) → actual path is inc/checkout/class-checkout.php
• inc/class-membership.php (root-level) → model classes are in inc/models/
• lang/*.po, lang/*.mo → only lang/ultimate-multisite.pot is tracked

Verification

Doc-only change. Verified paths with git ls-files:

• inc/class-checkout.php → empty (does not exist at root)
• inc/checkout/class-checkout.php → exists
• lang/ultimate-multisite.pot → exists; no .po/.mo files tracked

---

aidevops.sh v3.13.0 plugin for OpenCode v1.3.17 with claude-sonnet-4-6 spent 6m and 19,485 tokens on this as a headless worker.

---

Merged via PR #955 to main.
Merged by deterministic merge pass (pulse-wrapper.sh).

[superdav42]

CLAIM_RELEASED reason=worker_branch_orphan runner=dave ts=2026-04-27T12:26:04Z

[superdav42]

WORKER_BRANCH_ORPHAN branch=feature/auto-20260427-060958-gh954 session=issue-954 ts=2026-04-27T12:26:08Z

This worker pushed branch feature/auto-20260427-060958-gh954 but no PR could be opened automatically. To recover, open a PR manually:

gh pr create --head feature/auto-20260427-060958-gh954 --base main --repo Ultimate-Multisite/ultimate-multisite