docs: add AGENTS.md for AI coding assistants
Metadata
Current evaluation
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.
Resolution: closed resolved
Reason: PR #1209 was merged with one approval and all CI checks passing, adding AGENTS.md to the repository. The PR body states it supersedes stale draft #954 and derives from canonical/starbase#543.
Evaluated by: mr-cal-bot
No scores available.
Issue body
🤖 This is a preparation PR for the Starbase sync, splitting the net-new AGENTS.md file out of the merge PR.
### Summary
- Adds `AGENTS.md` derived from Starbase's `AGENTS.lib.md` template introduced in [canonical/starbase#543](https://github.com/canonical/starbase/pull/543).
- Customizes project overview, dependent Craft apps, ecosystem libraries, development workflows, testing commands, and engineering practices specifically for `craft-application`.
- Preserves template structure and conventions per Starbase guidance.
Provenance:
- Upstream template: [AGENTS.lib.md](https://github.com/canonical/starbase/blob/70c895b23c486c8fd7d28557ec80990d3a3a521a/AGENTS.lib.md)
- Starbase PR: [canonical/starbase#543](https://github.com/canonical/starbase/pull/543)
- Supersedes stale draft #954
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| ~deepseek/deepseek-pro-latest | — | closed resolved | 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. | |
| ~deepseek/deepseek-pro-latest |
Impact:
20
Quick Win:
15
Complexity:
15
Confidence:
90
Actionability:
90
|
needs review | Adds 99-line AGENTS.md for AI coding assistants, derived from Starbase template and customized for craft-application. Approved, CI green, supersedes stale draft #954. | |
| ~deepseek/deepseek-pro-latest |
Impact:
25
Quick Win:
18
Complexity:
12
Confidence:
88
Actionability:
80
|
needs review | Adds a 99-line AGENTS.md for AI coding assistants, derived from Starbase's AGENTS.lib.md template and customized for craft-application. CI green, awaiting review; supersedes stale draft #954. | |
| ~deepseek/deepseek-pro-latest |
Impact:
25
Quick Win:
17
Complexity:
15
Confidence:
82
Actionability:
78
|
needs review | Adds 99-line AGENTS.md for AI coding assistants, customized for craft-application from the Starbase template. Docs-only, CI green, awaiting review; supersedes stale draft #954. | |
| ~deepseek/deepseek-pro-latest |
Impact:
20
Quick Win:
14
Complexity:
10
Confidence:
88
Actionability:
80
|
needs review | Adds 99-line AGENTS.md for AI coding assistants, customized for craft-application from the Starbase template. Docs-only, CI passing, awaiting review; supersedes stale draft #954. |
Update history
| Date | Change |
|---|---|
| merged | |
| updated | |
| updated | |
| updated | |
| created |
Related work
-
Superseded By:
craft-application#954
(confidence 95%)
PR body explicitly states it supersedes stale draft #954, which remained open with unresolved comments.
-
Related To:
canonical/starbase#543
(confidence 90%)
AGENTS.md is derived from the AGENTS.lib.md template introduced in canonical/starbase#543.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #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. | |
| #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. | |
| #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. | |
| #954 Add agents.md documentation for AI coding assistants | craft-application | open | Adds a 341-line root agents.md for AI coding assistants; changes requested with 59 unresolved comments, no CI results, inactive ~300 days. | |
| #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. | |
| #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. | |
| #543 feat: add agents files | starbase | merged | Merged PR #543 in commit 2cf6c9a, adding AGENTS.md templates for Craft apps and libraries and a repository-level AGENTS.md. |