@codedrifters/configulator 0.0.278 → 0.0.279

package/lib/index.d.mts

@@ -2569,6 +2569,9 @@ interface AgentConfigOptions {
      * Use this to supplement bundle rules with project-specific additions without
      * replacing the entire rule.
      *
+     * Unknown keys (no matching rule in the active bundle set) are silently
+     * ignored.
+     *
      * @example
      * ```ts
      * ruleExtensions: {
@@ -2577,6 +2580,42 @@ interface AgentConfigOptions {
      * ```
      */
     readonly ruleExtensions?: Readonly<Record<string, string>>;
+    /**
+     * Additional content to append to existing sub-agent prompts (from bundles
+     * or custom subAgents). Keys are sub-agent names, values are markdown
+     * content appended after a horizontal rule. Mirrors `ruleExtensions` but
+     * targets the rendered sub-agent prompt across every active platform
+     * (Claude, Cursor, etc.).
+     *
+     * Unknown keys (no matching sub-agent in the active bundle set) are
+     * silently ignored.
+     *
+     * @example
+     * ```ts
+     * subAgentExtensions: {
+     *   'requirements-writer': '## Project-Specific Gaps\n\n- Use branded types for IDs',
+     * }
+     * ```
+     */
+    readonly subAgentExtensions?: Readonly<Record<string, string>>;
+    /**
+     * Additional content to append to existing skill `SKILL.md` bodies (from
+     * bundles or custom skills). Keys are skill names, values are markdown
+     * content appended after a horizontal rule. Mirrors `ruleExtensions` but
+     * targets the rendered skill instructions across every active platform
+     * (Claude, Cursor, etc.).
+     *
+     * Unknown keys (no matching skill in the active bundle set) are silently
+     * ignored.
+     *
+     * @example
+     * ```ts
+     * skillExtensions: {
+     *   'write-requirement': '## Project-Specific Templates\n\n- Use branded types for IDs',
+     * }
+     * ```
+     */
+    readonly skillExtensions?: Readonly<Record<string, string>>;
     /**
      * Claude Code settings.json configuration.
      * Generated to .claude/settings.json (committed, team-shared).
@@ -3053,11 +3092,17 @@ declare class AgentConfig extends Component {
      */
     private resolveTemplates;
     /**
-     * Resolves template variables in skill instructions using project metadata.
+     * Resolves template variables in skill instructions using project metadata,
+     * then appends any matching `skillExtensions` content after a horizontal
+     * rule. Unknown keys in `skillExtensions` are silently ignored, mirroring
+     * the `ruleExtensions` contract.
      */
     private resolveSkillTemplates;
     /**
-     * Resolves template variables in sub-agent prompts using project metadata.
+     * Resolves template variables in sub-agent prompts using project metadata,
+     * then appends any matching `subAgentExtensions` content after a horizontal
+     * rule. Unknown keys in `subAgentExtensions` are silently ignored,
+     * mirroring the `ruleExtensions` contract.
      */
     private resolveSubAgentTemplates;
     /**

package/lib/index.d.ts

@@ -2618,6 +2618,9 @@ interface AgentConfigOptions {
      * Use this to supplement bundle rules with project-specific additions without
      * replacing the entire rule.
      *
+     * Unknown keys (no matching rule in the active bundle set) are silently
+     * ignored.
+     *
      * @example
      * ```ts
      * ruleExtensions: {
@@ -2626,6 +2629,42 @@ interface AgentConfigOptions {
      * ```
      */
     readonly ruleExtensions?: Readonly<Record<string, string>>;
+    /**
+     * Additional content to append to existing sub-agent prompts (from bundles
+     * or custom subAgents). Keys are sub-agent names, values are markdown
+     * content appended after a horizontal rule. Mirrors `ruleExtensions` but
+     * targets the rendered sub-agent prompt across every active platform
+     * (Claude, Cursor, etc.).
+     *
+     * Unknown keys (no matching sub-agent in the active bundle set) are
+     * silently ignored.
+     *
+     * @example
+     * ```ts
+     * subAgentExtensions: {
+     *   'requirements-writer': '## Project-Specific Gaps\n\n- Use branded types for IDs',
+     * }
+     * ```
+     */
+    readonly subAgentExtensions?: Readonly<Record<string, string>>;
+    /**
+     * Additional content to append to existing skill `SKILL.md` bodies (from
+     * bundles or custom skills). Keys are skill names, values are markdown
+     * content appended after a horizontal rule. Mirrors `ruleExtensions` but
+     * targets the rendered skill instructions across every active platform
+     * (Claude, Cursor, etc.).
+     *
+     * Unknown keys (no matching skill in the active bundle set) are silently
+     * ignored.
+     *
+     * @example
+     * ```ts
+     * skillExtensions: {
+     *   'write-requirement': '## Project-Specific Templates\n\n- Use branded types for IDs',
+     * }
+     * ```
+     */
+    readonly skillExtensions?: Readonly<Record<string, string>>;
     /**
      * Claude Code settings.json configuration.
      * Generated to .claude/settings.json (committed, team-shared).
@@ -3102,11 +3141,17 @@ declare class AgentConfig extends Component {
      */
     private resolveTemplates;
     /**
-     * Resolves template variables in skill instructions using project metadata.
+     * Resolves template variables in skill instructions using project metadata,
+     * then appends any matching `skillExtensions` content after a horizontal
+     * rule. Unknown keys in `skillExtensions` are silently ignored, mirroring
+     * the `ruleExtensions` contract.
      */
     private resolveSkillTemplates;
     /**
-     * Resolves template variables in sub-agent prompts using project metadata.
+     * Resolves template variables in sub-agent prompts using project metadata,
+     * then appends any matching `subAgentExtensions` content after a horizontal
+     * rule. Unknown keys in `subAgentExtensions` are silently ignored,
+     * mirroring the `ruleExtensions` contract.
      */
     private resolveSubAgentTemplates;
     /**

package/lib/index.js

@@ -16968,6 +16968,19 @@ var projenBundle = {
         "}",
         "```",
         "",
+        "The same pattern applies to bundled sub-agents and skills. Use `agentConfig.subAgentExtensions` to append project-specific content to a sub-agent prompt and `agentConfig.skillExtensions` to append content to a skill's `SKILL.md` body. Both options mirror `ruleExtensions` exactly \u2014 keys are sub-agent / skill names, values are markdown appended after a horizontal rule, and unknown keys are silently ignored.",
+        "",
+        "```typescript",
+        "agentConfig: {",
+        "  subAgentExtensions: {",
+        "    'requirements-writer': '## Project-Specific Gaps\\n\\n- My custom guidance',",
+        "  },",
+        "  skillExtensions: {",
+        "    'write-requirement': '## Project-Specific Templates\\n\\n- My custom template note',",
+        "  },",
+        "}",
+        "```",
+        "",
         "## After Any Change",
         "",
         "Run the three-step regen sequence to regenerate the output files: `pnpm i`, then `pnpm exec projen`, then `pnpm i` again. The leading `pnpm i` syncs `node_modules` with the lockfile before synth so `pnpm exec projen` runs against the right configulator/projen/plugin versions; the trailing `pnpm i` refreshes the lockfile for any dependency changes projen made during synth."
@@ -28243,9 +28256,13 @@ ${hook}`
     });
   }
   /**
-   * Resolves template variables in skill instructions using project metadata.
+   * Resolves template variables in skill instructions using project metadata,
+   * then appends any matching `skillExtensions` content after a horizontal
+   * rule. Unknown keys in `skillExtensions` are silently ignored, mirroring
+   * the `ruleExtensions` contract.
    */
   resolveSkillTemplates(skills, metadata) {
+    const extensions = this.options.skillExtensions;
     return skills.map((skill) => {
       const { resolved, unresolvedKeys } = resolveTemplateVariables(
         skill.instructions,
@@ -28256,13 +28273,24 @@ ${hook}`
           `AgentConfig: ProjectMetadata not found; skill '${skill.name}' using default values`
         );
       }
-      return resolved !== skill.instructions ? { ...skill, instructions: resolved } : skill;
+      const extra = extensions?.[skill.name];
+      const baseInstructions = resolved;
+      const finalInstructions = extra !== void 0 && extra !== "" ? `${baseInstructions}
+
+---
+
+${extra}` : baseInstructions;
+      return finalInstructions !== skill.instructions ? { ...skill, instructions: finalInstructions } : skill;
     });
   }
   /**
-   * Resolves template variables in sub-agent prompts using project metadata.
+   * Resolves template variables in sub-agent prompts using project metadata,
+   * then appends any matching `subAgentExtensions` content after a horizontal
+   * rule. Unknown keys in `subAgentExtensions` are silently ignored,
+   * mirroring the `ruleExtensions` contract.
    */
   resolveSubAgentTemplates(subAgents, metadata) {
+    const extensions = this.options.subAgentExtensions;
     return subAgents.map((agent) => {
       const { resolved, unresolvedKeys } = resolveTemplateVariables(
         agent.prompt,
@@ -28273,7 +28301,14 @@ ${hook}`
           `AgentConfig: ProjectMetadata not found; sub-agent '${agent.name}' using default values`
         );
       }
-      return resolved !== agent.prompt ? { ...agent, prompt: resolved } : agent;
+      const extra = extensions?.[agent.name];
+      const basePrompt = resolved;
+      const finalPrompt = extra !== void 0 && extra !== "" ? `${basePrompt}
+
+---
+
+${extra}` : basePrompt;
+      return finalPrompt !== agent.prompt ? { ...agent, prompt: finalPrompt } : agent;
     });
   }
   /**