← Back to issue list

feat: add agents files

View original Github issue

Metadata

Project
starbase
Number
#543
Type
pull request
State
merged
Author
mr-cal
Labels
—
Created
Updated
Closed

Current evaluation

Merged PR #543 in commit 2cf6c9a, adding AGENTS.md templates for Craft apps and libraries and a repository-level AGENTS.md.

Resolution: closed resolved

Reason: PR #543 was approved and merged with all CI checks passing. Commit 2cf6c9a records the merged feature.

Evaluated by: mr-cal-bot

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
stealth/space-bunny-alpha — closed resolved Merged PR #543 in commit 2cf6c9a, adding AGENTS.md templates for Craft apps and libraries and a repository-level AGENTS.md.
stealth/space-bunny-alpha — closed resolved Merged PR #543 via commit 2cf6c9a, adding AGENTS.md templates for craft apps and libraries plus a starbase agents file to standardize AI-agent project context.
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 work

Related issues

Issue Project State Summary Similarity
#1023 docs: add AGENTS.md for craft-providers craft-providers merged Merged PR #1023 adding an AGENTS.md file to the craft-providers repository, derived from the Starbase template and adapted to follow the craft-cli precedent.
82%
#276 docs: add AGENTS.md craft-platforms closed Merged in #276 via commit 3a60b54, adding a 94-line craft-platforms-specific AGENTS.md (project overview, craft app/library references, dev workflow) for AI coding agents, split out of the Starbase merge #270.
81%
#201 docs: add AGENTS.md for Debcraft debcraft merged Merged PR #201 to add a repository-specific AGENTS.md for Debcraft, derived from the Starbase application template.
76%
#494 docs: add AGENTS.md instructions for craft-cli craft-cli merged Merged PR #494 adding AGENTS.md instructions for AI coding agents, adapted from the Starbase template.
76%
#1209 docs: add AGENTS.md for AI coding assistants craft-application merged Merged PR adding a 99-line AGENTS.md for AI coding assistants, derived from Starbase's AGENTS.lib.md template and customized for craft-application. Supersedes stale draft #954.
73%
#559 docs: fix AGENTS.md typo starbase merged Merged PR #559 (commit b856f52) fixing typos in AGENTS.md and two other doc files (+3/-3); approved by 2 reviewers with all lint/test/security CI checks passing.
71%
#2443 Add `AGENTS.md` to templates charmcraft open Enhancement request to add AGENTS.md agentic-coding instructions to charmcraft init templates. Under discussion; maintainers seek a concrete generic example to adapt.
70%