Skip to content

chore: add AO-first agent workflow guidance#1272

Closed
christso wants to merge 4 commits into
mainfrom
chore/setup-beads
Closed

chore: add AO-first agent workflow guidance#1272
christso wants to merge 4 commits into
mainfrom
chore/setup-beads

Conversation

@christso
Copy link
Copy Markdown
Collaborator

@christso christso commented Jun 2, 2026

Summary

  • Move detailed AgentV agent guidance into committed Phoenix-style skills under .agents/skills/.
  • Add .claude/skills as a symlink to .agents/skills for Claude compatibility.
  • Keep AGENTS.md as compact bootstrap context plus AO-first orchestration rules.
  • Align workflow guidance with the updated decision: AO manages live sessions, worker ownership, worktrees, PR claiming, status, and visualization; GitHub remains the external collaboration surface.
  • De-emphasize Beads as optional durable planning/backlog context only when explicitly assigned by the user/AO.
  • Disable ep-spawn-agent for normal AO-managed AgentV work to avoid unmanaged agents, duplicate worktrees, duplicate PRs, and competing lifecycle ownership.
  • Ignore generated Beads/Dolt state in Biome so pre-push lint does not scan local database internals.

Red/Green UAT evidence

  • Red (before the AO alignment commit): grep -RInE "Beads-first|decentralized orchestration|ALL issue tracking|repo-standard bead launcher|ep-spawn-agent <|Beads is AgentV" AGENTS.md .agents/skills found Beads-only/decentralized orchestration language and ep-spawn-agent <bead-id> as the default launch path.
  • Green (after the AO alignment commit): git diff --check; symlink check for .claude/skills -> ../.agents/skills; and the same conflict grep passed with no matches for Beads-only/default-launch language.

Verification

  • git diff --check
  • .claude/skills symlink check
  • Conflict grep for Beads-only/default-launch instructions
  • git push pre-push hooks passed: build, typecheck, lint, test, and eval YAML validation.

Follow-up

  • If Beads remains in the repository, use it only for explicit AO/user-assigned durable planning/backlog work, not routine live execution tracking.

@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: 4c5ed14
Status: ✅  Deploy successful!
Preview URL: https://bf98df62.agentv.pages.dev
Branch Preview URL: https://chore-setup-beads.agentv.pages.dev

View logs

@christso christso force-pushed the chore/setup-beads branch 4 times, most recently from 2fc1a4c to 0d6688f Compare June 2, 2026 02:39
@christso christso force-pushed the chore/setup-beads branch from 0d6688f to a0f82d5 Compare June 2, 2026 02:50
@christso christso closed this Jun 2, 2026
@christso christso changed the title chore: set up beads workflow chore: add AO-first agent workflow guidance Jun 2, 2026
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