Skip to content

chore(agents): structural optimization — deduplicate and separate concerns#57

Merged
normenmueller merged 2 commits into
trunkfrom
chore/47-agent-optimization
May 6, 2026
Merged

chore(agents): structural optimization — deduplicate and separate concerns#57
normenmueller merged 2 commits into
trunkfrom
chore/47-agent-optimization

Conversation

@normenmueller
Copy link
Copy Markdown
Owner

Summary

Compliance-first restructuring of agent definitions per Epic #43 / Story #47.

Changes

Separation of Concerns

  • Product Contract extracted to copilot-instructions.md (project-specific, auto-injected to all agents)
  • Team methodology (Governance Source of Truth, Explicitness Rule) remains in ai4x.agent.md

Shared Agent Preamble (ai4x.agent.md)

  • Missing-Input Fallback
  • Input Conditionality
  • Contract Violation Rule
  • Completion Standard

Delegation Matrix

  • Inline compact table replacing text-only reference

Specialist Deduplication (all 6)

  • Removed Required Reading items 1+2 (orchestrator-only content, zero specialist value)
  • Removed duplicated 'Violations block progression' (now in shared preamble)
  • Removed duplicated 'Input availability' sentence (now in shared preamble)
  • Retained engineering-quality.md reference in every specialist (AC-1.2)
  • Retained all MUST/SHOULD markers (AC-1.4)

PBL Updates

  • ai4x-team-portability.md: Added spc/ layer (cognitive capability compositions) as third team pillar
  • ai4x-usp-documentation.md: Added Agent-Host Agnosticism Principle

Design Decisions (PO-approved)

  1. Agent-Host Agnosticism: team layer must be host-agnostic; .agent.md is activation surface
  2. Product Contract is project-specific → copilot-instructions.md
  3. spc/ layer acknowledged but NOT structurally introduced (Strategy A Conservative)

Resolves #47

- ai4x-team-portability: add spc/ (cognitive capability compositions) as
  third team pillar, update Q1 with emerging answer
- ai4x-usp-documentation: add Agent-Host Agnosticism Principle as
  non-negotiable, define terminology (Agent Host, Team Declaration,
  Materialization)

Part of #47
…cerns

- Extract Product Contract to copilot-instructions.md (project-specific)
- Add Shared Agent Preamble to ai4x.agent.md (missing-input fallback,
  input conditionality, contract violation rule, completion standard)
- Inline Delegation Matrix as compact table in ai4x.agent.md
- Remove Required Reading items 1+2 from all 6 specialists (orchestrator-
  only content, zero specialist value)
- Remove duplicated 'Violations block progression' from all specialists
- Remove duplicated 'Input availability' preamble from all specialists
- Retain engineering-quality.md reference in every specialist (AC-1.2)
- Retain all MUST/SHOULD gradient markers (AC-1.4)

Part of #47
@normenmueller normenmueller self-assigned this May 6, 2026
@normenmueller normenmueller merged commit 622b060 into trunk May 6, 2026
1 check passed
@normenmueller normenmueller deleted the chore/47-agent-optimization branch May 6, 2026 20:23
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.

S4: Agent structural optimization

1 participant