Document the AGENTS.md generated by `stellar contract init` and an agent workflow using the CLI

Open Beginner friendly

#2,872 opened on Sep 23, 2026 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 2/5
Estimated time: 1-3 hours
Newbie friendliness: 75/100

Issue type: Documentation
Clarity: Clearly specified
Activity status: Active
Domain: documentation

Research direction

Look at the output of stellar contract init in a new project to see the generated AGENTS.md file. Examine the CLI manual for existing --output json flags. The task is to create documentation explaining the AGENTS.md file's purpose and content, and to write a tutorial showing an agent workflow using the CLI's JSON output. Start by checking the docs repository structure to find where to add this new content.

Written by the indexing model from the issue text.

Description

dev-rel documentation

stellar contract init now generates an AGENTS.md in every new project (merged August 2026), and the CLI's --output json flags are in the manual. Neither is explained anywhere: developers using AI coding agents find both by accident, and the CLI guides describe only the human-facing flow.

Please add:

a page on the generated AGENTS.md: what it contains, how to customise it, how agents pick it up;
one end-to-end agent workflow (init → build → deploy → invoke) using the existing --output json flags, linked from the CLI manual.

Surfaced by Frontier Lab's ecosystem crawl.

Dominant language: MDX
Stars: 138
Forks: 313
Avg merge: 2d 22h
Merged PRs (30d): 39

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

docs: update workflows.md for slide deck Node test discovery Open

agent-ready documentation needs-triage

Difficulty 1/5 1-3 hours Newbie friendliness 88/100

microsoft/hve-core#3012 · Opened Sep 25, 2026
UnscopedRefAttribute article displaying xml tags Open

untriaged

Difficulty 1/5 Under an hour Newbie friendliness 88/100

dotnet/dotnet-api-docs#13095 · Opened Sep 25, 2026
config_keys.rst says every result file PyBNF writes is alphabetical, but the credible-interval files and start_point.txt use declaration order Open

documentation

Difficulty 1/5 Under an hour Newbie friendliness 91/100

lanl/PyBNF#932 · Opened Sep 25, 2026
workflow-status page template still says reusable workflows are "triggered only by workflow_call:" Open

Difficulty 1/5 Under an hour Newbie friendliness 92/100

LearningCircuit/local-deep-research#6804 · Opened Sep 24, 2026
[P3] Require successful validation before documentation deployment Open

refactor

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

nteract/semiotic#1523 · Opened Sep 24, 2026