domain-driver 0.1.0 → 0.2.0

package/dist/commands/service.js

@@ -1,119 +1,21 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeService = makeService;
-const path = __importStar(require("path"));
-const utils_1 = require("../utils");
-const SERVICE_ACTIONS = ['List', 'Create', 'Update', 'Delete', 'Show'];
-function renderService(action, name, feature) {
-    const typePath = (0, utils_1.resolveImport)(feature, `types/${name}.types`);
-    const repoPath = (op) => (0, utils_1.resolveImport)(feature, `repositories/${op}${name}.repository`);
-    const schemaPath = (op) => (0, utils_1.resolveImport)(feature, `schemas/${op}${name}.schema`);
-    switch (action) {
-        case 'List':
-            return `import { ${name} } from '${typePath}';
-import { List${name}Repository } from '${repoPath('List')}';
-
-const repository = new List${name}Repository();
-
-export class List${name}Service {
-  async handle(): Promise<${name}[]> {
-    return repository.handle();
-  }
-}
-`;
-        case 'Show':
-            return `import { ${name} } from '${typePath}';
-import { Show${name}Repository } from '${repoPath('Show')}';
-
-const repository = new Show${name}Repository();
-
-export class Show${name}Service {
-  async handle(id: string): Promise<${name}> {
-    return repository.handle(id);
-  }
-}
-`;
-        case 'Create':
-            return `import { ${name} } from '${typePath}';
-import { Create${name} } from '${schemaPath('Create')}';
-import { Create${name}Repository } from '${repoPath('Create')}';
-
-const repository = new Create${name}Repository();
-
-export class Create${name}Service {
-  async handle(data: Create${name}): Promise<${name}> {
-    return repository.handle(data);
-  }
-}
-`;
-        case 'Update':
-            return `import { ${name} } from '${typePath}';
-import { Update${name} } from '${schemaPath('Update')}';
-import { Update${name}Repository } from '${repoPath('Update')}';
-
-const repository = new Update${name}Repository();
-
-export class Update${name}Service {
-  async handle(id: string, data: Update${name}): Promise<${name}> {
-    return repository.handle(id, data);
-  }
-}
-`;
-        case 'Delete':
-            return `import { Delete${name}Repository } from '${repoPath('Delete')}';
-
-const repository = new Delete${name}Repository();
-
-export class Delete${name}Service {
-  async handle(id: string): Promise<void> {
-    return repository.handle(id);
-  }
-}
-`;
-    }
-}
-function makeService(feature, name) {
-    const base = (0, utils_1.ensureFeatureExists)(feature, 'services');
-    for (const action of SERVICE_ACTIONS) {
-        const filePath = path.join(base, `${action}${name}.service.ts`);
-        if ((0, utils_1.fileExists)(filePath)) {
-            console.warn(`⚠️  Skipping "${action}${name}.service.ts" — already exists`);
-            continue;
+const actions_1 = require("../templates/actions");
+const service_1 = require("../templates/service");
+const resolve_1 = require("./resolve");
+const sides_1 = require("./sides");
+const write_1 = require("./write");
+function makeService(feature, name, side = 'both') {
+    const ctx = (0, resolve_1.requireFeature)(feature);
+    let wroteAny = false;
+    for (const current of (0, sides_1.resolveSides)(ctx.profile, side, sides_1.SERVICE_SIDES)) {
+        const dir = (0, resolve_1.ensureLayerDir)(ctx, sides_1.SERVICE_SIDES[current]);
+        const written = (0, write_1.writeSpecFiles)(dir, (0, actions_1.standardActions)(name), 'service', (spec, filePath) => (0, service_1.renderService)(ctx, spec, name, filePath, current));
+        if (written > 0) {
+            console.log(`✅ Services (${current}) for "${name}" created at ${dir}`);
+            wroteAny = true;
         }
-        (0, utils_1.writeFileSafe)(filePath, renderService(action, name, feature));
     }
-    console.log(`✅ Services for "${name}" created at ${base}`);
+    return wroteAny;
 }

package/dist/commands/sides.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPOSITORY_SIDES = exports.SERVICE_SIDES = void 0;
+exports.parseSide = parseSide;
+exports.resolveSides = resolveSides;
+const registry_1 = require("../stack/registry");
+exports.SERVICE_SIDES = Object.freeze({
+    client: 'clientService',
+    server: 'serverService',
+    command: 'make:service',
+    noun: 'services',
+});
+exports.REPOSITORY_SIDES = Object.freeze({
+    client: 'clientRepository',
+    server: 'serverRepository',
+    command: 'make:repository',
+    noun: 'repositories',
+});
+const SIDES = ['client', 'server'];
+function parseSide(value) {
+    if (value === 'client' || value === 'server' || value === 'both')
+        return value;
+    throw new Error(`Invalid --side "${value}". Use client, server, or both.`);
+}
+function resolveSides(profile, option, spec) {
+    const available = SIDES.filter((side) => (0, registry_1.hasLayer)(profile, spec[side]));
+    if (available.length === 0)
+        (0, registry_1.assertLayer)(profile, spec.server, spec.command);
+    if (option === 'both')
+        return available;
+    if (available.includes(option))
+        return [option];
+    throw new Error(`The ${profile.name} stack has no ${option}-side ${spec.noun}.`);
+}

package/dist/commands/target.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTarget = parseTarget;
+exports.parseFeatureTarget = parseFeatureTarget;
+const naming_1 = require("../utils/naming");
+const NAME_PATTERN = /^[A-Za-z][A-Za-z0-9]*$/;
+function validateName(name) {
+    if (!NAME_PATTERN.test(name)) {
+        throw new Error(`Name "${name}" must be letters and digits only, for example User.`);
+    }
+}
+function parseTarget(value) {
+    const parts = value.split('/');
+    if (parts.length !== 2) {
+        throw new Error(`Target "${value}" must be <feature>/<Name>, for example users/User.`);
+    }
+    const [feature, name] = parts;
+    (0, naming_1.validateFeatureName)(feature);
+    validateName(name);
+    return Object.freeze({ feature, name });
+}
+function parseFeatureTarget(value) {
+    const parts = value.split('/');
+    if (parts.length > 2) {
+        throw new Error(`Target "${value}" must be <feature> or <feature>/<Entity>, for example users or users/User.`);
+    }
+    const [feature, entity] = parts;
+    (0, naming_1.validateFeatureName)(feature);
+    if (entity !== undefined)
+        validateName(entity);
+    return Object.freeze({ feature, entity: entity ?? null });
+}

package/dist/commands/types.js

@@ -35,23 +35,15 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeTypes = makeTypes;
 const path = __importStar(require("path"));
-const utils_1 = require("../utils");
-function renderTypes(name) {
-    return `export interface ${name} {
-  id: string;
-  // add ${name} fields here
-  createdAt: string;
-  updatedAt: string;
-}
-`;
-}
+const registry_1 = require("../stack/registry");
+const types_1 = require("../templates/shared/types");
+const resolve_1 = require("./resolve");
+const write_1 = require("./write");
 function makeTypes(feature, name) {
-    const base = (0, utils_1.ensureFeatureExists)(feature, 'types');
-    const filePath = path.join(base, `${name}.types.ts`);
-    if ((0, utils_1.fileExists)(filePath)) {
-        console.warn(`⚠️  Skipping "${name}.types.ts" — already exists`);
-        return;
+    const ctx = (0, resolve_1.requireFeature)(feature);
+    (0, registry_1.assertLayer)(ctx.profile, 'types', 'make:types');
+    const filePath = path.join((0, resolve_1.ensureLayerDir)(ctx, 'types'), `${name}.types.ts`);
+    if ((0, write_1.writeIfAbsent)(filePath, () => (0, types_1.renderTypes)(name))) {
+        console.log(`✅ Types for "${name}" created at ${filePath}`);
     }
-    (0, utils_1.writeFileSafe)(filePath, renderTypes(name));
-    console.log(`✅ Types for "${name}" created at ${filePath}`);
 }

package/dist/commands/write.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeIfAbsent = writeIfAbsent;
+exports.writeActionFiles = writeActionFiles;
+exports.writeSpecFiles = writeSpecFiles;
+const path = __importStar(require("path"));
+const fs_1 = require("../utils/fs");
+function writeIfAbsent(filePath, render) {
+    if ((0, fs_1.fileExists)(filePath)) {
+        console.warn(`⚠️  Skipping "${path.basename(filePath)}" — already exists`);
+        return false;
+    }
+    (0, fs_1.writeFileSafe)(filePath, render());
+    return true;
+}
+function writeActionFiles(dir, entity, suffix, actions, render) {
+    let written = 0;
+    for (const action of actions) {
+        const filePath = path.join(dir, `${action}${entity}.${suffix}.ts`);
+        if (writeIfAbsent(filePath, () => render(action, filePath)))
+            written += 1;
+    }
+    return written;
+}
+function writeSpecFiles(dir, specs, suffix, render) {
+    let written = 0;
+    for (const spec of specs) {
+        const filePath = path.join(dir, `${spec.name}.${suffix}.ts`);
+        if (writeIfAbsent(filePath, () => render(spec, filePath)))
+            written += 1;
+    }
+    return written;
+}

package/dist/index.js

@@ -1,125 +1,140 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+// src/index.ts
 const commander_1 = require("commander");
-const feature_1 = require("./commands/feature");
+const action_1 = require("./commands/action");
 const component_1 = require("./commands/component");
+const container_1 = require("./commands/container");
+const controller_1 = require("./commands/controller");
+const feature_1 = require("./commands/feature");
+const hints_1 = require("./commands/hints");
 const hook_1 = require("./commands/hook");
-const service_1 = require("./commands/service");
-const schema_1 = require("./commands/schema");
 const repository_1 = require("./commands/repository");
-const container_1 = require("./commands/container");
+const schema_1 = require("./commands/schema");
+const service_1 = require("./commands/service");
+const sides_1 = require("./commands/sides");
+const target_1 = require("./commands/target");
 const types_1 = require("./commands/types");
+const init_1 = require("./init/init");
+const detect_1 = require("./stack/detect");
+const types_2 = require("./stack/types");
+const actions_1 = require("./templates/actions");
 const program = new commander_1.Command();
 program
     .name('domain-driver')
-    .description('CLI scaffolding tool for domain-driven development in Next.js')
-    .version('0.1.0');
+    .description('CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, and NestJS projects')
+    .version('0.2.0')
+    .option('--stack <name>', `Override stack detection (${types_2.STACK_NAMES.join(', ')})`);
+program.hook('preAction', (_thisCommand, actionCommand) => {
+    if (actionCommand.name() === 'init')
+        return;
+    const { stack } = program.opts();
+    console.log((0, detect_1.describeStack)((0, detect_1.detectStack)(stack)));
+});
 program
-    .command('make:feature <name>')
-    .description('Scaffold a full feature folder structure')
+    .command('make:feature <target>')
+    .description('Scaffold a feature folder for the detected stack (<feature> or <feature>/<Entity>)')
     .option('-a, --all', 'Scaffold all files inside each folder')
-    .action(async (name, options) => {
-    try {
-        await (0, feature_1.makeFeature)(name, options.all ?? false);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .action(async (target, options) => {
+    const { feature, entity } = (0, target_1.parseFeatureTarget)(target);
+    await (0, feature_1.makeFeature)(feature, options.all ?? false, entity ?? undefined);
 });
 program
-    .command('make:component <feature> <name>')
-    .description('Scaffold a component inside an existing feature')
+    .command('make:component <target>')
+    .description('Scaffold a component inside an existing feature (<feature>/<Name>)')
     .argument('[type]', 'Component type: client or server', 'client')
-    .action((feature, name, type) => {
-    try {
-        const componentType = type === 'server' ? 'server' : 'client';
-        (0, component_1.makeComponent)(feature, name, componentType);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .action((target, type) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    (0, component_1.makeComponent)(feature, name, (0, component_1.parseComponentType)(type));
 });
 program
-    .command('make:container <feature> <name>')
-    .description('Scaffold a smart container component inside an existing feature')
-    .action((feature, name) => {
-    try {
-        (0, container_1.makeContainer)(feature, name);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .command('make:container <target>')
+    .description('Scaffold a smart container component inside an existing feature (<feature>/<Name>)')
+    .action((target) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    (0, container_1.makeContainer)(feature, name);
 });
 program
-    .command('make:hook <feature> <name>')
-    .description('Scaffold a custom hook inside an existing feature')
-    .action((feature, name) => {
-    try {
-        (0, hook_1.makeHook)(feature, name);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .command('make:hook <target>')
+    .description('Scaffold a custom hook inside an existing feature (<feature>/<useName>)')
+    .action((target) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    (0, hook_1.makeHook)(feature, name);
 });
 program
-    .command('make:service <feature> <name>')
-    .description('Scaffold single-responsibility service files inside an existing feature')
-    .action((feature, name) => {
-    try {
-        (0, service_1.makeService)(feature, name);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .command('make:service <target>')
+    .description('Scaffold single-responsibility service files inside an existing feature (<feature>/<Entity>)')
+    .option('--side <side>', 'client, server, or both', 'both')
+    .action((target, options) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    const wrote = (0, service_1.makeService)(feature, name, (0, sides_1.parseSide)(options.side));
+    if (wrote)
+        (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Service'));
 });
 program
-    .command('make:repository <feature> <name>')
-    .description('Scaffold single-responsibility repository files inside an existing feature')
-    .action((feature, name) => {
-    try {
-        (0, repository_1.makeRepository)(feature, name);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .command('make:repository <target>')
+    .description('Scaffold single-responsibility repository files inside an existing feature (<feature>/<Entity>)')
+    .option('--side <side>', 'client, server, or both', 'both')
+    .action((target, options) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    const wrote = (0, repository_1.makeRepository)(feature, name, (0, sides_1.parseSide)(options.side));
+    if (wrote)
+        (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Repository'));
 });
 program
-    .command('make:schema <feature> <name>')
-    .description('Scaffold Zod schemas for create and update operations')
-    .action((feature, name) => {
-    try {
-        (0, schema_1.makeSchema)(feature, name);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
-    }
+    .command('make:controller <target>')
+    .description('Scaffold single-responsibility controllers or route handlers inside an existing feature (<feature>/<Entity>)')
+    .action((target) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    const wrote = (0, controller_1.makeController)(feature, name);
+    if (wrote)
+        (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Controller'));
 });
 program
-    .command('make:types <feature> <name>')
-    .description('Scaffold a types file inside an existing feature')
-    .action((feature, name) => {
-    try {
-        (0, types_1.makeTypes)(feature, name);
+    .command('make:action <target> <action>')
+    .description('Scaffold a bespoke action as its own service, repository, and controller (<feature>/<Entity> <actionName>)')
+    .option('--with-input', 'The action takes a request body validated by a Zod schema', false)
+    .option('--returns <kind>', 'list, one, or void', 'list')
+    .action((target, action, options) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    const returns = (0, action_1.parseReturns)(options.returns);
+    const wrote = (0, action_1.makeAction)(feature, name, action, { withInput: options.withInput, returns });
+    if (wrote) {
+        const { pascal } = (0, actions_1.actionCase)(action);
+        (0, hints_1.hintRegisterInModule)(feature, [`${pascal}Controller`, `${pascal}Service`, `${pascal}Repository`], `list ${pascal}Controller before Show${name}Controller in controllers`);
     }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`❌ ${message}`);
-        process.exit(1);
+});
+program
+    .command('make:schema <target>')
+    .description('Scaffold Zod schemas (and Nest DTOs) for create and update operations (<feature>/<Entity>)')
+    .action((target) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    (0, schema_1.makeSchema)(feature, name);
+});
+program
+    .command('make:types <target>')
+    .description('Scaffold a types file inside an existing feature (<feature>/<Entity>)')
+    .action((target) => {
+    const { feature, name } = (0, target_1.parseTarget)(target);
+    (0, types_1.makeTypes)(feature, name);
+});
+const INIT_ICONS = Object.freeze({
+    created: '✅',
+    updated: '✅',
+    unchanged: 'ℹ️ ',
+});
+program
+    .command('init')
+    .description('Write agent guidance into this project: AGENTS.md, CLAUDE.md, and .claude/skills/domain-driver/SKILL.md')
+    .action(() => {
+    for (const result of (0, init_1.runInit)(process.cwd())) {
+        console.log(`${INIT_ICONS[result.status]} ${result.file} ${result.status}`);
     }
 });
-program.parse();
+function fail(error) {
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    console.error(`❌ ${message}`);
+    process.exit(1);
+}
+program.parseAsync().catch(fail);

package/dist/init/content.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_CONTENT = exports.AGENTS_SECTION = void 0;
+const markers_1 = require("./markers");
+const AGENTS_LINES = [
+    markers_1.START,
+    '## Scaffolding with domain-driver',
+    '',
+    'This project uses [domain-driver](https://github.com/IsaacHatilima/domain-driver) to scaffold feature folders. Scaffold first, then fill in the generated files. Do not hand-write a layer the tool can generate.',
+    '',
+    '- New feature: `npx domain-driver make:feature <feature>/<Entity> -a`',
+    '- One layer in an existing feature: `npx domain-driver make:<layer> <feature>/<Entity>` where layer is types, schema, repository, service, controller, component, container, or hook',
+    '- Any operation that is not List, Show, Create, Update, or Delete: `npx domain-driver make:action <feature>/<Entity> <actionName>`. Add `--with-input` when it takes a request body and `--returns one|void` when it does not return a list.',
+    '',
+    'Rules the generated code follows, and that new code must keep:',
+    '',
+    '- One file per action per layer. `findActiveUsers` gets `FindActiveUsers.service.ts`, `FindActiveUsers.repository.ts`, and `FindActiveUsers.controller.ts`. It never goes inside `ShowUser.service.ts` or `ListUser.service.ts`.',
+    '- The chain is controller or hook, then service, then repository. Business logic lives in services. Data access lives in repositories. Controllers validate input and call one service.',
+    '- Feature folders are kebab-case (`coffee-type`). Entity, action, and class names are PascalCase (`CoffeeType`, `FindActiveUsers`).',
+    '- Generated repositories throw until you wire them to your data source. Generated controllers on Node need a line in `<feature>.routes.ts`, and on Nest need registering in `<feature>.module.ts`; the tool prints the exact line.',
+    '',
+    'Full guidance: `.claude/skills/domain-driver/SKILL.md`. Re-run `npx domain-driver init` after upgrading domain-driver to refresh this section.',
+    markers_1.END,
+];
+const SKILL_LINES = [
+    '---',
+    'name: domain-driver',
+    'description: Scaffold domain-driven feature folders with the domain-driver CLI. Use when creating a feature, adding a layer (types, schema, repository, service, controller, component, container, hook) to an existing feature, or adding any operation beyond List, Show, Create, Update, and Delete.',
+    '---',
+    '',
+    '# domain-driver',
+    '',
+    'Every feature lives in one folder, and every action in every layer is one file. Use the CLI to create files; write the logic inside them by hand.',
+    '',
+    '## Detect the stack',
+    '',
+    'The tool reads `package.json` and prints `Stack: <stack> (detected)` before every command. Stacks: `next-fullstack`, `next-frontend`, `react`, `node` (Express, Fastify, Hono, or none), `nest`. Override with `--stack <name>` if detection is wrong.',
+    '',
+    '## Commands',
+    '',
+    '| Task | Command |',
+    '|---|---|',
+    '| New feature with every layer | `npx domain-driver make:feature users/User -a` |',
+    '| New feature, folders only | `npx domain-driver make:feature users` |',
+    '| Entity interface | `npx domain-driver make:types users/User` |',
+    '| Create and Update schemas (and Nest DTOs) | `npx domain-driver make:schema users/User` |',
+    '| Five repositories | `npx domain-driver make:repository users/User` |',
+    '| Five services | `npx domain-driver make:service users/User` |',
+    '| Five controllers or Next route handlers | `npx domain-driver make:controller users/User` |',
+    '| A bespoke operation | `npx domain-driver make:action users/User findActiveUsers` |',
+    '| Bespoke operation with a request body | `npx domain-driver make:action users/User archiveUser --with-input --returns one` |',
+    '| Component, container, hook | `npx domain-driver make:component users/UserCard`, `make:container users/UserContainer`, `make:hook users/useUser` |',
+    '| Refresh this guidance | `npx domain-driver init` |',
+    '',
+    'On `next-fullstack`, `make:service` and `make:repository` take `--side client|server|both` (default both).',
+    '',
+    '## Rules',
+    '',
+    '1. **Scaffold before writing.** If a file the tool can generate does not exist yet, generate it. Do not create `services/FindActiveUsers.service.ts` by hand.',
+    '2. **One action, one file, every layer.** A new operation is a `make:action`, never a new method on an existing action class and never a branch inside Show or List.',
+    '3. **Keep the chain.** Controller or hook calls one service. Service calls one repository. Repositories do data access only.',
+    '4. **Names.** Feature folders kebab-case. Entities, actions, and classes PascalCase. Action names include their noun: `archiveUser`, `findActiveUsers`.',
+    '5. **Do not widen the standard five.** List returns all, Show returns one by id, Create takes the create schema, Update takes id and the update schema, Delete takes id. Anything else is a bespoke action.',
+    '6. **Finish what the tool leaves open.** Fill the `TODO` in each repository. Add the printed line to `<feature>.routes.ts` on Node or register the printed classes in `<feature>.module.ts` on Nest. Add fields to the Zod schemas.',
+    '',
+    '## Layout by stack',
+    '',
+    '- Next.js: `app/<feature>` or `src/app/<feature>`; route handlers under `app/api/<feature>`.',
+    '- React and Node: `src/features/<feature>` or `features/<feature>`.',
+    '- Nest: `src/<feature>` with a `<feature>.module.ts`.',
+];
+exports.AGENTS_SECTION = AGENTS_LINES.join('\n');
+exports.SKILL_CONTENT = `${SKILL_LINES.join('\n')}\n`;