Skip to content

Add AI agents instructions#49

Open
Vladyslav-Kuksiuk wants to merge 4 commits into
masterfrom
agents
Open

Add AI agents instructions#49
Vladyslav-Kuksiuk wants to merge 4 commits into
masterfrom
agents

Conversation

@Vladyslav-Kuksiuk

Copy link
Copy Markdown
Collaborator

This PR adds an AGENTS.md file and a set of skills to guide AI agents when working with the embed-code-go repository.

Comment thread AGENTS.md
history in this repository.
- Preserve unrelated local changes. Treat them as user work.

## Skills

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could leave this out, since we’ll mention below where the skills are located, but that would require us to manually track skill updates and constantly update the core documentation.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure. AGENTS.md is read at the start of each task, while skills are used only when the agent considers them relevant. If we explicitly explain when and why these skills should be used, it should increase the chances that the agent applies them automatically, without requiring a separate mention.

All the skills we add are added by AI, so we don't need to update them manually.

Comment thread AGENTS.md Outdated
conventions live in `skills/go-tester/SKILL.md`; documentation review lives in
`skills/review-docs/SKILL.md`.

## Fast Path for Agents

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure that we need this.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is the same point as in Spine agents: https://github.com/SpineEventEngine/agents/blob/master/skills/kotlin-engineer/SKILL.md#fast-path-for-agents.

So, I think it's better to leave it as is.

Comment thread skills/go-tester/SKILL.md Outdated
on prepared expected content.
- Keep expected files stable and easy to diff.

## Package-Specific Coverage

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't that just a repetition of what is written in Agents.md?

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.

2 participants