Context
Repository agent-related assets are currently split across multiple roots:
.agent (local tasks/notes/skills/workflows)
.opencode (skills/agents used by CI and OpenCode)
.claude (authoring rules)
This works today, but introduces discoverability and governance overhead.
Goal
Design a safe unification strategy for agent assets without breaking current CI/CD behavior.
Non-goals
- No immediate migration in this task.
- No sync scripts/mechanisms yet.
Deliverables
- Inventory of asset types and current consumers (local Codex, OpenCode CI, human docs).
- Target directory model (single source of truth + compatibility constraints).
- Migration plan with rollback steps.
- Minimal validation checklist for CI safety.
Acceptance criteria
- Proposed model keeps existing workflows operational during transition.
- Explicit compatibility story for OpenCode agents/skills in
.opencode.
- Clear phased rollout with ownership.
Context
Repository agent-related assets are currently split across multiple roots:
.agent(local tasks/notes/skills/workflows).opencode(skills/agents used by CI and OpenCode).claude(authoring rules)This works today, but introduces discoverability and governance overhead.
Goal
Design a safe unification strategy for agent assets without breaking current CI/CD behavior.
Non-goals
Deliverables
Acceptance criteria
.opencode.