Skip to content

docs: create agents.md - #5

Open
kelly-sovacool wants to merge 13 commits into
mainfrom
agents-md
Open

docs: create agents.md#5
kelly-sovacool wants to merge 13 commits into
mainfrom
agents-md

Conversation

@kelly-sovacool

@kelly-sovacool kelly-sovacool commented Jul 29, 2026

Copy link
Copy Markdown
Member

Changes

  • agents.md file provides context for AI agents assisting developers in editing capsule code.
  • also added a script to help developers run tests locally on macOS via podman.

Issues

NA

PR Checklist

(Strikethrough any points that are not applicable.)

  • This comment contains a description of changes with justifications, with any relevant issues linked.
  • Run the capsule in Code Ocean and ensure it completes successfully with no errors.
  • Update CHANGELOG.md with a short description of any user-facing changes and reference the PR number. Follow the style described in https://style.tidyverse.org/news.html
  • The test workflow succeeds on the latest commit.

@kelly-sovacool
kelly-sovacool requested a review from phoman14 July 30, 2026 13:47
Comment thread AGENTS.md
Comment on lines +69 to +80
## Pull request (PR) process

- When opening a PR, use the request template (`.github/PULL_REQUEST_TEMPLATE.md`) and fill out all sections of the template in the PR description.
- Do not allow the developer to proceed with opening a PR if it does not fill out all sections of the template.
- Before a PR can be moved from draft to "ready for review", all of the relevant checklist items must be checked, and any
irrelevant checklist items should be crossed out.
- If code is AI-generated, the PR should be labeled `generated-by-AI`. There should be a brief, concise statement in the PR description of how AI was used in creating the PR (model used, high-level prompt intent, manual review confirmation).
- When new features, bug fixes, or other behavioral changes are introduced to the code,
unit tests must be added or updated to cover the new or changed functionality.
- If there are any API or other user-facing changes, the documentation must be updated via inline roxygen comments.
- The `tests` github actions workflow must pass before the PR can be approved.

@phoman14 phoman14 Jul 31, 2026

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.

@kelly-sovacool What happens if there are merge conflicts in code/MOSuite.
My understanding is that MOSuite repo has to be matched with syncweaver lock file. how would you resolve?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I would want human devs to resolve merge conflicts rather than hand that responsibility off to AI agents.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

@phoman14 I added a line stating so 45bf7d8

@kelly-sovacool
kelly-sovacool requested a review from a team August 4, 2026 15:35
Comment thread tests/run-tests-podman.sh
IMAGE=${IMAGE//codeocean/nciccbr}
echo "Using image: $IMAGE"

podman run --rm \

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

@phoman14 thought you'd be interested in this. Providing a script for running the tests via podman solves dependency problems in local R environments! I also added a similar script for running R CMD Check in MOSuite (https://github.com/CCBR/MOSuite/blob/54ad1f43848029fc3f694783b3381f77a9d406fc/inst/extdata/run-check-podman.sh).

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.

This is interesting!! does this mean we can set up an R enviroment for everyone to use when testing even when they are testing locally?

@kelly-sovacool kelly-sovacool Aug 7, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yes, this script parses the code ocean environment json file to grab the docker image, and uses podman to run the tests in the image. The container engine has to be podman rather than docker since we can't install docker on our NCI laptops.

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.

I will try to get it set up on my computer and let you know if i run into any problems

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants