[mirror] Opinionated R package quickstart
Concise AGENTS
+20
-24
+10
-12
AGENTS.md
+10
-12
AGENTS.md
···
1
-
# General Rules
2
-
First run the tests.
3
-
red/green TDD. Add tests using usethis::use_test()
4
-
Read DESCRIPTION and README.md.
1
+
# General
2
+
Read DESCRIPTION, README
3
+
Red/green TDD via usethis::use_test()
5
4
6
5
# Personality
7
-
Use literal, direct, concise, specific, high signal, non-empathic, highly structured language. Don't hedge. Don't both sides issues. Don't ask questions at the end of the turn. Don't make offers at the end of the turn.
8
-
Only ask questions if it is a request for information necessary for a previous request
6
+
Literal, direct, concise, high-signal, non-empathic. No hedging, both-sidesing, closing summaries, or offers. Only ask questions if functionally blocked.
9
7
10
-
# R Package Development Rules
11
-
Never edit .Rd files or NAMESPACE directly.
12
-
Use devtools::document(), devtools::test(), devtools::check() for redoc, tests, R CMD CHECK
13
-
Try not to add new dependencies unless the code would be much cleaner/faster/better--note added deps to me. Otherwise, stick to Base R and packages in the current dependency closure.
14
-
Use usethis::use_import_from() or usethis::use_package() to add dependencies
15
-
Make sure air format ., jarl check . --fix --allow-dirty, all tests, and R CMD check pass before you claim to be done.
8
+
# R Dev Rules
9
+
No manual edits to .Rd or NAMESPACE.
10
+
Use devtools::document(), test(), check().
11
+
Prefer Base R, existing dep closure. Request permission for new deps which make code better.
12
+
Add deps via usethis::use_import_from(), use_package()
13
+
air format ., jarl check . --fix --allow-dirty, all tests, and R CMD check pass before you claim to be done.
+10
-12
R/bootstrapper.R
+10
-12
R/bootstrapper.R
···
235
235
setup_agents <- function() {
236
236
# See https://simonwillison.net/guides/agentic-engineering-patterns/
237
237
c(
238
-
"# General Rules",
239
-
"First run the tests.",
240
-
"red/green TDD. Add tests using usethis::use_test()",
241
-
"Read DESCRIPTION and README.md.",
238
+
"# General",
239
+
"Read DESCRIPTION, README",
240
+
"Red/green TDD via usethis::use_test()",
242
241
"",
243
242
"# Personality",
244
-
"Use literal, direct, concise, specific, high signal, non-empathic, highly structured language. Don't hedge. Don't both sides issues. Don't ask questions at the end of the turn. Don't make offers at the end of the turn.",
245
-
"Only ask questions if it is a request for information necessary for a previous request",
243
+
"Literal, direct, concise, high-signal, non-empathic. No hedging, both-sidesing, closing summaries, or offers. Only ask questions if functionally blocked.",
246
244
"",
247
-
"# R Package Development Rules",
248
-
"Never edit .Rd files or NAMESPACE directly.",
249
-
"Use devtools::document(), devtools::test(), devtools::check() for redoc, tests, R CMD CHECK",
250
-
"Try not to add new dependencies unless the code would be much cleaner/faster/better--note added deps to me. Otherwise, stick to Base R and packages in the current dependency closure.",
251
-
"Use usethis::use_import_from() or usethis::use_package() to add dependencies",
252
-
"Make sure air format ., jarl check . --fix --allow-dirty, all tests, and R CMD check pass before you claim to be done."
245
+
"# R Dev Rules",
246
+
"No manual edits to .Rd or NAMESPACE.",
247
+
"Use devtools::document(), test(), check().",
248
+
"Prefer Base R, existing dep closure. Request permission for new deps which make code better.",
249
+
"Add deps via usethis::use_import_from(), use_package()",
250
+
"air format ., jarl check . --fix --allow-dirty, all tests, and R CMD check pass before you claim to be done."
253
251
) |>
254
252
write_to_path(fs::path("AGENTS.md"))
255
253
}