@codedrifters/configulator 0.0.156 → 0.0.157

package/lib/index.d.mts

@@ -190,6 +190,25 @@ interface AgentSkill {
      * @example ['src/api/**\/*.ts']
      */
     readonly paths?: ReadonlyArray<string>;
+    /**
+     * Resource directories bundled with the skill (e.g., references/, scripts/, assets/).
+     * @example ['references/', 'scripts/']
+     */
+    readonly references?: ReadonlyArray<string>;
+    /**
+     * Context isolation mode. Set to 'fork' to run in an isolated subagent context.
+     */
+    readonly context?: string;
+    /**
+     * Subagent name to delegate to when context is 'fork'.
+     * @example 'code-reviewer'
+     */
+    readonly agent?: string;
+    /**
+     * Shell for dynamic context injection via !`command` syntax.
+     * @default 'bash'
+     */
+    readonly shell?: string;
 }
 /**
  * Platform-specific overrides for a sub-agent definition.

package/lib/index.d.ts

@@ -239,6 +239,25 @@ interface AgentSkill {
      * @example ['src/api/**\/*.ts']
      */
     readonly paths?: ReadonlyArray<string>;
+    /**
+     * Resource directories bundled with the skill (e.g., references/, scripts/, assets/).
+     * @example ['references/', 'scripts/']
+     */
+    readonly references?: ReadonlyArray<string>;
+    /**
+     * Context isolation mode. Set to 'fork' to run in an isolated subagent context.
+     */
+    readonly context?: string;
+    /**
+     * Subagent name to delegate to when context is 'fork'.
+     * @example 'code-reviewer'
+     */
+    readonly agent?: string;
+    /**
+     * Shell for dynamic context injection via !`command` syntax.
+     * @default 'bash'
+     */
+    readonly shell?: string;
 }
 /**
  * Platform-specific overrides for a sub-agent definition.

package/lib/index.js

@@ -333,10 +333,109 @@ var awsCdkBundle = {
 };
 
 // src/agent/bundles/base.ts
+var createRuleSkill = {
+  name: "create-rule",
+  description: "Guide for creating new agent rules in this project using configulator",
+  disableModelInvocation: true,
+  instructions: [
+    "# Create Agent Rule",
+    "",
+    "Create a new agent rule for the **{{repository.owner}}/{{repository.name}}** project.",
+    "",
+    "## Steps",
+    "",
+    "1. **Identify the rule purpose** \u2014 ask what behavior the rule should enforce or guide",
+    "2. **Choose a scope:**",
+    "   - `AGENT_RULE_SCOPE.ALWAYS` \u2014 active in all contexts",
+    "   - `AGENT_RULE_SCOPE.FILE_PATTERN` \u2014 active only when working on matching files (requires `filePatterns`)",
+    "3. **Pick a name** \u2014 lowercase kebab-case (e.g., `react-conventions`, `api-error-handling`)",
+    "4. **Write the content** \u2014 clear, actionable markdown instructions",
+    "5. **Add to the project config** \u2014 add the rule to `AgentConfigOptions.rules` in the Projen config file",
+    "",
+    "## Rule Template",
+    "",
+    "```typescript",
+    "import { AGENT_RULE_SCOPE } from '@codedrifters/configulator';",
+    "",
+    "// In your AgentConfig options:",
+    "{",
+    "  rules: [",
+    "    {",
+    "      name: 'my-new-rule',",
+    "      description: 'What this rule does \u2014 used by AI for rule selection',",
+    "      scope: AGENT_RULE_SCOPE.ALWAYS, // or FILE_PATTERN",
+    "      // filePatterns: ['src/**/*.ts'],  // required for FILE_PATTERN scope",
+    "      content: [",
+    "        '# Rule Title',",
+    "        '',",
+    "        '## Guidelines',",
+    "        '',",
+    "        '- Guideline 1',",
+    "        '- Guideline 2',",
+    "      ].join('\\n'),",
+    "      tags: ['coding'], // optional: for ordering",
+    "    },",
+    "  ],",
+    "}",
+    "```",
+    "",
+    "## Best Practices",
+    "",
+    "- Keep rules **focused** \u2014 one concern per rule",
+    '- Use **imperative tone** \u2014 "Use X" not "You should use X"',
+    "- Include **examples** for complex patterns",
+    "- Use `ruleExtensions` to add project-specific content to existing bundle rules instead of replacing them"
+  ].join("\n")
+};
+var reviewPrSkill = {
+  name: "review-pr",
+  description: "Review a pull request for code quality, conventions, and correctness",
+  instructions: [
+    "# Review Pull Request",
+    "",
+    "Review the current pull request in **{{repository.owner}}/{{repository.name}}**.",
+    "",
+    "## Review Checklist",
+    "",
+    "1. **Read the PR description** \u2014 understand the intent and linked issue",
+    "2. **Review the diff** \u2014 check all changed files for:",
+    "   - Correctness and logic errors",
+    "   - Adherence to project conventions",
+    "   - Test coverage for new/changed behavior",
+    "   - No unintended side effects",
+    "3. **Check PR conventions:**",
+    "   - Title uses conventional commit prefix (`feat:`, `fix:`, `docs:`, etc.)",
+    "   - Body includes a closing keyword (`Closes #<issue>`)",
+    "   - Summary of changes is present",
+    "4. **Verify build and tests pass**",
+    "",
+    "## Commands",
+    "",
+    "```bash",
+    "# View the PR details",
+    "gh pr view",
+    "",
+    "# View the diff",
+    "gh pr diff",
+    "",
+    "# Check CI status",
+    "gh pr checks",
+    "```",
+    "",
+    "## Output Format",
+    "",
+    "Provide a structured review with:",
+    "- **Summary**: One-line verdict (approve, request changes, or comment)",
+    "- **Findings**: Bulleted list of issues or suggestions, grouped by severity",
+    "- **Positive notes**: What was done well"
+  ].join("\n"),
+  allowedTools: ["Read", "Glob", "Grep", "Bash(gh *)"]
+};
 var baseBundle = {
   name: "base",
   description: "Core rules: project overview, interaction style, and general coding conventions",
   appliesWhen: () => true,
+  skills: [createRuleSkill, reviewPrSkill],
   rules: [
     {
       name: "project-overview",
@@ -1607,6 +1706,15 @@ var ClaudeRenderer = class _ClaudeRenderer {
           lines.push(`  - "${p}"`);
         }
       }
+      if (skill.context) {
+        lines.push(`context: "${skill.context}"`);
+      }
+      if (skill.agent) {
+        lines.push(`agent: "${skill.agent}"`);
+      }
+      if (skill.shell) {
+        lines.push(`shell: "${skill.shell}"`);
+      }
       if (skill.allowedTools && skill.allowedTools.length > 0) {
         lines.push(`allowed-tools:`);
         for (const tool of skill.allowedTools) {
@@ -1723,6 +1831,15 @@ var CursorRenderer = class _CursorRenderer {
       if (skill.userInvocable === false) {
         lines.push(`user-invocable: false`);
       }
+      if (skill.context) {
+        lines.push(`context: "${skill.context}"`);
+      }
+      if (skill.agent) {
+        lines.push(`agent: "${skill.agent}"`);
+      }
+      if (skill.shell) {
+        lines.push(`shell: "${skill.shell}"`);
+      }
       if (skill.allowedTools && skill.allowedTools.length > 0) {
         lines.push(`allowed-tools:`);
         for (const tool of skill.allowedTools) {