From d007673cf86683ad18281d42250b2cd759c16607 Mon Sep 17 00:00:00 2001
From: burtenshaw <ben.burtenshaw@gmail.com>
Date: Tue, 3 Mar 2026 11:06:14 -0800
Subject: [PATCH 1/2] add to cli docstring

---
 src/cmd/mod.rs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/cmd/mod.rs b/src/cmd/mod.rs
index 35c3e2b..de5abdf 100644
--- a/src/cmd/mod.rs
+++ b/src/cmd/mod.rs
@@ -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>,
@@ -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)]

From f0f859bbeedf748daf86e858f193eb7c525a1508 Mon Sep 17 00:00:00 2001
From: burtenshaw <ben.burtenshaw@gmail.com>
Date: Tue, 3 Mar 2026 11:07:36 -0800
Subject: [PATCH 2/2] details in AGENTS.md

---
 templates/setup/AGENTS.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/templates/setup/AGENTS.md b/templates/setup/AGENTS.md
index 353790d..d1864a2 100644
--- a/templates/setup/AGENTS.md
+++ b/templates/setup/AGENTS.md
@@ -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++.
+
 ## Skills
 A skill is a local instruction bundle stored in `SKILL.md`.