Skip to content

docs(agents): document AO-first workflow#1275

Merged
christso merged 1 commit into
mainfrom
docs/ao-first-agent-guidance
Jun 2, 2026
Merged

docs(agents): document AO-first workflow#1275
christso merged 1 commit into
mainfrom
docs/ao-first-agent-guidance

Conversation

@christso
Copy link
Copy Markdown
Collaborator

@christso christso commented Jun 2, 2026

Summary

  • Add an AO-first orchestration section to AGENTS.md.
  • Clarify that AO owns live assignments, worker/session status, worktrees, PR claiming, and visualization.
  • Keep GitHub as the external collaboration surface for issues, PRs, reviews, CI, and durable handoff.
  • Remove instructions that pushed workers toward unmanaged subagents, project-board claim stamping, duplicate worktrees, or competing live trackers.
  • Explicitly de-emphasize Beads: do not use Beads or ep-spawn-agent for routine AO-managed work; only use Beads if explicitly assigned by AO/user for durable planning/backlog work.
  • Update remaining Studio/docs-site-only wording to Dashboard, including Browser E2E guidance for both docs and Dashboard verification.

Red/Green UAT evidence

  • Red: on origin/main, grep -nE "Use subagents aggressively|spawn a final subagent|AGENT_ID|gh project item|roadmap project is the source" AGENTS.md finds unmanaged subagent spawning guidance and GitHub project-board claim stamping instructions; Browser E2E guidance is scoped only to the docs site and dashboard UI text still uses Studio naming.
  • Green: on this branch, the same conflict grep returns no matches, while AGENTS.md now contains the AO-first ownership/lifecycle guidance plus Dashboard/browser E2E wording.

Verification

  • git diff --check
  • Conflict grep for unmanaged subagent/project-board claim/Beads-default instructions
  • Pre-push hooks on git push --force-with-lease passed:
    • build
    • typecheck
    • lint
    • test
    • validate eval YAML files

Notes

This is a fresh branch from current origin/main and does not carry the Beads setup commits from PR #1272/#1274.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jun 2, 2026

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: 821a376
Status: ✅  Deploy successful!
Preview URL: https://d8350cca.agentv.pages.dev
Branch Preview URL: https://docs-ao-first-agent-guidance.agentv.pages.dev

View logs

@christso christso force-pushed the docs/ao-first-agent-guidance branch from 7ccbe0b to 821a376 Compare June 2, 2026 04:50
@christso christso marked this pull request as ready for review June 2, 2026 05:05
@christso christso merged commit b47f0eb into main Jun 2, 2026
4 checks passed
@christso christso deleted the docs/ao-first-agent-guidance branch June 2, 2026 05:05
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