feat: add agents files
Metadata
Current evaluation
Merged addition of AGENTS.md templates for craft apps, craft libraries, and starbase. Approved by two reviewers, passed all CI checks, and introduced four new files to standardize AI coding agent context across projects.
Suggested action: —
No scores available.
Issue body
Adds an:
- Agents template for craft apps
- Agents template for craft libraries
- Agents file for starbase itself
Sources used:
- Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents? ([source](https://arxiv.org/abs/2602.11988))
- On the Impact of AGENTS.md Files on the Efficiency of AI Coding Agents ([source](https://arxiv.org/abs/2601.20404))
- Prompting best practices from the Claude API docs ([source](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices))
- https://agents.md/
- This is the official standard for agents files. It covers the file name, loosely covers file discovery, and doesn't really cover file contents.
(CRAFT-5188)
---
- [x] I've followed the [contribution guidelines](https://github.com/canonical/starbase/blob/main/CONTRIBUTING.md).
- [x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
- [x] I've successfully run `make lint && make test`.
- [ ] I've added or updated any relevant documentation.
- [ ] In documents I changed, I [added a meta description](https://canonical-starflow.readthedocs-hosted.com/how-to/add-a-page-meta-description/) if one was missing.
- [ ] I've updated the relevant release notes.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Merged addition of AGENTS.md templates for craft apps, craft libraries, and starbase. Approved by two reviewers, passed all CI checks, and introduced four new files to standardize AI coding agent context across projects. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged. Added AGENTS.md template files for craft apps, craft libraries, and the starbase repository, aligned with the agents.md standard and recent research. An unrelated RTD build failure was noted but did not block the merge. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1584 feat: Add agent skill to create new plugins | craft-parts | open | Adds an agent skill (2387 lines, 27 files) to scaffold new build-system plugins for craft-parts. Maintainer-authored, last active 11 days ago, 7 unresolved review comments, lint/files CI failing, no human discussion yet. |