Merge pull request #21 from plotday/change/generate-agent-guide

Generate agent guide

Author: KrisBraun

.changeset/tall-rules-tap.md

@@ -0,0 +1,5 @@
+---
+"@plotday/sdk": patch
+---
+
+Changed: Generate agent-guide.ts from AGENT.template.md

sdk/cli/templates/AGENTS.template.md

@@ -382,6 +382,8 @@ try {
 6. **Clean up callbacks and stored state** - Delete callbacks and Store entries when no longer needed.
 7. **Handle missing auth gracefully** - Check for stored auth before operations.
 8. **Batch size matters** - Process enough items per batch to be efficient, but few enough to stay under time limits.
+9. **Processing self-created activities** - Other users may change an Activity created by the agent, resulting in an \`activity\` call. Be sure to check the \`changes === null\` and/or \`activity.author.id !== this.id\` to avoid re-processing.
+10. Activity with type ActivityType.Note typically do not have a start or end set, unless they're a note about a specific day or time that shouldn't be shown until then.
 
 ## Type Patterns
 

sdk/prebuild.ts

@@ -153,4 +153,24 @@ export default llmDocs;
 const indexPath = join(llmDocsDir, "index.ts");
 writeFileSync(indexPath, indexContent, "utf-8");
 
+// Generate agents-guide-template.ts from AGENTS.template.md
+const agentsTemplatePath = join(__dirname, "cli", "templates", "AGENTS.template.md");
+if (existsSync(agentsTemplatePath)) {
+  const agentsTemplateContent = readFileSync(agentsTemplatePath, "utf-8");
+  const agentsGuideContent = `/**
+ * Generated agents guide template
+ *
+ * This file is auto-generated during build. Do not edit manually.
+ * Generated from: cli/templates/AGENTS.template.md
+ */
+
+export default ${JSON.stringify(agentsTemplateContent)};
+`;
+  const agentsGuideOutputPath = join(llmDocsDir, "agents-guide-template.ts");
+  writeFileSync(agentsGuideOutputPath, agentsGuideContent, "utf-8");
+  console.log(`✓ Generated agents-guide-template.ts from AGENTS.template.md`);
+} else {
+  console.warn(`Warning: AGENTS.template.md not found at ${agentsTemplatePath}`);
+}
+
 console.log(`✓ Generated ${typeFiles.length} LLM documentation files in src/llm-docs/`);