Skip to content

Mention and add details in AGENTS.md #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
burtenshaw wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Mention and add details in AGENTS.md #39

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d007673
add to cli docstring
burtenshaw Mar 3, 2026
f0f859b
details in AGENTS.md
burtenshaw Mar 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion src/cmd/mod.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ fn load_config() -> Result<Config> {

#[derive(Parser, Debug)]
#[command(author, version = env!("CLI_VERSION"), about, long_about = None)]
/// Popcorn CLI for GPU Mode competitions. Run `popcorn setup` first in each project so agents use the correct workflow and templates.
pub struct Cli {
#[command(subcommand)]
command: Option<Commands>,
Expand Down Expand Up @@ -104,7 +105,7 @@ enum SubmissionsAction {

#[derive(Subcommand, Debug)]
enum Commands {
/// Bootstrap this project with Popcorn agent skills and a submission template
/// Run this first: bootstrap the project with Popcorn agent skills and a submission template
Setup,
Reregister {
#[command(subcommand)]
Expand Down
10 changes: 10 additions & 0 deletions templates/setup/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,13 @@
# Kernel Bot Submissions

The Popcorn CLI is intended to submit kernels to leaderboards on GPU Mode's Kernel Bot.

## Objective

Agents must write CUDA C and C++ kernels and integrate them into the single-file `submission.py` workflow.

Do not submit pure PyTorch based optimization. The objective of the task is to write CUDA C or C++.
Copy link
Member

@msaroufim msaroufim Mar 4, 2026

Choose a reason for hiding this comment

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

this isn't quite right, if anything we want people to write using whatever kernel DSL they want

Copy link
Contributor Author

@burtenshaw burtenshaw Mar 5, 2026

Choose a reason for hiding this comment

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

Understood, what about this?

Suggested change
Do not submit pure PyTorch based optimization. The objective of the task is to write CUDA C or C++.
Do not submit pure PyTorch based optimization. The objective of the task is to use any kernel DSL like CUDA or Triton to improved *beyond* the performance of native PyTorch.


## Skills
A skill is a local instruction bundle stored in `SKILL.md`.

Expand Down
Loading