Skip to content

chore(agents): formalize handoff schema and authority hierarchy#58

Merged
normenmueller merged 1 commit into
trunkfrom
chore/48-handoff-authority
May 7, 2026
Merged

chore(agents): formalize handoff schema and authority hierarchy#58
normenmueller merged 1 commit into
trunkfrom
chore/48-handoff-authority

Conversation

@normenmueller
Copy link
Copy Markdown
Owner

Summary

Formalizes the inter-agent collaboration model per Epic #43 / Story #48.

Changes

ai4x.agent.md (Workflow and Gates)

  • Handoff Schema: Task prompt as delivery mechanism — 5 mandatory items
  • Authority Stack: Contracts > Protocols > Orchestrator > Specialist > PO Override
  • Blocked Protocol: 6-step protocol with retry bound and PO Override escape hatch

ai4x.agent.md (Shared Agent Preamble)

  • Self-Scoping Rule: Positive verification against declared responsibilities
  • Contract Precedence: More-specific-wins with same-level escalation clause

copilot-instructions.md (visibility guarantee)

  • Authority Stack and Contract Precedence duplicated with canonical source cross-references

Design Decisions (AI Strategy expert approved)

  1. Task prompt IS the handoff
  2. ACs verbatim in handoff (not by reference)
  3. PO Override at rank 5 as exception mechanism
  4. Self-scoping as positive verification
  5. One-cycle retry bound prevents remediation ping-pong
  6. Dual placement for injection model compliance

Resolves #48

- Add Handoff Schema: orchestrator task prompt as delivery mechanism,
  verbatim ACs, inline/path artifacts, scope constraints
- Add Authority Stack: Contracts > Protocols > Orchestrator > Specialist
  > PO Override (explicit, documented)
- Add Blocked Protocol: severity-based format, concrete remediation,
  one-cycle retry bound, PO override escape hatch
- Add Self-Scoping Rule to Shared Agent Preamble: positive verification
  against declared responsibilities before producing deliverables
- Add Contract Precedence: more-specific-wins default with same-level
  escalation clause
- Duplicate Authority Stack and Contract Precedence to
  copilot-instructions.md for visibility guarantee to all agents

Resolves #48
@normenmueller normenmueller self-assigned this May 7, 2026
@normenmueller normenmueller merged commit 1e8964e into trunk May 7, 2026
1 check passed
@normenmueller normenmueller deleted the chore/48-handoff-authority branch May 7, 2026 17:47
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.

S5: Handoff schema and authority hierarchy

1 participant