@codedrifters/configulator 0.0.245 → 0.0.247

package/lib/index.mjs

@@ -386,6 +386,245 @@ var awsCdkBundle = {
 };
 
 // src/agent/bundles/base.ts
+var createPackageSkill = {
+  name: "create-package",
+  description: "Scaffold a new TypeScriptProject sub-project under packages/@scope/<name> by emitting the projen block to add to the monorepo config",
+  disableModelInvocation: true,
+  instructions: [
+    "# Create Package",
+    "",
+    "Scaffold a new shared-library sub-project at",
+    "`packages/@scope/<name>` by emitting the projen block to add to the",
+    "monorepo's projen configuration. This skill walks the user through",
+    "naming, metadata, and placement; it does **not** run projen, install",
+    "dependencies, or execute any build commands.",
+    "",
+    "## Usage",
+    "",
+    "```",
+    "/create-package @<scope>/<name>",
+    "```",
+    "",
+    "Example: `/create-package @codedrifters/my-lib` \u2192 scaffolds a new",
+    "`TypeScriptProject` at `packages/@codedrifters/my-lib`.",
+    "",
+    "## Steps",
+    "",
+    "1. **Parse and validate the package name.** The argument must be a",
+    "   **scoped** npm name in the form `@<scope>/<name>`:",
+    "   - Starts with `@`",
+    "   - Has exactly one `/` separator",
+    "   - `<scope>` and `<name>` are lowercase, kebab-case, non-empty",
+    "   - Unscoped names (e.g. `my-lib`) are **not** allowed \u2014 every",
+    "     package under `packages/` is scoped by owner.",
+    "   If the input is missing or invalid, ask the user to supply a",
+    "   scoped name. Do not guess the scope.",
+    "",
+    "2. **Collect metadata** \u2014 ask the user for each of the following,",
+    "   one question at a time:",
+    "   - **Description** \u2014 one-line summary of what the package does.",
+    "   - **Publish to npm?** \u2014 `true` or `false`. Workspace-internal",
+    "     libraries should answer `false`.",
+    "   Skip any question the user has already answered in the initial",
+    "   prompt.",
+    "",
+    "3. **Determine the target outdir.** The sub-project lives at:",
+    "",
+    "   ```",
+    "   packages/<scope>/<name>",
+    "   ```",
+    "",
+    "   `<scope>` is everything after `@` and before `/` in the package",
+    "   name; `<name>` is everything after the `/`. This matches the",
+    "   default `outdir` that `TypeScriptProject` computes from the",
+    "   package name, so the emitted block does **not** need to set",
+    "   `outdir` explicitly.",
+    "",
+    "4. **Locate the projen config file.** Prefer the monorepo's",
+    "   `projenrc/` directory \u2014 most monorepos declare sub-projects",
+    "   there (e.g. `projenrc/root-project.ts` or a dedicated",
+    "   `projenrc/packages.ts`). Fall back to `.projenrc.ts` only when",
+    "   no `projenrc/` directory exists.",
+    "",
+    "5. **Emit the projen block.** Show the TypeScript block to paste",
+    "   into the chosen projen config file. Example for",
+    "   `@codedrifters/my-lib`:",
+    "",
+    "   ```typescript",
+    "   import { TypeScriptProject } from '@codedrifters/configulator';",
+    "",
+    "   // Inside the monorepo's configuration function, alongside",
+    "   // sibling sub-projects:",
+    "   new TypeScriptProject({",
+    "     parent: monorepo,",
+    "     name: '@codedrifters/my-lib',",
+    "     description: '<one-line description>',",
+    "     defaultReleaseBranch: 'main',",
+    "     publishToNpm: false, // or true if this package publishes",
+    "   });",
+    "   ```",
+    "",
+    "   Substitute the user's scope, name, description, and",
+    "   `publishToNpm` value. Do not hard-code `outdir` \u2014 the default",
+    "   places the sub-project at `packages/<scope>/<name>`.",
+    "",
+    "6. **Tell the user how to synthesize.** Instruct them to run, from",
+    "   the repo root:",
+    "",
+    "   ```",
+    "   pnpm exec projen",
+    "   pnpm install",
+    "   ```",
+    "",
+    "   `pnpm exec projen` regenerates the sub-project tree;",
+    "   `pnpm install` updates the workspace lockfile. Do **not** run",
+    "   these commands yourself \u2014 the user runs them.",
+    "",
+    "## Guardrails",
+    "",
+    "- Never run `pnpm exec projen`, `pnpm install`, `pnpm build`,",
+    "  `pnpm test`, or any other package-manager, build, or test command.",
+    "  Emit the projen block and instructions only.",
+    "- Never scaffold outside `packages/`. Deployable apps belong under",
+    "  `apps/<scope>/<name>` (use `/create-app`); user-facing sites belong",
+    "  under `sites/<scope>/<name>` (use `/create-site`).",
+    "- Never scope by category (e.g. `@libs/foo`, `@packages/foo`). The",
+    "  scope identifies the **owning party**; the top-level folder",
+    "  identifies the kind.",
+    "- Do not invent an `outdir` \u2014 rely on the `TypeScriptProject`",
+    "  default that places the sub-project at `packages/<scope>/<name>`.",
+    "",
+    "## Related Skills",
+    "",
+    "- `/create-app` \u2014 scaffold a new `AwsCdkProject` under",
+    "  `apps/<scope>/<name>`.",
+    "- `/create-site` \u2014 scaffold a new `AstroProject` under",
+    "  `sites/<scope>/<name>`."
+  ].join("\n")
+};
+var createAppSkill = {
+  name: "create-app",
+  description: "Scaffold a new AwsCdkProject sub-project under apps/@scope/<name> by emitting the projen block to add to the monorepo config",
+  disableModelInvocation: true,
+  instructions: [
+    "# Create App",
+    "",
+    "Scaffold a new deployable-application sub-project at",
+    "`apps/@scope/<name>` by emitting the projen block to add to the",
+    "monorepo's projen configuration. This skill walks the user through",
+    "naming, metadata, and placement; it does **not** run projen, install",
+    "dependencies, or execute any build commands.",
+    "",
+    "Today this skill scaffolds AWS CDK applications (`AwsCdkProject`).",
+    "The `apps/` folder is also the right home for other deployable",
+    "application types (mobile apps, backend services) as configulator",
+    "grows support for them \u2014 but at the moment, this skill emits an",
+    "`AwsCdkProject` block.",
+    "",
+    "## Usage",
+    "",
+    "```",
+    "/create-app @<scope>/<name>",
+    "```",
+    "",
+    "Example: `/create-app @codedrifters/my-stack` \u2192 scaffolds a new",
+    "`AwsCdkProject` at `apps/@codedrifters/my-stack`.",
+    "",
+    "## Steps",
+    "",
+    "1. **Parse and validate the app name.** The argument must be a",
+    "   **scoped** npm name in the form `@<scope>/<name>`:",
+    "   - Starts with `@`",
+    "   - Has exactly one `/` separator",
+    "   - `<scope>` and `<name>` are lowercase, kebab-case, non-empty",
+    "   - Unscoped names (e.g. `my-stack`) are **not** allowed \u2014 every",
+    "     app under `apps/` is scoped by owner.",
+    "   If the input is missing or invalid, ask the user to supply a",
+    "   scoped name. Do not guess the scope.",
+    "",
+    "2. **Collect metadata** \u2014 ask the user for each of the following,",
+    "   one question at a time:",
+    "   - **Description** \u2014 one-line summary of what the app does.",
+    "   - **CDK version** \u2014 the AWS CDK version to pin (e.g. `2.150.0`).",
+    "     If the user is unsure, suggest they match the CDK version",
+    "     already in use by sibling `AwsCdkProject` entries in the",
+    "     monorepo; otherwise pick the latest stable release.",
+    "   Skip any question the user has already answered in the initial",
+    "   prompt.",
+    "",
+    "3. **Determine the target outdir.** The sub-project lives at:",
+    "",
+    "   ```",
+    "   apps/<scope>/<name>",
+    "   ```",
+    "",
+    "   `<scope>` is everything after `@` and before `/` in the app",
+    "   name; `<name>` is everything after the `/`. This matches the",
+    "   default `outdir` that `AwsCdkProject` computes from the package",
+    "   name, so the emitted block does **not** need to set `outdir`",
+    "   explicitly.",
+    "",
+    "4. **Locate the projen config file.** Prefer the monorepo's",
+    "   `projenrc/` directory \u2014 most monorepos declare sub-projects",
+    "   there (e.g. `projenrc/root-project.ts` or a dedicated",
+    "   `projenrc/apps.ts`). Fall back to `.projenrc.ts` only when",
+    "   no `projenrc/` directory exists.",
+    "",
+    "5. **Emit the projen block.** Show the TypeScript block to paste",
+    "   into the chosen projen config file. Example for",
+    "   `@codedrifters/my-stack`:",
+    "",
+    "   ```typescript",
+    "   import { AwsCdkProject } from '@codedrifters/configulator';",
+    "",
+    "   // Inside the monorepo's configuration function, alongside",
+    "   // sibling sub-projects:",
+    "   new AwsCdkProject({",
+    "     parent: monorepo,",
+    "     name: '@codedrifters/my-stack',",
+    "     description: '<one-line description>',",
+    "     cdkVersion: '<cdk-version>',",
+    "   });",
+    "   ```",
+    "",
+    "   Substitute the user's scope, name, description, and CDK",
+    "   version. Do not hard-code `outdir` \u2014 the default places the",
+    "   sub-project at `apps/<scope>/<name>`.",
+    "",
+    "6. **Tell the user how to synthesize.** Instruct them to run, from",
+    "   the repo root:",
+    "",
+    "   ```",
+    "   pnpm exec projen",
+    "   pnpm install",
+    "   ```",
+    "",
+    "   `pnpm exec projen` regenerates the sub-project tree;",
+    "   `pnpm install` updates the workspace lockfile. Do **not** run",
+    "   these commands yourself \u2014 the user runs them.",
+    "",
+    "## Guardrails",
+    "",
+    "- Never run `pnpm exec projen`, `pnpm install`, `pnpm build`,",
+    "  `pnpm test`, or any other package-manager, build, or test command.",
+    "  Emit the projen block and instructions only.",
+    "- Never scaffold outside `apps/`. Shared libraries belong under",
+    "  `packages/<scope>/<name>` (use `/create-package`); user-facing",
+    "  sites belong under `sites/<scope>/<name>` (use `/create-site`).",
+    "- Never scope by category (e.g. `@apps/foo`, `@stacks/foo`). The",
+    "  scope identifies the **owning party**; the top-level folder",
+    "  identifies the kind.",
+    "- Do not invent an `outdir` \u2014 rely on the `AwsCdkProject` default",
+    "  that places the sub-project at `apps/<scope>/<name>`.",
+    "",
+    "## Related Skills",
+    "",
+    "- `/create-package` \u2014 scaffold a new `TypeScriptProject` under",
+    "  `packages/<scope>/<name>`.",
+    "- `/create-site` \u2014 scaffold a new `AstroProject` under",
+    "  `sites/<scope>/<name>`."
+  ].join("\n")
+};
 var createRuleSkill = {
   name: "create-rule",
   description: "Guide for creating new agent rules in this project using configulator",
@@ -444,7 +683,7 @@ var baseBundle = {
   name: "base",
   description: "Core rules: project overview, interaction style, and general coding conventions",
   appliesWhen: () => true,
-  skills: [createRuleSkill],
+  skills: [createPackageSkill, createAppSkill, createRuleSkill],
   rules: [
     {
       name: "project-overview",