Skip to content

docs(boost): prefer an interface for mail - #53

Merged
danielebarbaro merged 2 commits into
mainfrom
docs/boost-mail-port
Nov 16, 2026
Merged

danielebarbaro merged 2 commits into
mainfrom
docs/boost-mail-port

Conversation

@danielebarbaro

Copy link
Copy Markdown
Contributor

The Boost skill answered the same question in two opposite ways, and an AI agent following it could land on either.

The question is: an action has to send a mail, the mail class lives in the infrastructure layer, and the application layer must not import infrastructure. What do you do?

One section of the skill said to add an interface in the application layer, implement it in infrastructure, and never widen validation.application_infrastructure_allowed to skip it. Twenty lines below, another section offered exactly that list as the way out for "sending mail or a notification straight from an action".

I ran the same task twice on a real app. The first run produced an interface with a mail implementation behind it. The second run imported the mail class from the action and added Mail to the allow list. Both runs were following the skill.

This change makes the interface the default and says so with a mail example (RegistrationNotifier in the application layer, the class that sends the mail in infrastructure). The allow list stays documented, but as a decision the project has already written in its config. When the list is empty, the skill now tells the agent not to add to it just to make a violation go away.

Only the skill text and the changelog change. No code, no generated file, no config default is touched, so this fits a patch release.

@danielebarbaro
danielebarbaro merged commit 6a9ce9b into main Nov 16, 2026
8 checks passed
@danielebarbaro
danielebarbaro deleted the docs/boost-mail-port branch November 16, 2026 13:53
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.

1 participant