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 — 75x across 5 model(s)
• edit:not_read_first — 46x across 6 model(s)
• webfetch:other — 39x across 4 model(s)
• read:file_not_found — 38x across 5 model(s)

---

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

---

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

[superdav42]

DISPATCH_CLAIM nonce=ce2f1b93edd0f1b9b75b876a0df46bec runner=superdav42 ts=2026-04-29T07:14:48Z max_age_s=1800 version=3.13.10

[superdav42]

Dispatching worker (deterministic).

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

[superdav42]

CLAIM_RELEASED reason=worker_failed runner=dave ts=2026-04-29T07:27:31Z

[superdav42]

Summary

Triage of contributor-insight issue #978 (4 recurring error patterns from superdav42).
Worker triage assessment: Premise verified — error patterns are real. Outcome B: AGENTS.md already covers the four patterns comprehensively, but the repo file lagged behind the canonical target state. This PR fills the documented gaps.

Changes

AGENTS.md — Project Structure:

• Added three missing test directories: tests/Builders/, tests/functional/, tests/unit/
• These subdirectories exist in the repo but were absent from the project map, causing read:file_not_found errors when contributors searched for test files
  AGENTS.md — Non-existent paths table:
• Added inc/bootstrap.php — commonly attempted; plugin entry point is ultimate-multisite.php
• Added tests/WP_Ultimo/bootstrap.php — commonly attempted; actual bootstrap is tests/bootstrap.php
• Added inc/class-plugin.php / inc/class-main.php — common WP plugin naming convention that doesn't apply here; main class is inc/class-wp-ultimo.php

Error patterns addressed

Pattern	Count	Fix
read:file_not_found	38x	3 new not-exist table entries + full test structure documented
bash:other	75x	Clearer test structure reduces navigation mistakes
edit:not_read_first	46x	Already covered in AGENTS.md; no new gap found
webfetch:other	39x	Already covered in AGENTS.md; no new gap found

Testing

Documentation-only change — no PHP/JS code modified.

git ls-files 'tests/Builders/' | head -1         # non-empty confirms directory exists
git ls-files 'inc/bootstrap.php'                  # empty confirms path correctly non-existent
git ls-files 'tests/WP_Ultimo/bootstrap.php'      # empty confirms path correctly non-existent

---

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

---

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