Architecture

Components

• Agents execute tasks
• Repo stores AEP packs and instructions
• Tooling handles save/apply/inspect/promote flows
• Versioning tracks evolution of successful patterns

Integration model

1. Agent loads project context and relevant AEP.
2. Agent executes workflow under constraints.
3. Agent validates success checks.
4. Team updates versioned AEP files after completion.

Reference architecture pattern

1. Instruction layer: AGENTS.md, CLAUDE.md, and agent-specific rules point to AEP usage.
2. Pack layer: task/project/user AEP files live in visible repository paths.
3. Execution layer: agent reads pack, runs workflow, reports checks.
4. Learning layer: maintainers review and promote proven patterns.

Versioning strategy

• Include version tags in pack metadata.
• Record breaking changes in changelog docs.
• Promote stable patterns deliberately, not automatically.