@r1z4x/tezgah 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (582) hide show
  1. package/CHANGELOG.md +738 -0
  2. package/LICENSE +21 -0
  3. package/MANIFEST +753 -0
  4. package/README.de.md +169 -0
  5. package/README.es.md +168 -0
  6. package/README.fr.md +166 -0
  7. package/README.md +161 -0
  8. package/README.tr.md +163 -0
  9. package/agents/tezgah-reviewer.md +70 -0
  10. package/bin/codegen +337 -0
  11. package/bin/consult +797 -0
  12. package/bin/tezgah-adhd +50 -0
  13. package/bin/tezgah-agents +45 -0
  14. package/bin/tezgah-capture +66 -0
  15. package/bin/tezgah-context +96 -0
  16. package/bin/tezgah-decisions +213 -0
  17. package/bin/tezgah-design +953 -0
  18. package/bin/tezgah-docs +1199 -0
  19. package/bin/tezgah-doctor +497 -0
  20. package/bin/tezgah-dsh +37 -0
  21. package/bin/tezgah-dsh.cmd +70 -0
  22. package/bin/tezgah-gate +75 -0
  23. package/bin/tezgah-import-ai-research +439 -0
  24. package/bin/tezgah-index +32 -0
  25. package/bin/tezgah-lessons +148 -0
  26. package/bin/tezgah-mcp +322 -0
  27. package/bin/tezgah-migrate +324 -0
  28. package/bin/tezgah-pony +50 -0
  29. package/bin/tezgah-research +772 -0
  30. package/bin/tezgah-rollback +93 -0
  31. package/bin/tezgah-route +124 -0
  32. package/bin/tezgah-setup +5798 -0
  33. package/bin/tezgah-status +383 -0
  34. package/bin/tezgah-task +607 -0
  35. package/bin/tezgah-taste +423 -0
  36. package/bin/tezgah-triage +485 -0
  37. package/bin/tezgah.js +36 -0
  38. package/commands/adhd.md +21 -0
  39. package/commands/ponytail.md +21 -0
  40. package/docs/README.md +112 -0
  41. package/docs/architecture.md +226 -0
  42. package/docs/citations-baseline.json +59 -0
  43. package/docs/clarity-baseline.json +116 -0
  44. package/docs/contract.md +416 -0
  45. package/docs/environment.md +141 -0
  46. package/docs/evidence.md +831 -0
  47. package/docs/feature-audit.md +139 -0
  48. package/docs/gate.md +407 -0
  49. package/docs/glossary.md +201 -0
  50. package/docs/hosts.md +400 -0
  51. package/docs/index.json +471 -0
  52. package/docs/judge.md +193 -0
  53. package/docs/layers.md +189 -0
  54. package/docs/models.md +160 -0
  55. package/docs/operations.md +666 -0
  56. package/docs/research.md +809 -0
  57. package/docs/results/paired-outcome-2026-10.jsonl +254 -0
  58. package/docs/results/paired-outcome-2026-10.md +204 -0
  59. package/docs/skills.md +236 -0
  60. package/docs/status-line.md +315 -0
  61. package/docs/testing.md +287 -0
  62. package/docs/vision.md +117 -0
  63. package/hooks/hooks.json +33 -0
  64. package/hooks/projects-auto-init.py +98 -0
  65. package/hooks/projects-posttooluse.py +149 -0
  66. package/hooks/projects-pretooluse.py +40 -0
  67. package/hooks/projects-stop.py +60 -0
  68. package/hooks/tezgah_agents.py +817 -0
  69. package/hooks/tezgah_apps.py +266 -0
  70. package/hooks/tezgah_attest.py +255 -0
  71. package/hooks/tezgah_clarity.py +171 -0
  72. package/hooks/tezgah_components.py +140 -0
  73. package/hooks/tezgah_context.py +2953 -0
  74. package/hooks/tezgah_embed.py +765 -0
  75. package/hooks/tezgah_gate.py +2736 -0
  76. package/hooks/tezgah_guard.py +177 -0
  77. package/hooks/tezgah_index.py +124 -0
  78. package/hooks/tezgah_integrity.py +5141 -0
  79. package/hooks/tezgah_judge.py +487 -0
  80. package/hooks/tezgah_lang.py +230 -0
  81. package/hooks/tezgah_lessons.py +210 -0
  82. package/hooks/tezgah_models.py +855 -0
  83. package/hooks/tezgah_paths.py +1132 -0
  84. package/hooks/tezgah_policy.py +1039 -0
  85. package/hooks/tezgah_rank.py +77 -0
  86. package/hooks/tezgah_replay.py +1109 -0
  87. package/hooks/tezgah_research.py +5176 -0
  88. package/hooks/tezgah_shapes.py +305 -0
  89. package/hooks/tezgah_skill_pick.py +227 -0
  90. package/hooks/tezgah_snapshot.py +490 -0
  91. package/hooks/tezgah_stopspec.py +320 -0
  92. package/hooks/tezgah_task.py +458 -0
  93. package/hooks/tezgah_taste.py +201 -0
  94. package/hooks/tezgah_untrusted.py +112 -0
  95. package/hooks/tezgah_update.py +430 -0
  96. package/hosts/codex/hook.py +268 -0
  97. package/hosts/codex/hooks.json +26 -0
  98. package/hosts/cursor/hook.py +461 -0
  99. package/hosts/cursor/hooks.json +44 -0
  100. package/hosts/dsh/hooks.json +21 -0
  101. package/hosts/dsh/statusline/lib/client.js +138 -0
  102. package/hosts/dsh/statusline/lib/index.js +104 -0
  103. package/hosts/dsh/statusline/package.json +28 -0
  104. package/hosts/omp/hook.py +277 -0
  105. package/hosts/omp/tezgah-hook.ts.in +701 -0
  106. package/hosts/opencode/plugins/tezgah.js +2742 -0
  107. package/hosts/opencode/tui/tezgah-tui.tsx +151 -0
  108. package/output-styles/tezgah.md +142 -0
  109. package/package.json +32 -0
  110. package/packaging/build.sh +342 -0
  111. package/packaging/install.ps1 +166 -0
  112. package/packaging/install.sh +56 -0
  113. package/packaging/upgrade.sh +142 -0
  114. package/skills/ai-research/0-autoresearch-skill/SKILL.md +411 -0
  115. package/skills/ai-research/0-autoresearch-skill/references/agent-continuity.md +95 -0
  116. package/skills/ai-research/0-autoresearch-skill/references/progress-reporting.md +166 -0
  117. package/skills/ai-research/0-autoresearch-skill/references/skill-routing.md +219 -0
  118. package/skills/ai-research/0-autoresearch-skill/templates/findings.md +44 -0
  119. package/skills/ai-research/0-autoresearch-skill/templates/research-log.md +41 -0
  120. package/skills/ai-research/01-model-architecture/litgpt/SKILL.md +469 -0
  121. package/skills/ai-research/01-model-architecture/litgpt/references/custom-models.md +569 -0
  122. package/skills/ai-research/01-model-architecture/litgpt/references/distributed-training.md +452 -0
  123. package/skills/ai-research/01-model-architecture/litgpt/references/supported-models.md +337 -0
  124. package/skills/ai-research/01-model-architecture/litgpt/references/training-recipes.md +620 -0
  125. package/skills/ai-research/01-model-architecture/mamba/SKILL.md +260 -0
  126. package/skills/ai-research/01-model-architecture/mamba/references/architecture-details.md +207 -0
  127. package/skills/ai-research/01-model-architecture/mamba/references/benchmarks.md +256 -0
  128. package/skills/ai-research/01-model-architecture/mamba/references/training-guide.md +389 -0
  129. package/skills/ai-research/01-model-architecture/nanogpt/SKILL.md +290 -0
  130. package/skills/ai-research/01-model-architecture/nanogpt/references/architecture.md +383 -0
  131. package/skills/ai-research/01-model-architecture/nanogpt/references/data.md +477 -0
  132. package/skills/ai-research/01-model-architecture/nanogpt/references/training.md +565 -0
  133. package/skills/ai-research/01-model-architecture/rwkv/SKILL.md +260 -0
  134. package/skills/ai-research/01-model-architecture/rwkv/references/architecture-details.md +345 -0
  135. package/skills/ai-research/01-model-architecture/rwkv/references/rwkv7.md +387 -0
  136. package/skills/ai-research/01-model-architecture/rwkv/references/state-management.md +370 -0
  137. package/skills/ai-research/01-model-architecture/torchtitan/SKILL.md +358 -0
  138. package/skills/ai-research/01-model-architecture/torchtitan/references/checkpoint.md +182 -0
  139. package/skills/ai-research/01-model-architecture/torchtitan/references/custom-models.md +259 -0
  140. package/skills/ai-research/01-model-architecture/torchtitan/references/float8.md +134 -0
  141. package/skills/ai-research/01-model-architecture/torchtitan/references/fsdp.md +127 -0
  142. package/skills/ai-research/02-tokenization/huggingface-tokenizers/SKILL.md +516 -0
  143. package/skills/ai-research/02-tokenization/huggingface-tokenizers/references/algorithms.md +654 -0
  144. package/skills/ai-research/02-tokenization/huggingface-tokenizers/references/integration.md +638 -0
  145. package/skills/ai-research/02-tokenization/huggingface-tokenizers/references/pipeline.md +724 -0
  146. package/skills/ai-research/02-tokenization/huggingface-tokenizers/references/training.md +566 -0
  147. package/skills/ai-research/02-tokenization/sentencepiece/SKILL.md +235 -0
  148. package/skills/ai-research/02-tokenization/sentencepiece/references/algorithms.md +201 -0
  149. package/skills/ai-research/02-tokenization/sentencepiece/references/training.md +305 -0
  150. package/skills/ai-research/03-fine-tuning/axolotl/SKILL.md +158 -0
  151. package/skills/ai-research/03-fine-tuning/axolotl/references/api.md +5549 -0
  152. package/skills/ai-research/03-fine-tuning/axolotl/references/dataset-formats.md +1030 -0
  153. package/skills/ai-research/03-fine-tuning/axolotl/references/index.md +16 -0
  154. package/skills/ai-research/03-fine-tuning/axolotl/references/other.md +3564 -0
  155. package/skills/ai-research/03-fine-tuning/llama-factory/SKILL.md +80 -0
  156. package/skills/ai-research/03-fine-tuning/llama-factory/references/_images.md +24 -0
  157. package/skills/ai-research/03-fine-tuning/llama-factory/references/advanced.md +1056 -0
  158. package/skills/ai-research/03-fine-tuning/llama-factory/references/getting_started.md +350 -0
  159. package/skills/ai-research/03-fine-tuning/llama-factory/references/index.md +20 -0
  160. package/skills/ai-research/03-fine-tuning/llama-factory/references/other.md +32 -0
  161. package/skills/ai-research/03-fine-tuning/peft/SKILL.md +431 -0
  162. package/skills/ai-research/03-fine-tuning/peft/references/advanced-usage.md +515 -0
  163. package/skills/ai-research/03-fine-tuning/peft/references/troubleshooting.md +481 -0
  164. package/skills/ai-research/03-fine-tuning/unsloth/SKILL.md +80 -0
  165. package/skills/ai-research/03-fine-tuning/unsloth/references/index.md +8 -0
  166. package/skills/ai-research/03-fine-tuning/unsloth/references/llms.md +83 -0
  167. package/skills/ai-research/04-mechanistic-interpretability/nnsight/SKILL.md +436 -0
  168. package/skills/ai-research/04-mechanistic-interpretability/nnsight/references/README.md +79 -0
  169. package/skills/ai-research/04-mechanistic-interpretability/nnsight/references/api.md +345 -0
  170. package/skills/ai-research/04-mechanistic-interpretability/nnsight/references/tutorials.md +301 -0
  171. package/skills/ai-research/04-mechanistic-interpretability/pyvene/SKILL.md +473 -0
  172. package/skills/ai-research/04-mechanistic-interpretability/pyvene/references/README.md +74 -0
  173. package/skills/ai-research/04-mechanistic-interpretability/pyvene/references/api.md +384 -0
  174. package/skills/ai-research/04-mechanistic-interpretability/pyvene/references/tutorials.md +377 -0
  175. package/skills/ai-research/04-mechanistic-interpretability/saelens/SKILL.md +386 -0
  176. package/skills/ai-research/04-mechanistic-interpretability/saelens/references/README.md +71 -0
  177. package/skills/ai-research/04-mechanistic-interpretability/saelens/references/api.md +334 -0
  178. package/skills/ai-research/04-mechanistic-interpretability/saelens/references/tutorials.md +319 -0
  179. package/skills/ai-research/04-mechanistic-interpretability/transformer-lens/SKILL.md +346 -0
  180. package/skills/ai-research/04-mechanistic-interpretability/transformer-lens/references/README.md +55 -0
  181. package/skills/ai-research/04-mechanistic-interpretability/transformer-lens/references/api.md +363 -0
  182. package/skills/ai-research/04-mechanistic-interpretability/transformer-lens/references/tutorials.md +340 -0
  183. package/skills/ai-research/05-data-processing/nemo-curator/SKILL.md +383 -0
  184. package/skills/ai-research/05-data-processing/nemo-curator/references/deduplication.md +88 -0
  185. package/skills/ai-research/05-data-processing/nemo-curator/references/filtering.md +103 -0
  186. package/skills/ai-research/05-data-processing/ray-data/SKILL.md +326 -0
  187. package/skills/ai-research/05-data-processing/ray-data/references/integration.md +83 -0
  188. package/skills/ai-research/05-data-processing/ray-data/references/transformations.md +84 -0
  189. package/skills/ai-research/06-post-training/grpo-rl-training/README.md +98 -0
  190. package/skills/ai-research/06-post-training/grpo-rl-training/SKILL.md +572 -0
  191. package/skills/ai-research/06-post-training/miles/SKILL.md +315 -0
  192. package/skills/ai-research/06-post-training/miles/references/api-reference.md +142 -0
  193. package/skills/ai-research/06-post-training/miles/references/troubleshooting.md +353 -0
  194. package/skills/ai-research/06-post-training/openrlhf/SKILL.md +249 -0
  195. package/skills/ai-research/06-post-training/openrlhf/references/algorithm-comparison.md +405 -0
  196. package/skills/ai-research/06-post-training/openrlhf/references/custom-rewards.md +531 -0
  197. package/skills/ai-research/06-post-training/openrlhf/references/hybrid-engine.md +288 -0
  198. package/skills/ai-research/06-post-training/openrlhf/references/multi-node-training.md +455 -0
  199. package/skills/ai-research/06-post-training/simpo/SKILL.md +219 -0
  200. package/skills/ai-research/06-post-training/simpo/references/datasets.md +479 -0
  201. package/skills/ai-research/06-post-training/simpo/references/hyperparameters.md +453 -0
  202. package/skills/ai-research/06-post-training/simpo/references/loss-functions.md +351 -0
  203. package/skills/ai-research/06-post-training/slime/SKILL.md +464 -0
  204. package/skills/ai-research/06-post-training/slime/references/api-reference.md +393 -0
  205. package/skills/ai-research/06-post-training/slime/references/troubleshooting.md +387 -0
  206. package/skills/ai-research/06-post-training/torchforge/SKILL.md +433 -0
  207. package/skills/ai-research/06-post-training/torchforge/references/api-reference.md +328 -0
  208. package/skills/ai-research/06-post-training/torchforge/references/troubleshooting.md +410 -0
  209. package/skills/ai-research/06-post-training/trl-fine-tuning/SKILL.md +455 -0
  210. package/skills/ai-research/06-post-training/trl-fine-tuning/references/dpo-variants.md +228 -0
  211. package/skills/ai-research/06-post-training/trl-fine-tuning/references/online-rl.md +83 -0
  212. package/skills/ai-research/06-post-training/trl-fine-tuning/references/reward-modeling.md +123 -0
  213. package/skills/ai-research/06-post-training/trl-fine-tuning/references/sft-training.md +169 -0
  214. package/skills/ai-research/06-post-training/verl/SKILL.md +391 -0
  215. package/skills/ai-research/06-post-training/verl/references/api-reference.md +302 -0
  216. package/skills/ai-research/06-post-training/verl/references/troubleshooting.md +392 -0
  217. package/skills/ai-research/07-safety-alignment/constitutional-ai/SKILL.md +290 -0
  218. package/skills/ai-research/07-safety-alignment/llamaguard/SKILL.md +337 -0
  219. package/skills/ai-research/07-safety-alignment/nemo-guardrails/SKILL.md +297 -0
  220. package/skills/ai-research/07-safety-alignment/prompt-guard/SKILL.md +312 -0
  221. package/skills/ai-research/08-distributed-training/accelerate/SKILL.md +332 -0
  222. package/skills/ai-research/08-distributed-training/accelerate/references/custom-plugins.md +454 -0
  223. package/skills/ai-research/08-distributed-training/accelerate/references/megatron-integration.md +490 -0
  224. package/skills/ai-research/08-distributed-training/accelerate/references/performance.md +526 -0
  225. package/skills/ai-research/08-distributed-training/deepspeed/SKILL.md +141 -0
  226. package/skills/ai-research/08-distributed-training/deepspeed/references/08.md +18 -0
  227. package/skills/ai-research/08-distributed-training/deepspeed/references/09.md +174 -0
  228. package/skills/ai-research/08-distributed-training/deepspeed/references/2020.md +379 -0
  229. package/skills/ai-research/08-distributed-training/deepspeed/references/2023.md +280 -0
  230. package/skills/ai-research/08-distributed-training/deepspeed/references/assets.md +180 -0
  231. package/skills/ai-research/08-distributed-training/deepspeed/references/index.md +36 -0
  232. package/skills/ai-research/08-distributed-training/deepspeed/references/mii.md +119 -0
  233. package/skills/ai-research/08-distributed-training/deepspeed/references/other.md +1192 -0
  234. package/skills/ai-research/08-distributed-training/megatron-core/SKILL.md +366 -0
  235. package/skills/ai-research/08-distributed-training/megatron-core/references/benchmarks.md +250 -0
  236. package/skills/ai-research/08-distributed-training/megatron-core/references/parallelism-guide.md +405 -0
  237. package/skills/ai-research/08-distributed-training/megatron-core/references/production-examples.md +474 -0
  238. package/skills/ai-research/08-distributed-training/megatron-core/references/training-recipes.md +548 -0
  239. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/SKILL.md +231 -0
  240. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_dcp_async_recipe.md +14 -0
  241. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_dcp_overview.md +19 -0
  242. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_dcp_recipe.md +18 -0
  243. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_ddp_notes.md +10 -0
  244. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_device_mesh_tutorial.md +22 -0
  245. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_examples_fsdp2.md +15 -0
  246. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_fsdp1_api.md +9 -0
  247. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_fsdp2_tutorial.md +45 -0
  248. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_fully_shard_api.md +49 -0
  249. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/pytorch_tp_tutorial.md +22 -0
  250. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/ray_train_fsdp2_example.md +13 -0
  251. package/skills/ai-research/08-distributed-training/pytorch-fsdp2/references/torchtitan_fsdp_notes.md +14 -0
  252. package/skills/ai-research/08-distributed-training/pytorch-lightning/SKILL.md +346 -0
  253. package/skills/ai-research/08-distributed-training/pytorch-lightning/references/callbacks.md +437 -0
  254. package/skills/ai-research/08-distributed-training/pytorch-lightning/references/distributed.md +491 -0
  255. package/skills/ai-research/08-distributed-training/pytorch-lightning/references/hyperparameter-tuning.md +557 -0
  256. package/skills/ai-research/08-distributed-training/ray-train/SKILL.md +406 -0
  257. package/skills/ai-research/08-distributed-training/ray-train/references/multi-node.md +629 -0
  258. package/skills/ai-research/09-infrastructure/lambda-labs/SKILL.md +545 -0
  259. package/skills/ai-research/09-infrastructure/lambda-labs/references/advanced-usage.md +612 -0
  260. package/skills/ai-research/09-infrastructure/lambda-labs/references/troubleshooting.md +531 -0
  261. package/skills/ai-research/09-infrastructure/modal/SKILL.md +341 -0
  262. package/skills/ai-research/09-infrastructure/modal/references/advanced-usage.md +504 -0
  263. package/skills/ai-research/09-infrastructure/modal/references/troubleshooting.md +495 -0
  264. package/skills/ai-research/09-infrastructure/skypilot/SKILL.md +509 -0
  265. package/skills/ai-research/09-infrastructure/skypilot/references/advanced-usage.md +492 -0
  266. package/skills/ai-research/09-infrastructure/skypilot/references/troubleshooting.md +571 -0
  267. package/skills/ai-research/10-optimization/awq/SKILL.md +310 -0
  268. package/skills/ai-research/10-optimization/awq/references/advanced-usage.md +325 -0
  269. package/skills/ai-research/10-optimization/awq/references/troubleshooting.md +345 -0
  270. package/skills/ai-research/10-optimization/bitsandbytes/SKILL.md +411 -0
  271. package/skills/ai-research/10-optimization/bitsandbytes/references/memory-optimization.md +522 -0
  272. package/skills/ai-research/10-optimization/bitsandbytes/references/qlora-training.md +522 -0
  273. package/skills/ai-research/10-optimization/bitsandbytes/references/quantization-formats.md +448 -0
  274. package/skills/ai-research/10-optimization/flash-attention/SKILL.md +367 -0
  275. package/skills/ai-research/10-optimization/flash-attention/references/benchmarks.md +216 -0
  276. package/skills/ai-research/10-optimization/flash-attention/references/transformers-integration.md +294 -0
  277. package/skills/ai-research/10-optimization/gguf/SKILL.md +427 -0
  278. package/skills/ai-research/10-optimization/gguf/references/advanced-usage.md +505 -0
  279. package/skills/ai-research/10-optimization/gguf/references/troubleshooting.md +443 -0
  280. package/skills/ai-research/10-optimization/gptq/SKILL.md +450 -0
  281. package/skills/ai-research/10-optimization/gptq/references/calibration.md +338 -0
  282. package/skills/ai-research/10-optimization/gptq/references/integration.md +130 -0
  283. package/skills/ai-research/10-optimization/gptq/references/troubleshooting.md +96 -0
  284. package/skills/ai-research/10-optimization/hqq/SKILL.md +445 -0
  285. package/skills/ai-research/10-optimization/hqq/references/advanced-usage.md +529 -0
  286. package/skills/ai-research/10-optimization/hqq/references/troubleshooting.md +504 -0
  287. package/skills/ai-research/10-optimization/ml-training-recipes/SKILL.md +319 -0
  288. package/skills/ai-research/10-optimization/ml-training-recipes/references/architecture.md +320 -0
  289. package/skills/ai-research/10-optimization/ml-training-recipes/references/biomedical.md +498 -0
  290. package/skills/ai-research/10-optimization/ml-training-recipes/references/domain-specific.md +626 -0
  291. package/skills/ai-research/10-optimization/ml-training-recipes/references/experiment-loop.md +129 -0
  292. package/skills/ai-research/10-optimization/ml-training-recipes/references/optimizers.md +330 -0
  293. package/skills/ai-research/10-optimization/ml-training-recipes/references/scaling-and-selection.md +428 -0
  294. package/skills/ai-research/11-evaluation/bigcode-evaluation-harness/SKILL.md +405 -0
  295. package/skills/ai-research/11-evaluation/bigcode-evaluation-harness/references/benchmarks.md +394 -0
  296. package/skills/ai-research/11-evaluation/bigcode-evaluation-harness/references/custom-tasks.md +425 -0
  297. package/skills/ai-research/11-evaluation/bigcode-evaluation-harness/references/issues.md +395 -0
  298. package/skills/ai-research/11-evaluation/lm-evaluation-harness/SKILL.md +490 -0
  299. package/skills/ai-research/11-evaluation/lm-evaluation-harness/references/api-evaluation.md +491 -0
  300. package/skills/ai-research/11-evaluation/lm-evaluation-harness/references/benchmark-guide.md +489 -0
  301. package/skills/ai-research/11-evaluation/lm-evaluation-harness/references/custom-tasks.md +603 -0
  302. package/skills/ai-research/11-evaluation/lm-evaluation-harness/references/distributed-eval.md +520 -0
  303. package/skills/ai-research/11-evaluation/nemo-evaluator/SKILL.md +494 -0
  304. package/skills/ai-research/11-evaluation/nemo-evaluator/references/adapter-system.md +341 -0
  305. package/skills/ai-research/11-evaluation/nemo-evaluator/references/configuration.md +448 -0
  306. package/skills/ai-research/11-evaluation/nemo-evaluator/references/custom-benchmarks.md +316 -0
  307. package/skills/ai-research/11-evaluation/nemo-evaluator/references/execution-backends.md +362 -0
  308. package/skills/ai-research/12-inference-serving/llama-cpp/SKILL.md +258 -0
  309. package/skills/ai-research/12-inference-serving/llama-cpp/references/optimization.md +90 -0
  310. package/skills/ai-research/12-inference-serving/llama-cpp/references/quantization.md +214 -0
  311. package/skills/ai-research/12-inference-serving/llama-cpp/references/server.md +126 -0
  312. package/skills/ai-research/12-inference-serving/sglang/SKILL.md +442 -0
  313. package/skills/ai-research/12-inference-serving/sglang/references/deployment.md +491 -0
  314. package/skills/ai-research/12-inference-serving/sglang/references/radix-attention.md +414 -0
  315. package/skills/ai-research/12-inference-serving/sglang/references/structured-generation.md +542 -0
  316. package/skills/ai-research/12-inference-serving/tensorrt-llm/SKILL.md +187 -0
  317. package/skills/ai-research/12-inference-serving/tensorrt-llm/references/multi-gpu.md +299 -0
  318. package/skills/ai-research/12-inference-serving/tensorrt-llm/references/optimization.md +243 -0
  319. package/skills/ai-research/12-inference-serving/tensorrt-llm/references/serving.md +471 -0
  320. package/skills/ai-research/12-inference-serving/vllm/SKILL.md +364 -0
  321. package/skills/ai-research/12-inference-serving/vllm/references/optimization.md +227 -0
  322. package/skills/ai-research/12-inference-serving/vllm/references/quantization.md +285 -0
  323. package/skills/ai-research/12-inference-serving/vllm/references/server-deployment.md +256 -0
  324. package/skills/ai-research/12-inference-serving/vllm/references/troubleshooting.md +448 -0
  325. package/skills/ai-research/13-mlops/mlflow/SKILL.md +704 -0
  326. package/skills/ai-research/13-mlops/mlflow/references/deployment.md +745 -0
  327. package/skills/ai-research/13-mlops/mlflow/references/model-registry.md +771 -0
  328. package/skills/ai-research/13-mlops/mlflow/references/tracking.md +681 -0
  329. package/skills/ai-research/13-mlops/swanlab/SKILL.md +406 -0
  330. package/skills/ai-research/13-mlops/swanlab/references/integrations.md +305 -0
  331. package/skills/ai-research/13-mlops/swanlab/references/visualization.md +234 -0
  332. package/skills/ai-research/13-mlops/tensorboard/SKILL.md +629 -0
  333. package/skills/ai-research/13-mlops/tensorboard/references/integrations.md +639 -0
  334. package/skills/ai-research/13-mlops/tensorboard/references/profiling.md +546 -0
  335. package/skills/ai-research/13-mlops/tensorboard/references/visualization.md +621 -0
  336. package/skills/ai-research/13-mlops/weights-and-biases/SKILL.md +590 -0
  337. package/skills/ai-research/13-mlops/weights-and-biases/references/artifacts.md +585 -0
  338. package/skills/ai-research/13-mlops/weights-and-biases/references/integrations.md +701 -0
  339. package/skills/ai-research/13-mlops/weights-and-biases/references/sweeps.md +848 -0
  340. package/skills/ai-research/14-agents/a-evolve/SKILL.md +383 -0
  341. package/skills/ai-research/14-agents/a-evolve/references/README.md +831 -0
  342. package/skills/ai-research/14-agents/a-evolve/references/api.md +594 -0
  343. package/skills/ai-research/14-agents/a-evolve/references/architecture.md +417 -0
  344. package/skills/ai-research/14-agents/a-evolve/references/design-patterns.md +462 -0
  345. package/skills/ai-research/14-agents/a-evolve/references/examples.md +352 -0
  346. package/skills/ai-research/14-agents/a-evolve/references/issues.md +591 -0
  347. package/skills/ai-research/14-agents/a-evolve/references/releases.md +112 -0
  348. package/skills/ai-research/14-agents/a-evolve/references/tutorials.md +819 -0
  349. package/skills/ai-research/14-agents/autogpt/SKILL.md +403 -0
  350. package/skills/ai-research/14-agents/autogpt/references/advanced-usage.md +536 -0
  351. package/skills/ai-research/14-agents/autogpt/references/troubleshooting.md +421 -0
  352. package/skills/ai-research/14-agents/crewai/SKILL.md +498 -0
  353. package/skills/ai-research/14-agents/crewai/references/flows.md +439 -0
  354. package/skills/ai-research/14-agents/crewai/references/tools.md +430 -0
  355. package/skills/ai-research/14-agents/crewai/references/troubleshooting.md +481 -0
  356. package/skills/ai-research/14-agents/langchain/SKILL.md +480 -0
  357. package/skills/ai-research/14-agents/langchain/references/agents.md +500 -0
  358. package/skills/ai-research/14-agents/langchain/references/integration.md +563 -0
  359. package/skills/ai-research/14-agents/langchain/references/rag.md +601 -0
  360. package/skills/ai-research/14-agents/llamaindex/SKILL.md +569 -0
  361. package/skills/ai-research/14-agents/llamaindex/references/agents.md +84 -0
  362. package/skills/ai-research/14-agents/llamaindex/references/data_connectors.md +109 -0
  363. package/skills/ai-research/14-agents/llamaindex/references/query_engines.md +407 -0
  364. package/skills/ai-research/15-rag/chroma/SKILL.md +406 -0
  365. package/skills/ai-research/15-rag/chroma/references/integration.md +39 -0
  366. package/skills/ai-research/15-rag/faiss/SKILL.md +221 -0
  367. package/skills/ai-research/15-rag/faiss/references/index_types.md +281 -0
  368. package/skills/ai-research/15-rag/pinecone/SKILL.md +358 -0
  369. package/skills/ai-research/15-rag/pinecone/references/deployment.md +182 -0
  370. package/skills/ai-research/15-rag/qdrant/SKILL.md +493 -0
  371. package/skills/ai-research/15-rag/qdrant/references/advanced-usage.md +649 -0
  372. package/skills/ai-research/15-rag/qdrant/references/troubleshooting.md +632 -0
  373. package/skills/ai-research/15-rag/sentence-transformers/SKILL.md +255 -0
  374. package/skills/ai-research/15-rag/sentence-transformers/references/models.md +124 -0
  375. package/skills/ai-research/16-prompt-engineering/dspy/SKILL.md +590 -0
  376. package/skills/ai-research/16-prompt-engineering/dspy/references/examples.md +664 -0
  377. package/skills/ai-research/16-prompt-engineering/dspy/references/modules.md +476 -0
  378. package/skills/ai-research/16-prompt-engineering/dspy/references/optimizers.md +567 -0
  379. package/skills/ai-research/16-prompt-engineering/guidance/SKILL.md +572 -0
  380. package/skills/ai-research/16-prompt-engineering/guidance/references/backends.md +555 -0
  381. package/skills/ai-research/16-prompt-engineering/guidance/references/constraints.md +675 -0
  382. package/skills/ai-research/16-prompt-engineering/guidance/references/examples.md +768 -0
  383. package/skills/ai-research/16-prompt-engineering/instructor/SKILL.md +740 -0
  384. package/skills/ai-research/16-prompt-engineering/instructor/references/examples.md +108 -0
  385. package/skills/ai-research/16-prompt-engineering/instructor/references/providers.md +71 -0
  386. package/skills/ai-research/16-prompt-engineering/instructor/references/validation.md +607 -0
  387. package/skills/ai-research/16-prompt-engineering/outlines/SKILL.md +652 -0
  388. package/skills/ai-research/16-prompt-engineering/outlines/references/backends.md +616 -0
  389. package/skills/ai-research/16-prompt-engineering/outlines/references/examples.md +774 -0
  390. package/skills/ai-research/16-prompt-engineering/outlines/references/json_generation.md +653 -0
  391. package/skills/ai-research/17-observability/langsmith/SKILL.md +422 -0
  392. package/skills/ai-research/17-observability/langsmith/references/advanced-usage.md +549 -0
  393. package/skills/ai-research/17-observability/langsmith/references/troubleshooting.md +538 -0
  394. package/skills/ai-research/17-observability/phoenix/SKILL.md +475 -0
  395. package/skills/ai-research/17-observability/phoenix/references/advanced-usage.md +620 -0
  396. package/skills/ai-research/17-observability/phoenix/references/troubleshooting.md +539 -0
  397. package/skills/ai-research/18-multimodal/audiocraft/SKILL.md +564 -0
  398. package/skills/ai-research/18-multimodal/audiocraft/references/advanced-usage.md +667 -0
  399. package/skills/ai-research/18-multimodal/audiocraft/references/troubleshooting.md +505 -0
  400. package/skills/ai-research/18-multimodal/blip-2/SKILL.md +564 -0
  401. package/skills/ai-research/18-multimodal/blip-2/references/advanced-usage.md +681 -0
  402. package/skills/ai-research/18-multimodal/blip-2/references/troubleshooting.md +527 -0
  403. package/skills/ai-research/18-multimodal/clip/SKILL.md +253 -0
  404. package/skills/ai-research/18-multimodal/clip/references/applications.md +208 -0
  405. package/skills/ai-research/18-multimodal/cosmos-policy/SKILL.md +402 -0
  406. package/skills/ai-research/18-multimodal/cosmos-policy/references/libero-commands.md +175 -0
  407. package/skills/ai-research/18-multimodal/cosmos-policy/references/robocasa-commands.md +147 -0
  408. package/skills/ai-research/18-multimodal/llava/SKILL.md +304 -0
  409. package/skills/ai-research/18-multimodal/llava/references/training.md +198 -0
  410. package/skills/ai-research/18-multimodal/openpi/SKILL.md +480 -0
  411. package/skills/ai-research/18-multimodal/openpi/references/checkpoints-and-env-map.md +86 -0
  412. package/skills/ai-research/18-multimodal/openpi/references/config-recipes.md +50 -0
  413. package/skills/ai-research/18-multimodal/openpi/references/pytorch-gotchas.md +49 -0
  414. package/skills/ai-research/18-multimodal/openpi/references/remote-client-pattern.md +48 -0
  415. package/skills/ai-research/18-multimodal/openpi/references/training-debugging.md +46 -0
  416. package/skills/ai-research/18-multimodal/openvla-oft/SKILL.md +441 -0
  417. package/skills/ai-research/18-multimodal/openvla-oft/references/aloha-workflow.md +141 -0
  418. package/skills/ai-research/18-multimodal/openvla-oft/references/config-troubleshooting.md +97 -0
  419. package/skills/ai-research/18-multimodal/openvla-oft/references/libero-workflow.md +115 -0
  420. package/skills/ai-research/18-multimodal/openvla-oft/references/paper-and-checkpoints.md +84 -0
  421. package/skills/ai-research/18-multimodal/segment-anything/SKILL.md +500 -0
  422. package/skills/ai-research/18-multimodal/segment-anything/references/advanced-usage.md +590 -0
  423. package/skills/ai-research/18-multimodal/segment-anything/references/troubleshooting.md +485 -0
  424. package/skills/ai-research/18-multimodal/stable-diffusion/SKILL.md +519 -0
  425. package/skills/ai-research/18-multimodal/stable-diffusion/references/advanced-usage.md +717 -0
  426. package/skills/ai-research/18-multimodal/stable-diffusion/references/troubleshooting.md +556 -0
  427. package/skills/ai-research/18-multimodal/whisper/SKILL.md +317 -0
  428. package/skills/ai-research/18-multimodal/whisper/references/languages.md +190 -0
  429. package/skills/ai-research/19-emerging-techniques/knowledge-distillation/SKILL.md +458 -0
  430. package/skills/ai-research/19-emerging-techniques/knowledge-distillation/references/minillm.md +335 -0
  431. package/skills/ai-research/19-emerging-techniques/long-context/SKILL.md +536 -0
  432. package/skills/ai-research/19-emerging-techniques/long-context/references/extension_methods.md +469 -0
  433. package/skills/ai-research/19-emerging-techniques/long-context/references/fine_tuning.md +612 -0
  434. package/skills/ai-research/19-emerging-techniques/long-context/references/rope.md +403 -0
  435. package/skills/ai-research/19-emerging-techniques/model-merging/SKILL.md +497 -0
  436. package/skills/ai-research/19-emerging-techniques/model-merging/references/coefficient-tuning.md +415 -0
  437. package/skills/ai-research/19-emerging-techniques/model-merging/references/evaluation.md +463 -0
  438. package/skills/ai-research/19-emerging-techniques/model-merging/references/examples.md +429 -0
  439. package/skills/ai-research/19-emerging-techniques/model-merging/references/methods.md +353 -0
  440. package/skills/ai-research/19-emerging-techniques/model-pruning/SKILL.md +495 -0
  441. package/skills/ai-research/19-emerging-techniques/model-pruning/references/wanda.md +348 -0
  442. package/skills/ai-research/19-emerging-techniques/moe-training/SKILL.md +526 -0
  443. package/skills/ai-research/19-emerging-techniques/moe-training/references/architectures.md +433 -0
  444. package/skills/ai-research/19-emerging-techniques/moe-training/references/inference.md +349 -0
  445. package/skills/ai-research/19-emerging-techniques/moe-training/references/training.md +426 -0
  446. package/skills/ai-research/19-emerging-techniques/speculative-decoding/SKILL.md +467 -0
  447. package/skills/ai-research/19-emerging-techniques/speculative-decoding/references/lookahead.md +310 -0
  448. package/skills/ai-research/19-emerging-techniques/speculative-decoding/references/medusa.md +351 -0
  449. package/skills/ai-research/20-ml-paper-writing/academic-plotting/SKILL.md +479 -0
  450. package/skills/ai-research/20-ml-paper-writing/academic-plotting/references/data-visualization.md +509 -0
  451. package/skills/ai-research/20-ml-paper-writing/academic-plotting/references/diagram-generation.md +395 -0
  452. package/skills/ai-research/20-ml-paper-writing/academic-plotting/references/style-guide.md +305 -0
  453. package/skills/ai-research/20-ml-paper-writing/ml-paper-writing/SKILL.md +982 -0
  454. package/skills/ai-research/20-ml-paper-writing/ml-paper-writing/references/checklists.md +348 -0
  455. package/skills/ai-research/20-ml-paper-writing/ml-paper-writing/references/citation-workflow.md +563 -0
  456. package/skills/ai-research/20-ml-paper-writing/ml-paper-writing/references/reviewer-guidelines.md +349 -0
  457. package/skills/ai-research/20-ml-paper-writing/ml-paper-writing/references/sources.md +165 -0
  458. package/skills/ai-research/20-ml-paper-writing/ml-paper-writing/references/writing-guide.md +477 -0
  459. package/skills/ai-research/20-ml-paper-writing/presenting-conference-talks/SKILL.md +298 -0
  460. package/skills/ai-research/20-ml-paper-writing/presenting-conference-talks/references/slide-templates.md +505 -0
  461. package/skills/ai-research/20-ml-paper-writing/systems-paper-writing/SKILL.md +270 -0
  462. package/skills/ai-research/20-ml-paper-writing/systems-paper-writing/references/checklist.md +279 -0
  463. package/skills/ai-research/20-ml-paper-writing/systems-paper-writing/references/reviewer-guidelines.md +116 -0
  464. package/skills/ai-research/20-ml-paper-writing/systems-paper-writing/references/section-blueprints.md +400 -0
  465. package/skills/ai-research/20-ml-paper-writing/systems-paper-writing/references/systems-conferences.md +261 -0
  466. package/skills/ai-research/20-ml-paper-writing/systems-paper-writing/references/writing-patterns.md +231 -0
  467. package/skills/ai-research/21-research-ideation/brainstorming-research-ideas/SKILL.md +384 -0
  468. package/skills/ai-research/21-research-ideation/creative-thinking-for-research/SKILL.md +366 -0
  469. package/skills/ai-research/22-agent-native-research-artifact/compiler/SKILL.md +245 -0
  470. package/skills/ai-research/22-agent-native-research-artifact/compiler/references/ara-schema.md +439 -0
  471. package/skills/ai-research/22-agent-native-research-artifact/compiler/references/exploration-tree-spec.md +125 -0
  472. package/skills/ai-research/22-agent-native-research-artifact/compiler/references/validation-checklist.md +149 -0
  473. package/skills/ai-research/22-agent-native-research-artifact/research-manager/SKILL.md +324 -0
  474. package/skills/ai-research/22-agent-native-research-artifact/research-manager/references/event-taxonomy.md +124 -0
  475. package/skills/ai-research/22-agent-native-research-artifact/research-manager/references/provenance-tags.md +190 -0
  476. package/skills/ai-research/22-agent-native-research-artifact/research-manager/references/session-protocol.md +162 -0
  477. package/skills/ai-research/22-agent-native-research-artifact/rigor-reviewer/SKILL.md +322 -0
  478. package/skills/ai-research/22-agent-native-research-artifact/rigor-reviewer/references/review-dimensions.md +182 -0
  479. package/skills/ai-research/SKILL.md +101 -0
  480. package/skills/ai-research/SOURCE +38 -0
  481. package/skills/ai-research/index/1-frame.md +18 -0
  482. package/skills/ai-research/index/2-data.md +21 -0
  483. package/skills/ai-research/index/3-train.md +48 -0
  484. package/skills/ai-research/index/4-measure.md +25 -0
  485. package/skills/ai-research/index/5-run.md +23 -0
  486. package/skills/ai-research/index/6-write.md +35 -0
  487. package/skills/ai-research/library.json +3456 -0
  488. package/skills/analyze-app/EVALS.md +82 -0
  489. package/skills/analyze-app/SKILL.md +188 -0
  490. package/skills/design-contract/EVALS.md +80 -0
  491. package/skills/design-contract/SKILL.md +171 -0
  492. package/skills/design-library/EVALS.md +85 -0
  493. package/skills/design-library/INDEX.md +59 -0
  494. package/skills/design-library/SKILL.md +58 -0
  495. package/skills/design-library/SOURCE +131 -0
  496. package/skills/design-library/adaptive-interfaces/skills/colour-independence/SKILL.md +90 -0
  497. package/skills/design-library/adaptive-interfaces/skills/flexible-typography/SKILL.md +83 -0
  498. package/skills/design-library/adaptive-interfaces/skills/information-density/SKILL.md +87 -0
  499. package/skills/design-library/adaptive-interfaces/skills/preference-audit/SKILL.md +70 -0
  500. package/skills/design-library/adaptive-interfaces/skills/responsive-accessibility/SKILL.md +86 -0
  501. package/skills/design-library/adaptive-interfaces/skills/responsive-review/SKILL.md +76 -0
  502. package/skills/design-library/adaptive-interfaces/skills/simplified-views/SKILL.md +97 -0
  503. package/skills/design-library/adaptive-interfaces/skills/specify/SKILL.md +63 -0
  504. package/skills/design-library/adaptive-interfaces/skills/user-preference-respect/SKILL.md +100 -0
  505. package/skills/design-library/cognitive-accessibility/skills/adaptive-personalisation/SKILL.md +61 -0
  506. package/skills/design-library/cognitive-accessibility/skills/assess-load/SKILL.md +48 -0
  507. package/skills/design-library/cognitive-accessibility/skills/cognitive-load-assessment/SKILL.md +60 -0
  508. package/skills/design-library/cognitive-accessibility/skills/contextual-help-design/SKILL.md +61 -0
  509. package/skills/design-library/cognitive-accessibility/skills/error-prevention-recovery/SKILL.md +71 -0
  510. package/skills/design-library/cognitive-accessibility/skills/focus-attention-design/SKILL.md +67 -0
  511. package/skills/design-library/cognitive-accessibility/skills/memory-load-reduction/SKILL.md +60 -0
  512. package/skills/design-library/cognitive-accessibility/skills/plain-language-design/SKILL.md +78 -0
  513. package/skills/design-library/cognitive-accessibility/skills/review/SKILL.md +56 -0
  514. package/skills/design-library/cognitive-accessibility/skills/simplify/SKILL.md +39 -0
  515. package/skills/design-library/cognitive-accessibility/skills/wayfinding-navigation/SKILL.md +64 -0
  516. package/skills/design-library/design-research/skills/behavioural-analytics/SKILL.md +33 -0
  517. package/skills/design-library/design-research/skills/qual-quant-triangulation/SKILL.md +33 -0
  518. package/skills/design-library/inclusive-interaction/skills/audit/SKILL.md +50 -0
  519. package/skills/design-library/inclusive-interaction/skills/design-flow/SKILL.md +58 -0
  520. package/skills/design-library/inclusive-interaction/skills/feedback-and-status/SKILL.md +76 -0
  521. package/skills/design-library/inclusive-interaction/skills/gesture-alternatives/SKILL.md +70 -0
  522. package/skills/design-library/inclusive-interaction/skills/keyboard-navigation/SKILL.md +99 -0
  523. package/skills/design-library/inclusive-interaction/skills/keyboard-review/SKILL.md +54 -0
  524. package/skills/design-library/inclusive-interaction/skills/motion-sensitivity/SKILL.md +79 -0
  525. package/skills/design-library/inclusive-interaction/skills/multi-modal-input/SKILL.md +70 -0
  526. package/skills/design-library/inclusive-interaction/skills/touch-target-design/SKILL.md +71 -0
  527. package/skills/design-library/inclusive-interaction/skills/voice-interaction/SKILL.md +68 -0
  528. package/skills/design-library/visual-critique/skills/critique-affordance/SKILL.md +45 -0
  529. package/skills/design-library/visual-critique/skills/critique-brand-consistency/SKILL.md +42 -0
  530. package/skills/design-library/visual-critique/skills/critique-color/SKILL.md +44 -0
  531. package/skills/design-library/visual-critique/skills/critique-composition/SKILL.md +46 -0
  532. package/skills/design-library/visual-critique/skills/critique-information-density/SKILL.md +45 -0
  533. package/skills/design-library/visual-critique/skills/critique-typography/SKILL.md +45 -0
  534. package/skills/design-library/visual-critique/skills/critique-visual-hierarchy/SKILL.md +40 -0
  535. package/skills/feature-audit/EVALS.md +83 -0
  536. package/skills/feature-audit/SKILL.md +326 -0
  537. package/skills/harness/EVALS.md +81 -0
  538. package/skills/harness/SKILL.md +88 -0
  539. package/skills/i-have-adhd/EVALS.md +80 -0
  540. package/skills/i-have-adhd/SKILL.md +183 -0
  541. package/skills/no-ai-slop/EVALS.md +89 -0
  542. package/skills/no-ai-slop/SKILL.md +209 -0
  543. package/skills/no-ai-slop/eval.md +52 -0
  544. package/skills/plan-add/EVALS.md +79 -0
  545. package/skills/plan-add/SKILL.md +179 -0
  546. package/skills/plan-add/render_table.py +72 -0
  547. package/skills/plan-status/EVALS.md +78 -0
  548. package/skills/plan-status/SKILL.md +52 -0
  549. package/skills/plan-sync/EVALS.md +80 -0
  550. package/skills/plan-sync/SKILL.md +69 -0
  551. package/skills/pm-frameworks/SKILL.md +33 -0
  552. package/skills/pm-frameworks/SOURCE +39 -0
  553. package/skills/pm-frameworks/intended-vs-implemented/SKILL.md +42 -0
  554. package/skills/pm-frameworks/opportunity-solution-tree/SKILL.md +64 -0
  555. package/skills/ponytail/EVALS.md +80 -0
  556. package/skills/ponytail/SKILL.md +124 -0
  557. package/skills/product-analysis/EVALS.md +103 -0
  558. package/skills/product-analysis/SKILL.md +361 -0
  559. package/skills/research/EVALS.md +104 -0
  560. package/skills/research/SKILL.md +570 -0
  561. package/skills/rl-env/SKILL.md +53 -0
  562. package/skills/rl-env/SOURCE +41 -0
  563. package/skills/rl-env/generate-nemo-gym-env/SKILL.md +169 -0
  564. package/skills/rl-env/generate-nemo-gym-env/references/architecture.md +114 -0
  565. package/skills/rl-env/generate-openenv-env/SKILL.md +183 -0
  566. package/skills/rl-env/generate-openenv-env/references/architecture.md +82 -0
  567. package/skills/rl-env/generate-ors-env/SKILL.md +209 -0
  568. package/skills/rl-env/generate-ors-env/references/architecture.md +113 -0
  569. package/skills/rl-env/generate-verifiers-env/SKILL.md +188 -0
  570. package/skills/rl-env/generate-verifiers-env/references/architecture.md +119 -0
  571. package/skills/rl-env/rl-env-from-description/SKILL.md +124 -0
  572. package/skills/rl-env/rl-env-from-description/references/interview.md +75 -0
  573. package/skills/rl-env/rl-env-from-description/references/nemo_gym.md +41 -0
  574. package/skills/rl-env/rl-env-from-description/references/openenv.md +35 -0
  575. package/skills/rl-env/rl-env-from-description/references/ors.md +50 -0
  576. package/skills/rl-env/rl-env-from-description/references/verifiers.md +39 -0
  577. package/skills/tezgah-contract/EVALS.md +78 -0
  578. package/skills/tezgah-contract/SKILL.md +792 -0
  579. package/statusline.py +129 -0
  580. package/workflows/graph-impact.js +153 -0
  581. package/workflows/graph-map.js +158 -0
  582. package/workflows/graph-review.js +170 -0
@@ -0,0 +1,231 @@
1
+ <!-- vendored from orchestra-research/AI-research-SKILLs@773a52944ba4747a18bd4ae9ade53fff041adcbc 20-ml-paper-writing/systems-paper-writing/references/writing-patterns.md; MIT (c) Orchestra Research -->
2
+ # Writing Patterns for Systems Papers
3
+
4
+ Four reusable structural patterns for organizing systems papers, with concrete examples from published work.
5
+
6
+ ---
7
+
8
+ ## Pattern 1: Gap Analysis
9
+
10
+ **When to use**: You have identified specific, enumerable shortcomings in existing systems that your work addresses one-by-one.
11
+
12
+ **Structure**:
13
+ ```text
14
+ Introduction:
15
+ G1: [Existing systems assume X, but workloads show Y]
16
+ G2: [Existing approach cannot handle scenario Z]
17
+ G3: [No existing system provides property W]
18
+ ...
19
+ "We present [System], which addresses G1–Gn through A1–An."
20
+
21
+ Design:
22
+ A1 → addresses G1: [Design component with rationale]
23
+ A2 → addresses G2: [Design component with rationale]
24
+ A3 → addresses G3: [Design component with rationale]
25
+ ...
26
+
27
+ Evaluation:
28
+ Experiment for G1/A1: [Metric showing A1 fixes G1]
29
+ Experiment for G2/A2: [Metric showing A2 fixes G2]
30
+ ...
31
+ ```
32
+
33
+ **Key property**: Creates a **traceable contract** — reviewers can verify that every claimed gap has a corresponding solution and evaluation.
34
+
35
+ ### Example: Lucid (ASPLOS'23)
36
+
37
+ Lucid identifies five gaps (G1–G5) in existing GPU cluster schedulers:
38
+
39
+ | Gap | Problem | Answer | Section |
40
+ |-----|---------|--------|---------|
41
+ | G1 | Schedulers ignore GPU heterogeneity | A1: Heterogeneity-aware placement | §3.1 |
42
+ | G2 | No adaptation to workload shifts | A2: Online learning adaptation | §3.2 |
43
+ | G3 | Locality assumptions break at scale | A3: Topology-aware scheduling | §3.3 |
44
+ | G4 | Fairness metrics don't account for GPU types | A4: Heterogeneity-fair allocation | §3.4 |
45
+ | G5 | Existing profiling is too expensive | A5: Lightweight profiling | §3.5 |
46
+
47
+ **Structural traits**:
48
+ - Each gap is stated with evidence from production traces (Azure, Alibaba)
49
+ - Each answer maps to a design subsection
50
+ - Evaluation mirrors the gap structure: one experiment per G→A pair
51
+
52
+ ### How to Apply This Pattern
53
+
54
+ 1. List all limitations of existing work as G1–Gn (typically 3–5)
55
+ 2. For each Gi, design an answering component Ai
56
+ 3. In the contribution list, state: "We identify G1–Gn and address them through A1–An"
57
+ 4. In evaluation, explicitly test each Gi→Ai mapping
58
+ 5. Use a summary table in Introduction or Related Work showing the gap-answer mapping
59
+
60
+ ---
61
+
62
+ ## Pattern 2: Observation-Driven
63
+
64
+ **When to use**: You have access to production data, workload traces, or empirical measurements that reveal surprising properties motivating your design.
65
+
66
+ **Structure**:
67
+ ```text
68
+ Background & Motivation:
69
+ Observation 1: [Data finding with figure/table]
70
+ → Insight 1: [What this means for design]
71
+ Observation 2: [Data finding with figure/table]
72
+ → Insight 2: [What this means for design]
73
+ Observation 3: [Data finding with figure/table]
74
+ → Insight 3: [What this means for design]
75
+
76
+ Design:
77
+ Insight 1 → Component A: [Design driven by O1]
78
+ Insight 2 → Component B: [Design driven by O2]
79
+ Insight 3 → Component C: [Design driven by O3]
80
+
81
+ Evaluation:
82
+ Show system handles the patterns identified in O1–O3
83
+ ```
84
+
85
+ **Key property**: Ground-truth data makes the motivation **irrefutable** — reviewers cannot argue the problem does not exist if you show production evidence.
86
+
87
+ ### Example: GFS (arXiv 2025 preprint)
88
+
89
+ GFS presents three observations from production GPU cluster traces:
90
+
91
+ | Observation | Finding | Design Insight | System Component |
92
+ |-------------|---------|----------------|-----------------|
93
+ | O1 | GPU fragmentation increases with heterogeneity | Fragment-aware allocation needed | Fragment-aware scheduler |
94
+ | O2 | Job arrival patterns are bursty, not Poisson | Reactive scheduling insufficient | Predictive admission control |
95
+ | O3 | Small jobs dominate count but large jobs dominate GPU-hours | Different policies for different sizes | Size-tiered scheduling |
96
+
97
+ **Structural traits**:
98
+ - Each observation backed by figures from real traces
99
+ - Clear arrow from observation → insight → design component
100
+ - Evaluation workloads reproduce the observed patterns
101
+
102
+ ### How to Apply This Pattern
103
+
104
+ 1. Analyze your production data or traces for 2–4 surprising findings
105
+ 2. Present each as "Observation N" with supporting figure/table
106
+ 3. Below each observation, state the design insight it implies
107
+ 4. In Design, reference back: "Motivated by O1 (§2), we design..."
108
+ 5. In Evaluation, use workloads that exhibit the observed patterns
109
+
110
+ ---
111
+
112
+ ## Pattern 3: Contribution List
113
+
114
+ **When to use**: Your system has multiple distinct contributions that span different technical areas (new abstraction + new algorithm + new implementation + new evaluation methodology).
115
+
116
+ **Structure**:
117
+ ```text
118
+ Introduction:
119
+ "This paper makes the following contributions:
120
+ 1. [Contribution type]: [Description] (§N)
121
+ 2. [Contribution type]: [Description] (§M)
122
+ 3. [Contribution type]: [Description] (§P)
123
+ 4. [Contribution type]: [Description] (§Q)"
124
+
125
+ Each section directly addresses one or more numbered contributions.
126
+
127
+ Evaluation:
128
+ Each experiment validates a specific contribution.
129
+ ```
130
+
131
+ **Key property**: Reviewers can **count and verify** contributions. Clear section cross-references make the paper navigable.
132
+
133
+ ### Example: Blox (EuroSys'24)
134
+
135
+ Blox lists 7 contributions covering the full system:
136
+
137
+ | # | Type | Contribution | Section |
138
+ |---|------|-------------|---------|
139
+ | 1 | Abstraction | Cluster state abstraction | §3.1 |
140
+ | 2 | Abstraction | Job state machine abstraction | §3.2 |
141
+ | 3 | Abstraction | Placement group abstraction | §3.3 |
142
+ | 4 | Abstraction | Metric collection abstraction | §3.4 |
143
+ | 5 | Abstraction | Policy composition abstraction | §3.5 |
144
+ | 6 | Abstraction | Simulation abstraction | §3.6 |
145
+ | 7 | System | Open-source simulator with 3 case studies | §4–§6 |
146
+
147
+ ### Example: Sia (SOSP'23)
148
+
149
+ Sia lists 5 primary contributions:
150
+
151
+ | # | Type | Contribution | Section |
152
+ |---|------|-------------|---------|
153
+ | 1 | Analysis | Heterogeneity opportunity analysis | §2 |
154
+ | 2 | Design | Throughput-fairness co-optimization | §3 |
155
+ | 3 | Algorithm | Adaptive resource allocation | §4 |
156
+ | 4 | System | Sia scheduler implementation | §5 |
157
+ | 5 | Evaluation | Evaluation on 3 production traces | §6 |
158
+
159
+ ### How to Apply This Pattern
160
+
161
+ 1. List contributions as numbered items (3–7 is typical)
162
+ 2. Tag each with a type: Analysis, Design, Algorithm, System, Evaluation
163
+ 3. Cross-reference sections: "(§N)"
164
+ 4. Ensure each contribution is **testable** — a reviewer should be able to verify it from the paper
165
+ 5. In evaluation, map experiments back to contribution numbers
166
+
167
+ ---
168
+
169
+ ## Pattern 4: Thesis Formula
170
+
171
+ **When to use**: Your paper has a single, strong central claim that can be expressed as a comparative statement.
172
+
173
+ **Structure** (Irene Zhang's formula):
174
+ ```text
175
+ Thesis: "X is better for applications Y running in environment Z"
176
+
177
+ Introduction: State the thesis clearly
178
+ Background: Define Y and Z, explain why they matter
179
+ Design: Explain how X achieves its advantage
180
+ Evaluation: Prove X is better for Y in Z
181
+ - Show X beats baselines on Y
182
+ - Show X works in environment Z
183
+ - Show X's advantage comes from its design choices (ablation)
184
+ ```
185
+
186
+ **Key property**: The entire paper serves a **single, memorable claim**. Reviewers can assess the paper by checking if the thesis is adequately supported.
187
+
188
+ ### How to Apply This Pattern
189
+
190
+ 1. Distill your contribution to one sentence: "[System] is better for [application] in [environment] because [insight]"
191
+ 2. In Abstract (sentence 3): state this thesis verbatim
192
+ 3. In Introduction: use it as the culmination of the gap analysis
193
+ 4. In Design: show how each component serves the thesis
194
+ 5. In Evaluation: directly test the thesis with appropriate baselines and workloads
195
+ 6. In Conclusion: restate the thesis with evidence from evaluation
196
+
197
+ ### Combining the Thesis Formula with Other Patterns
198
+
199
+ The thesis formula is **compositional** — it works as the top-level structure while other patterns fill in the details:
200
+
201
+ - Thesis + Gap Analysis: "X is better for Y in Z because it addresses G1–Gn"
202
+ - Thesis + Observation-Driven: "X is better for Y in Z; we discovered this through O1–O3"
203
+ - Thesis + Contribution List: "X is better for Y in Z; our contributions include C1–Cn"
204
+
205
+ ---
206
+
207
+ ## Pattern Selection Guide
208
+
209
+ | Your Situation | Recommended Pattern | Reason |
210
+ |---------------|-------------------|--------|
211
+ | Clear list of shortcomings in prior work | Gap Analysis | Traceable, easy for reviewers |
212
+ | Have production data or traces | Observation-Driven | Irrefutable motivation |
213
+ | Multiple distinct technical contributions | Contribution List | Countable, verifiable |
214
+ | One strong comparative claim | Thesis Formula | Focused, memorable |
215
+ | Complex system with data + gaps | Thesis + Gap + Observation | Combine for maximum impact |
216
+
217
+ ---
218
+
219
+ ## Anti-Patterns to Avoid
220
+
221
+ ### Anti-Pattern 1: Feature Dump
222
+ Listing system features without connecting them to problems or claims. Fix: use Gap Analysis or Thesis Formula to give every feature a purpose.
223
+
224
+ ### Anti-Pattern 2: Solution Looking for a Problem
225
+ Presenting the design before establishing why it is needed. Fix: use Observation-Driven to ground the design in real data.
226
+
227
+ ### Anti-Pattern 3: Vague Contributions
228
+ "We propose a novel system for X" — not testable, not verifiable. Fix: use Contribution List with specific, measurable claims.
229
+
230
+ ### Anti-Pattern 4: Missing Alternatives
231
+ Presenting design choices as the only option. Fix: for every major decision, discuss at least one alternative and why it was rejected (Irene Zhang's rule).
@@ -0,0 +1,384 @@
1
+ ---
2
+ name: brainstorming-research-ideas
3
+ description: Guides researchers through structured ideation frameworks to discover high-impact research directions. Use when exploring new problem spaces, pivoting between projects, or seeking novel angles on existing work.
4
+ version: 1.0.0
5
+ author: Orchestra Research
6
+ license: MIT
7
+ tags: [Research Ideation, Brainstorming, Problem Discovery, Creative Thinking, Research Strategy]
8
+ dependencies: []
9
+ ---
10
+
11
+ # Research Idea Brainstorming
12
+
13
+ Structured frameworks for discovering the next research idea. This skill provides ten complementary ideation lenses that help researchers move from vague curiosity to concrete, defensible research proposals. Each framework targets a different cognitive mode—use them individually or combine them for comprehensive exploration.
14
+
15
+ ## When to Use This Skill
16
+
17
+ - Starting a new research direction and need structured exploration
18
+ - Feeling stuck on a current project and want fresh angles
19
+ - Evaluating whether a half-formed idea has real potential
20
+ - Preparing for a brainstorming session with collaborators
21
+ - Transitioning between research areas and seeking high-leverage entry points
22
+ - Reviewing a field and looking for underexplored gaps
23
+
24
+ **Do NOT use this skill when**:
25
+ - You already have a well-defined research question and need execution guidance
26
+ - You need help with experimental design or methodology (use domain-specific skills)
27
+ - You want a literature review (use `scientific-skills:literature-review`)
28
+
29
+ ---
30
+
31
+ ## Core Ideation Frameworks
32
+
33
+ ### 1. Problem-First vs. Solution-First Thinking
34
+
35
+ Research ideas originate from two distinct modes. Knowing which mode you are in prevents a common failure: building solutions that lack real problems, or chasing problems without feasible approaches.
36
+
37
+ **Problem-First** (pain point → method):
38
+ - Start with a concrete failure, bottleneck, or unmet need
39
+ - Naturally yields impactful work because the motivation is intrinsic
40
+ - Risk: may converge on incremental fixes rather than paradigm shifts
41
+
42
+ **Solution-First** (new capability → application):
43
+ - Start with a new tool, insight, or technique seeking application
44
+ - Often drives breakthroughs by unlocking previously impossible approaches
45
+ - Risk: "hammer looking for a nail"—solution may lack genuine demand
46
+
47
+ **Workflow**:
48
+ 1. Write down your idea in one sentence
49
+ 2. Classify it: Is this problem-first or solution-first?
50
+ 3. If problem-first → verify the problem matters (who suffers? how much?)
51
+ 4. If solution-first → identify at least two genuine problems it addresses
52
+ 5. For either mode, articulate the gap: what cannot be done today that this enables?
53
+
54
+ **Self-Check**:
55
+ - [ ] Can I name a specific person or community who needs this?
56
+ - [ ] Is the problem I am solving actually unsolved (not just under-marketed)?
57
+ - [ ] If solution-first, does the solution create new capability or just replicate existing ones?
58
+
59
+ ---
60
+
61
+ ### 2. The Abstraction Ladder
62
+
63
+ Every research problem sits at a particular level of abstraction. Deliberately moving up or down the ladder reveals ideas invisible at your current level.
64
+
65
+ | Direction | Action | Outcome |
66
+ |-----------|--------|---------|
67
+ | **Move Up** (generalize) | Turn a specific result into a broader principle | Framework papers, theoretical contributions |
68
+ | **Move Down** (instantiate) | Test a general paradigm under concrete constraints | Empirical papers, surprising failure analyses |
69
+ | **Move Sideways** (analogize) | Apply same abstraction level to adjacent domain | Cross-pollination, transfer papers |
70
+
71
+ **Workflow**:
72
+ 1. State your current research focus in one sentence
73
+ 2. Move UP: What is the general principle behind this? What class of problems does this belong to?
74
+ 3. Move DOWN: What is the most specific, constrained instance of this? What happens at the extreme?
75
+ 4. Move SIDEWAYS: Where else does this pattern appear in a different field?
76
+ 5. For each new level, ask: Is this a publishable contribution on its own?
77
+
78
+ **Example**:
79
+ - **Current**: "Improving retrieval accuracy for RAG systems"
80
+ - **Up**: "What makes context selection effective for any augmented generation system?"
81
+ - **Down**: "How does retrieval accuracy degrade when documents are adversarially perturbed?"
82
+ - **Sideways**: "Database query optimization uses similar relevance ranking—what can we borrow?"
83
+
84
+ ---
85
+
86
+ ### 3. Tension and Contradiction Hunting
87
+
88
+ Breakthroughs often come from resolving tensions between widely accepted but seemingly conflicting goals. These contradictions are not bugs—they are the research opportunity.
89
+
90
+ **Common Research Tensions**:
91
+
92
+ | Tension Pair | Research Opportunity |
93
+ |-------------|---------------------|
94
+ | Performance ↔ Efficiency | Can we match SOTA with 10x less compute? |
95
+ | Privacy ↔ Utility | Can federated/encrypted methods close the accuracy gap? |
96
+ | Generality ↔ Specialization | When does fine-tuning beat prompting, and why? |
97
+ | Safety ↔ Capability | Can alignment improve rather than tax capability? |
98
+ | Interpretability ↔ Performance | Do mechanistic insights enable better architectures? |
99
+ | Scale ↔ Accessibility | Can small models replicate emergent behaviors? |
100
+
101
+ **Workflow**:
102
+ 1. Pick your research area
103
+ 2. List the top 3-5 desiderata (things everyone wants)
104
+ 3. Identify pairs that are commonly treated as trade-offs
105
+ 4. For each pair, ask: Is this trade-off fundamental or an artifact of current methods?
106
+ 5. If artifact → the reconciliation IS your research contribution
107
+ 6. If fundamental → characterizing the Pareto frontier is itself valuable
108
+
109
+ **Self-Check**:
110
+ - [ ] Have I confirmed this tension is real (not just assumed)?
111
+ - [ ] Can I point to papers that optimize for each side independently?
112
+ - [ ] Is my proposed reconciliation technically plausible, not just aspirational?
113
+
114
+ ---
115
+
116
+ ### 4. Cross-Pollination (Analogy Transfer)
117
+
118
+ Borrowing structural ideas from other disciplines is one of the most generative research heuristics. Many foundational techniques emerged this way—attention mechanisms draw from cognitive science, genetic algorithms from biology, adversarial training from game theory.
119
+
120
+ **Requirements for a Valid Analogy**:
121
+ - **Structural fidelity**: The mapping must hold at the level of underlying mechanisms, not just surface similarity
122
+ - **Non-obvious connection**: If the link is well-known, the novelty is gone
123
+ - **Testable predictions**: The analogy should generate concrete hypotheses
124
+
125
+ **High-Yield Source Fields for ML Research**:
126
+
127
+ | Source Field | Transferable Concepts |
128
+ |-------------|----------------------|
129
+ | Neuroscience | Attention, memory consolidation, hierarchical processing |
130
+ | Physics | Energy-based models, phase transitions, renormalization |
131
+ | Economics | Mechanism design, auction theory, incentive alignment |
132
+ | Ecology | Population dynamics, niche competition, co-evolution |
133
+ | Linguistics | Compositionality, pragmatics, grammatical induction |
134
+ | Control Theory | Feedback loops, stability, adaptive regulation |
135
+
136
+ **Workflow**:
137
+ 1. Describe your problem in domain-agnostic language (strip the jargon)
138
+ 2. Ask: What other field solves a structurally similar problem?
139
+ 3. Study that field's solution at the mechanism level
140
+ 4. Map the solution back to your domain, preserving structural relationships
141
+ 5. Generate testable predictions from the analogy
142
+ 6. Validate: Does the borrowed idea actually improve outcomes?
143
+
144
+ ---
145
+
146
+ ### 5. The "What Changed?" Principle
147
+
148
+ Strong ideas often come from revisiting old problems under new conditions. Advances in hardware, scale, data availability, or regulations can invalidate prior assumptions and make previously impractical approaches viable.
149
+
150
+ **Categories of Change to Monitor**:
151
+
152
+ | Change Type | Example | Research Implication |
153
+ |------------|---------|---------------------|
154
+ | **Compute** | GPUs 10x faster | Methods dismissed as too expensive become feasible |
155
+ | **Scale** | Trillion-token datasets | Statistical arguments that failed at small scale may now hold |
156
+ | **Regulation** | EU AI Act, GDPR | Creates demand for compliant alternatives |
157
+ | **Tooling** | New frameworks, APIs | Reduces implementation barrier for complex methods |
158
+ | **Failure** | High-profile system failures | Exposes gaps in existing approaches |
159
+ | **Cultural** | New user behaviors | Shifts what problems matter most |
160
+
161
+ **Workflow**:
162
+ 1. Pick a well-known negative result or abandoned approach (3-10 years old)
163
+ 2. List the assumptions that led to its rejection
164
+ 3. For each assumption, ask: Is this still true today?
165
+ 4. If any assumption has been invalidated → re-run the idea under new conditions
166
+ 5. Frame the contribution: "X was previously impractical because Y, but Z has changed"
167
+
168
+ ---
169
+
170
+ ### 6. Failure Analysis and Boundary Probing
171
+
172
+ Understanding where a method breaks is often as valuable as showing where it works. Boundary probing systematically exposes the conditions under which accepted techniques fail.
173
+
174
+ **Types of Boundaries to Probe**:
175
+ - **Distributional**: What happens with out-of-distribution inputs?
176
+ - **Scale**: Does the method degrade at 10x or 0.1x the typical scale?
177
+ - **Adversarial**: Can the method be deliberately broken?
178
+ - **Compositional**: Does performance hold when combining multiple capabilities?
179
+ - **Temporal**: Does the method degrade over time (concept drift)?
180
+
181
+ **Workflow**:
182
+ 1. Select a widely-used method with strong reported results
183
+ 2. Identify the implicit assumptions in its evaluation (dataset, scale, domain)
184
+ 3. Systematically violate each assumption
185
+ 4. Document where and how the method breaks
186
+ 5. Diagnose the root cause of each failure
187
+ 6. Propose a fix or explain why the failure is fundamental
188
+
189
+ **Self-Check**:
190
+ - [ ] Am I probing genuine boundaries, not just confirming known limitations?
191
+ - [ ] Can I explain WHY the method fails, not just THAT it fails?
192
+ - [ ] Does my analysis suggest a constructive path forward?
193
+
194
+ ---
195
+
196
+ ### 7. The Simplicity Test
197
+
198
+ Before accepting complexity, ask whether a simpler approach suffices. Fields sometimes over-index on elaborate solutions when a streamlined baseline performs competitively.
199
+
200
+ **Warning Signs of Unnecessary Complexity**:
201
+ - The method has many hyperparameters with narrow optimal ranges
202
+ - Ablations show most components contribute marginally
203
+ - A simple baseline was never properly tuned or evaluated
204
+ - The improvement over baselines is within noise on most benchmarks
205
+
206
+ **Workflow**:
207
+ 1. Identify the current SOTA method for your problem
208
+ 2. Strip it to its simplest possible core (what is the one key idea?)
209
+ 3. Build that minimal version with careful engineering
210
+ 4. Compare fairly: same compute budget, same tuning effort
211
+ 5. If the gap is small → the contribution is the simplicity itself
212
+ 6. If the gap is large → you now understand what the complexity buys
213
+
214
+ **Contribution Framing**:
215
+ - "We show that [simple method] with [one modification] matches [complex SOTA]"
216
+ - "We identify [specific component] as the critical driver, not [other components]"
217
+
218
+ ---
219
+
220
+ ### 8. Stakeholder Rotation
221
+
222
+ Viewing a system from multiple perspectives reveals distinct classes of research questions. Each stakeholder sees different friction, risk, and opportunity.
223
+
224
+ **Stakeholder Perspectives**:
225
+
226
+ | Stakeholder | Key Questions |
227
+ |-------------|---------------|
228
+ | **End User** | Is this usable? What errors are unacceptable? What is the latency tolerance? |
229
+ | **Developer** | Is this debuggable? What is the maintenance burden? How does it compose? |
230
+ | **Theorist** | Why does this work? What are the formal guarantees? Where are the gaps? |
231
+ | **Adversary** | How can this be exploited? What are the attack surfaces? |
232
+ | **Ethicist** | Who is harmed? What biases are embedded? Who is excluded? |
233
+ | **Regulator** | Is this auditable? Can decisions be explained? Is there accountability? |
234
+ | **Operator** | What is the cost? How does it scale? What is the failure mode? |
235
+
236
+ **Workflow**:
237
+ 1. Describe your system or method in one paragraph
238
+ 2. Assume each stakeholder perspective in turn (spend 5 minutes per role)
239
+ 3. For each perspective, list the top 3 concerns or questions
240
+ 4. Identify which concerns are unaddressed by existing work
241
+ 5. The unaddressed concern with the broadest impact is your research question
242
+
243
+ ---
244
+
245
+ ### 9. Composition and Decomposition
246
+
247
+ Novelty often emerges from recombination or modularization. Innovation frequently lies not in new primitives, but in how components are arranged or separated.
248
+
249
+ **Composition** (combining existing techniques):
250
+ - Identify two methods that solve complementary subproblems
251
+ - Ask: What emergent capability arises from combining them?
252
+ - Example: RAG + Chain-of-Thought → retrieval-augmented reasoning
253
+
254
+ **Decomposition** (breaking apart monolithic systems):
255
+ - Identify a complex system with entangled components
256
+ - Ask: Which component is the actual bottleneck?
257
+ - Example: Decomposing "fine-tuning" into data selection, optimization, and regularization reveals that data selection often matters most
258
+
259
+ **Workflow**:
260
+ 1. List the 5-10 key components or techniques in your area
261
+ 2. **Compose**: Pick pairs and ask what happens when you combine them
262
+ 3. **Decompose**: Pick a complex method and isolate each component's contribution
263
+ 4. For compositions: Does the combination create emergent capabilities?
264
+ 5. For decompositions: Does isolation reveal a dominant or redundant component?
265
+
266
+ ---
267
+
268
+ ### 10. The "Explain It to Someone" Test
269
+
270
+ A strong research idea should be defensible in two sentences to a smart non-expert. This test enforces clarity of purpose and sharpens the value proposition.
271
+
272
+ **The Two-Sentence Template**:
273
+ > **Sentence 1** (Problem): "[Domain] currently struggles with [specific problem], which matters because [concrete consequence]."
274
+ > **Sentence 2** (Insight): "We [approach] by [key mechanism], which works because [reason]."
275
+
276
+ **If You Cannot Fill This Template**:
277
+ - The problem may not be well-defined yet → return to Framework 1
278
+ - The insight may not be clear yet → return to Framework 7 (simplify)
279
+ - The significance may not be established → return to Framework 3 (find the tension)
280
+
281
+ **Calibration Questions**:
282
+ - Would a smart colleague outside your subfield understand why this matters?
283
+ - Does the explanation stand without jargon?
284
+ - Can you predict what a skeptic's first objection would be?
285
+
286
+ ---
287
+
288
+ ## Integrated Brainstorming Workflow
289
+
290
+ Use this end-to-end workflow to go from blank page to ranked research ideas.
291
+
292
+ ### Phase 1: Diverge (Generate Candidates)
293
+
294
+ **Goal**: Produce 10-20 candidate ideas without filtering.
295
+
296
+ 1. **Scan for tensions** (Framework 3): List 5 trade-offs in your field
297
+ 2. **Check what changed** (Framework 5): List 3 recent shifts (compute, data, regulation)
298
+ 3. **Probe boundaries** (Framework 6): Pick 2 popular methods and find where they break
299
+ 4. **Cross-pollinate** (Framework 4): Pick 1 idea from an adjacent field
300
+ 5. **Compose/decompose** (Framework 9): Combine 2 existing techniques or split 1 apart
301
+ 6. **Climb the abstraction ladder** (Framework 2): For each candidate, generate up/down/sideways variants
302
+
303
+ ### Phase 2: Converge (Filter and Rank)
304
+
305
+ **Goal**: Narrow to 3-5 strongest ideas.
306
+
307
+ Apply these filters to each candidate:
308
+
309
+ | Filter | Question | Kill Criterion |
310
+ |--------|----------|----------------|
311
+ | **Explain-It Test** (F10) | Can I state this in two sentences? | If no → idea is not yet clear |
312
+ | **Problem-First Check** (F1) | Is the problem genuine and important? | If no one suffers from this → drop it |
313
+ | **Simplicity Test** (F7) | Is the complexity justified? | If a simpler approach works → simplify or drop |
314
+ | **Stakeholder Check** (F8) | Who benefits? Who might object? | If no clear beneficiary → drop it |
315
+ | **Feasibility** | Can I execute this with available resources? | If clearly infeasible → park it for later |
316
+
317
+ ### Phase 3: Refine (Sharpen the Winner)
318
+
319
+ **Goal**: Turn the top idea into a concrete research plan.
320
+
321
+ 1. Write the two-sentence pitch (Framework 10)
322
+ 2. Identify the core tension being resolved (Framework 3)
323
+ 3. Specify the abstraction level (Framework 2)
324
+ 4. List 3 concrete experiments that would validate the idea
325
+ 5. Anticipate the strongest objection and prepare a response
326
+ 6. Define a 2-week pilot that would provide signal on feasibility
327
+
328
+ **Completion Checklist**:
329
+ - [ ] Two-sentence pitch is clear and compelling
330
+ - [ ] Problem is genuine (problem-first check passed)
331
+ - [ ] Approach is justified (simplicity test passed)
332
+ - [ ] At least one stakeholder clearly benefits
333
+ - [ ] Core experiments are specified
334
+ - [ ] Feasibility pilot is defined
335
+ - [ ] Strongest objection has a response
336
+
337
+ ---
338
+
339
+ ## Framework Selection Guide
340
+
341
+ Not sure which framework to start with? Use this decision guide:
342
+
343
+ | Your Situation | Start With |
344
+ |---------------|------------|
345
+ | "I don't know what area to work in" | Tension Hunting (F3) → What Changed (F5) |
346
+ | "I have a vague area but no specific idea" | Abstraction Ladder (F2) → Failure Analysis (F6) |
347
+ | "I have an idea but I'm not sure it's good" | Explain-It Test (F10) → Simplicity Test (F7) |
348
+ | "I have a good idea but need a fresh angle" | Cross-Pollination (F4) → Stakeholder Rotation (F8) |
349
+ | "I want to combine existing work into something new" | Composition/Decomposition (F9) |
350
+ | "I found a cool technique and want to apply it" | Problem-First Check (F1) → Stakeholder Rotation (F8) |
351
+ | "I want to challenge conventional wisdom" | Failure Analysis (F6) → Simplicity Test (F7) |
352
+
353
+ ---
354
+
355
+ ## Common Pitfalls in Research Ideation
356
+
357
+ | Pitfall | Symptom | Fix |
358
+ |---------|---------|-----|
359
+ | **Novelty without impact** | "No one has done X" but no one needs X | Apply Problem-First Check (F1) |
360
+ | **Incremental by default** | Idea is +2% on a benchmark | Climb the Abstraction Ladder (F2) |
361
+ | **Complexity worship** | Method has 8 components, each helping marginally | Apply Simplicity Test (F7) |
362
+ | **Echo chamber** | All ideas come from reading the same 10 papers | Use Cross-Pollination (F4) |
363
+ | **Stale assumptions** | "This was tried and didn't work" (5 years ago) | Apply What Changed (F5) |
364
+ | **Single-perspective bias** | Only considering the ML engineer's view | Use Stakeholder Rotation (F8) |
365
+ | **Premature convergence** | Committed to first idea without exploring alternatives | Run full Diverge phase |
366
+
367
+ ---
368
+
369
+ ## Usage Instructions for Agents
370
+
371
+ When a researcher asks for help brainstorming research ideas:
372
+
373
+ 1. **Identify their starting point**: Are they exploring a new area, stuck on a current project, or evaluating an existing idea?
374
+ 2. **Select appropriate frameworks**: Use the Framework Selection Guide to pick 2-3 relevant lenses
375
+ 3. **Walk through frameworks interactively**: Apply each framework step-by-step, asking the researcher for domain-specific inputs
376
+ 4. **Generate candidates**: Aim for 10-20 raw ideas across frameworks
377
+ 5. **Filter and rank**: Apply the Converge phase filters to narrow to top 3-5
378
+ 6. **Refine the winner**: Help articulate the two-sentence pitch and define concrete next steps
379
+
380
+ **Key Principles**:
381
+ - Push for specificity—vague ideas ("improve efficiency") are not actionable
382
+ - Challenge assumptions—ask "why?" at least three times
383
+ - Maintain a written list of all candidates, even rejected ones (they may recombine later)
384
+ - The researcher makes the final call on which ideas to pursue; the agent facilitates structured thinking