@codedrifters/configulator 0.0.161 → 0.0.163

package/lib/index.mjs

@@ -407,6 +407,23 @@ var baseBundle = {
       ].join("\n"),
       tags: ["project"]
     },
+    {
+      name: "reference-documentation",
+      description: "Consult project rules, documentation, and existing code before answering or making changes",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Reference Documentation",
+        "",
+        "Before answering questions or making changes, always consult available project context.",
+        "",
+        "1. **Read project rules and guidelines** \u2014 check for agent rules, contribution guides, and coding standards defined in the project.",
+        "2. **Review existing code** \u2014 understand current patterns, conventions, and architecture before proposing changes. Look at similar files and modules for reference.",
+        "3. **Check documentation** \u2014 consult README files, inline documentation, and any design documents for relevant context.",
+        "4. **Respect established patterns** \u2014 follow the conventions already in use rather than introducing new ones without discussion.",
+        "5. **Verify before assuming** \u2014 if documentation or code conflicts with your assumptions, trust the project sources and ask for clarification when needed."
+      ].join("\n"),
+      tags: ["project"]
+    },
     {
       name: "interaction-style",
       description: "Interaction style \u2014 ask questions one at a time and wait for feedback",
@@ -416,12 +433,13 @@ var baseBundle = {
         "",
         "When responding to requests, follow these interaction principles.",
         "",
-        "1. **Ask questions one at a time**: When clarification is needed, ask a single question and wait for the user's response before proceeding.",
-        "2. **Wait for feedback**: After asking a question, pause and wait for the user's answer before asking additional questions or making assumptions.",
-        "3. **Avoid question overload**: Do not ask multiple questions in a single response. If multiple clarifications are needed, prioritize the most important question first.",
-        "4. **Progressive clarification**: Once the user answers your first question, you may then ask the next most important question if needed.",
-        "5. **Confirm understanding**: After receiving feedback, acknowledge the user's response before proceeding with the next step or question.",
-        "6. **Be patient**: Do not rush ahead with assumptions. It is better to ask one clarifying question than to proceed with incorrect assumptions."
+        "1. **Ask when ambiguous**: When requirements are ambiguous or incomplete, always ask clarifying questions before proceeding. Do not make assumptions about the user's intent \u2014 it is better to ask than to guess wrong.",
+        "2. **Ask questions one at a time**: When clarification is needed, ask a single question and wait for the user's response before proceeding.",
+        "3. **Wait for feedback**: After asking a question, pause and wait for the user's answer before asking additional questions or making assumptions.",
+        "4. **Avoid question overload**: Do not ask multiple questions in a single response. If multiple clarifications are needed, prioritize the most important question first.",
+        "5. **Progressive clarification**: Once the user answers your first question, you may then ask the next most important question if needed.",
+        "6. **Confirm understanding**: After receiving feedback, acknowledge the user's response before proceeding with the next step or question.",
+        "7. **Be patient**: Do not rush ahead with assumptions. It is better to ask one clarifying question than to proceed with incorrect assumptions."
       ].join("\n"),
       tags: ["project"]
     },
@@ -1147,7 +1165,27 @@ var typescriptBundle = {
         "- **Functions/Methods**: camelCase (e.g., `configureProject`)",
         "- **Constants**: UPPER_SNAKE_CASE (e.g., `VERSION`, `AWS_STAGE_TYPE`)",
         "- **Files**: kebab-case for multi-word files (e.g., `aws-deployment-config.ts`)",
-        "- **Private members**: No prefix needed (TypeScript handles visibility)"
+        "- **Component file naming**: kebab-case filename must mirror the PascalCase class name (e.g., `ResetTask` \u2192 `reset-task.ts`)",
+        "- **Private members**: No prefix needed (TypeScript handles visibility)",
+        "",
+        "## Array Type Syntax",
+        "",
+        "- Prefer `Array<T>` over `T[]` for readability",
+        "- For nested generics this is especially important: `Array<Array<string>>` is clearer than `string[][]`",
+        "",
+        "## Enum Preference",
+        "",
+        "- Prefer `as const` objects over TypeScript `enum` declarations",
+        "- `as const` objects are more flexible: they support computed values, work with `keyof typeof`, and tree-shake better",
+        "- Example:",
+        "  ```typescript",
+        "  // Prefer this:",
+        "  const Status = { Active: 'active', Inactive: 'inactive' } as const;",
+        "  type Status = (typeof Status)[keyof typeof Status];",
+        "",
+        "  // Over this:",
+        "  enum Status { Active = 'active', Inactive = 'inactive' }",
+        "  ```"
       ].join("\n"),
       tags: ["coding"]
     }