Skip to content

Generate AGENTS.md when running stellar contract init - #2687

Merged
fnando merged 4 commits into
stellar:mainfrom
rohansingh4:feat/2671-init-agents-md
Aug 17, 2026
Merged

Generate AGENTS.md when running stellar contract init#2687
fnando merged 4 commits into
stellar:mainfrom
rohansingh4:feat/2671-init-agents-md

Conversation

@rohansingh4

@rohansingh4 rohansingh4 commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Include AGENTS.md in the stellar contract init workspace template so new projects ship agent-oriented build, test, and deploy guidance.
  • Document AGENTS.md in the template README layout.
  • Assert the file is copied and covers stellar contract build, cargo test, and wasm32v1-none.

Test plan

  • stellar contract init /tmp/test-agents and confirm AGENTS.md is at the workspace root
  • Confirm AGENTS.md mentions stellar contract build, cargo test, and wasm32v1-none
  • Run init integration tests (cargo test -p soroban-test --test it init or the repo's usual init test target)

New projects get agent-oriented build, test, and deploy guidance at the
workspace root so coding agents can work without extra setup.

Co-authored-by: Cursor <cursoragent@cursor.com>
Copilot AI balanced review requested due to automatic review settings August 17, 2026 11:18
@github-project-automation github-project-automation Bot moved this to Backlog (Not Ready) in DevX Aug 17, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds an AGENTS.md guidance document to the Soroban contract workspace template and updates tests/docs to ensure it’s generated and contains key build/test instructions.

Changes:

  • Add AGENTS.md to the workspace template and list it in the template README.
  • Extend contract init unit tests to assert AGENTS.md exists and includes build/test/WASM target guidance.
  • Extend integration test to assert AGENTS.md is present and mentions stellar contract build.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
cmd/soroban-cli/src/utils/contract-workspace-template/README.md Updates template file tree to include AGENTS.md.
cmd/soroban-cli/src/utils/contract-workspace-template/AGENTS.md New template documentation covering layout, build, test, deploy, invoke.
cmd/soroban-cli/src/commands/contract/init.rs Updates unit tests to include AGENTS.md existence/content assertions.
cmd/crates/soroban-test/tests/it/init.rs Updates integration test to verify AGENTS.md content includes build command.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread cmd/soroban-cli/src/utils/contract-workspace-template/AGENTS.md Outdated
Comment thread cmd/soroban-cli/src/utils/contract-workspace-template/AGENTS.md Outdated
rohansingh4 and others added 3 commits August 17, 2026 16:52
Minor change

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@fnando fnando changed the title Add AGENTS.md to the stellar contract init workspace template Generate AGENTS.md when running stellar contract init Aug 17, 2026

@fnando fnando left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks for the pr!

@fnando
fnando merged commit 80cc0f1 into stellar:main Aug 17, 2026
224 checks passed
@github-project-automation github-project-automation Bot moved this from Backlog (Not Ready) to Done in DevX Aug 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants