Skip to content

fix: Complete hybrid workflow documentation gaps #30

Description

@striderZA

Description

The automated PR review (#28) identified two gaps in the hybrid workflow documentation that need completing:

Gap 1: Missing producer role in slimmed hierarchy

The 10-role hierarchy in docs/hybrid-workflow.md drops the producer agent, but AGENTS.md Rule 4 states:

"When a design change affects multiple domains, the producer agent coordinates the propagation."

Required change: Document which role handles cross-domain coordination in the slimmed hierarchy (e.g., assign to technical-director or creative-director).

Gap 2: No guard against review-mode state bleed

The full OCGS /prototype skill reads production/review-mode.txt to determine gate strictness. The hybrid /hybrid-prototype skill correctly bypasses this, but there's nothing preventing a session from accidentally inheriting stale review-mode state after switching workflows.

Required change: Add a note in the /hybrid-prototype skill that it explicitly bypasses production/review-mode.txt and resets any inherited review state.

Files to Modify

  • docs/hybrid-workflow.md — assign producer duties to a role in the hierarchy table
  • .opencode/skills/hybrid-prototype/SKILL.md — add review-mode guard note

References

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions