Skip to content

chore: add AO-first agent workflow guidance#1274

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

chore: add AO-first agent workflow guidance#1274
christso wants to merge 5 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.

@christso
Copy link
Copy Markdown
Collaborator Author

christso commented Jun 2, 2026

Closing because the requested follow-up is moving to a fresh AO-first branch from origin/main without carrying the Beads setup commits.

@christso christso closed this Jun 2, 2026
@christso christso deleted the chore/setup-beads branch June 2, 2026 09:25
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