Skip to content

docs: Phase D/A docs bundle -- maintainer agent-task guide (D7), outputs README (A9), troubleshooting table (A10) - #933

Merged
cschanhniem merged 1 commit into
mainfrom
docs/d7-a9-a10-maintainer-outputs-troubleshooting
Jul 10, 2026
Merged

cschanhniem merged 1 commit into
mainfrom
docs/d7-a9-a10-maintainer-outputs-troubleshooting

Conversation

@cschanhniem

Copy link
Copy Markdown
Collaborator

Implements D7, A9, and A10 from NEXT_100_PR_MAP (docs-only bundle).

What

  • docs/operations/MAINTAINER_AGENT_TASK_GUIDE.md (D7): 3 agent-dispatch prompt templates (schema, docs-only, map-update), issue labeling convention, agent failure signals, pre-assignment checklist
  • outputs/README.md (A9): explains generated artifacts, dry-lab-only notice, what is ignored in git, how to regenerate examples
  • docs/getting-started/TROUBLESHOOTING.md (A10): 10 common install/test failures with root causes and fixes
  • Docs-only PR; no code changes

Why

D7: Without maintainer-facing prompt templates, humans write under-specified agent tasks with missing safety classifications.
A9: Without an outputs README, new contributors misinterpret dry-lab pipeline outputs as biological claims.
A10: Without a troubleshooting table, new users spend time on avoidable issues (wrong Python version, ModuleNotFoundError, stale BASELINE).

Disconfirming pass

  • D7 templates do not weaken any safety gate; they add safety classification as a required field
  • A9 explicitly preserves the dry-lab-only notice in every output interpretation
  • A10 troubleshooting entry explicitly tells users NOT to lower benchmark thresholds

…uts README (A9), troubleshooting table (A10) (#933)
@cschanhniem
cschanhniem merged commit 7b30c2a into main Jul 10, 2026
1 check failed
cschanhniem pushed a commit that referenced this pull request Jul 10, 2026
…uts README (A9), troubleshooting table (A10) (#933)
cschanhniem added a commit that referenced this pull request Jul 10, 2026
…uts README (A9), troubleshooting table (A10) (#933) (#934)

Co-authored-by: OpenCode <opencode@example.com>
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