@rely-ai/caliber 1.29.4 → 1.30.0-dev.1774189509

package/dist/bin.js

@@ -2381,7 +2381,16 @@ For command sections, use code blocks with one command per line.
 
 - Each skill content: max 150 lines. Focus on patterns and examples, not exhaustive docs.
 - Cursor rules: max 5 .mdc files.
-- If the project is large, prioritize depth on the 3-4 most critical tools over breadth across everything.`;
+- If the project is large, prioritize depth on the 3-4 most critical tools over breadth across everything.
+
+CONVENTIONS SECTION PRIORITY \u2014 this is the highest-value section for agent performance:
+The Conventions section determines whether agents choose correct, project-consistent solutions vs technically clever but fragile ones. Prioritize:
+1. Error handling patterns \u2014 does the project use try/except, Result types, or assertions? Show the actual pattern with a code example.
+2. Backward compatibility approach \u2014 does the project prefer duck typing (try/except TypeError) over introspection (inspect.signature)? Defensive patterns over clever ones?
+3. Testing infrastructure \u2014 test runner, key fixtures, how to add a new test. Agents that understand the test infra write tests that pass.
+4. "Prefer X over Y" guidelines \u2014 for common trade-offs in this codebase (e.g. "prefer composition over inheritance", "prefer simple try/except over type checking").
+5. Anti-patterns \u2014 2-3 specific things NOT to do in this codebase. These prevent agents from choosing overengineered solutions.
+Keep this section tight \u2014 bullet points, not prose. Each line should be a decision rule an agent can act on.`;
 var GENERATION_SYSTEM_PROMPT = `${ROLE_AND_CONTEXT}
 
 ${CONFIG_FILE_TYPES}
@@ -2500,7 +2509,8 @@ Structure:
    - Have a validation gate: "Verify X before proceeding to the next step"
    - Specify dependencies: "This step uses the output from Step N"
 4. "## Examples" \u2014 at least one example showing: User says \u2192 Actions taken \u2192 Result. The example should mirror how existing code in the project is structured.
-5. "## Common Issues" (required) \u2014 specific error messages and their fixes. Not "check your config" but "If you see 'Connection refused on port 5432': 1. Verify postgres is running: docker ps | grep postgres 2. Check .env has correct DATABASE_URL"
+5. "## Anti-patterns" (required) \u2014 2-3 specific approaches to AVOID, with the correct alternative. Focus on cases where the "clever" solution breaks things. Example: "Do NOT use inspect.signature() to check function parameters \u2014 use try/except TypeError instead. The introspection approach breaks with decorated functions and functools.partial."
+6. "## Common Issues" (required) \u2014 specific error messages and their fixes. Not "check your config" but "If you see 'Connection refused on port 5432': 1. Verify postgres is running: docker ps | grep postgres 2. Check .env has correct DATABASE_URL"
 
 Rules:
 - Max 150 lines. Focus on actionable instructions, not documentation prose.
@@ -4264,11 +4274,38 @@ function appendLearningsBlock(content) {
 function getCursorLearningsRule() {
   return { filename: CURSOR_LEARNINGS_FILENAME, content: CURSOR_LEARNINGS_CONTENT };
 }
+var SKILLS_HEADING = "## Available Skills";
+function truncateDescription(description) {
+  const match = description.match(/^[^.]*\.\s/);
+  if (match) return match[0].trim();
+  if (description.length > 80) return description.slice(0, 77) + "...";
+  return description;
+}
+function appendSkillListing(content, skills, pathPrefix) {
+  if (skills.length === 0) return content;
+  if (content.includes(SKILLS_HEADING)) return content;
+  const lines = [
+    "",
+    SKILLS_HEADING,
+    "",
+    "The following skill files are available in this repo. Read them when working on related areas:",
+    ""
+  ];
+  for (const skill of skills) {
+    const shortDesc = truncateDescription(skill.description);
+    lines.push(`- \`${pathPrefix}${skill.name}/SKILL.md\` \u2014 ${shortDesc}`);
+  }
+  return content.trimEnd() + "\n" + lines.join("\n") + "\n";
+}
 
 // src/writers/claude/index.ts
 function writeClaudeConfig(config) {
   const written = [];
-  fs10.writeFileSync("CLAUDE.md", appendLearningsBlock(appendPreCommitBlock(config.claudeMd)));
+  let claudeMd = config.claudeMd;
+  if (config.skills?.length) {
+    claudeMd = appendSkillListing(claudeMd, config.skills, ".claude/skills/");
+  }
+  fs10.writeFileSync("CLAUDE.md", appendLearningsBlock(appendPreCommitBlock(claudeMd)));
   written.push("CLAUDE.md");
   if (config.skills?.length) {
     for (const skill of config.skills) {
@@ -4361,7 +4398,11 @@ import fs12 from "fs";
 import path12 from "path";
 function writeCodexConfig(config) {
   const written = [];
-  fs12.writeFileSync("AGENTS.md", appendLearningsBlock(appendPreCommitBlock(config.agentsMd)));
+  let agentsMd = config.agentsMd;
+  if (config.skills?.length) {
+    agentsMd = appendSkillListing(agentsMd, config.skills, ".agents/skills/");
+  }
+  fs12.writeFileSync("AGENTS.md", appendLearningsBlock(appendPreCommitBlock(agentsMd)));
   written.push("AGENTS.md");
   if (config.skills?.length) {
     for (const skill of config.skills) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rely-ai/caliber",
-  "version": "1.29.4",
+  "version": "1.30.0-dev.1774189509",
   "description": "Analyze your codebase and generate optimized AI agent configs (CLAUDE.md, .cursorrules, skills) — no API key needed",
   "type": "module",
   "bin": {