@promptbook/cli 0.114.0-3 → 0.114.0-4

package/src/book-2.0/book-language-documentation/czechBookLanguageManualDictionary.ts

@@ -47,7 +47,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 2. **Vrstva chování**:
                 \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, \`LANGUAGE\`, \`GOAL\` a příbuzné commitmenty.
                 3. **Vrstva schopností**:
-                \`USE*\`, \`MEMORY\` a další nástrojové commitmenty, které agentovi otevírají běhové schopnosti.
+                \`USE*\` a další nástrojové commitmenty, které agentovi otevírají běhové schopnosti.
                 4. **Vrstva skládání**:
                 Dědičnost přes \`FROM\`, znovupoužití přes \`IMPORT\` a delegování přes \`TEAM\`.
             `),
@@ -69,9 +69,9 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 4. **Skládání místo jednoho velkého agenta**:
                 Na specializované odpovědnosti použijte \`TEAM\` nebo \`IMPORT\`.
                 Kompromis: režie s koordinací, výrazně lepší modularita a znovupoužitelnost.
-                5. **Řízená paměť**:
-                Pokud používáte \`MEMORY\`, popište, co se pamatovat má a co v žádném případě ne.
-                Kompromis: přísnější návrh pravidel, lepší soukromí i kvalita zapamatovaného.
+                5. **Řízená práce s daty**:
+                Pokud používáte \`USE PRIVACY\`, popište, co smí a co v žádném případě nesmí opustit konverzaci.
+                Kompromis: přísnější návrh pravidel, lepší soukromí i kvalita odpovědí.
             `),
         },
         primitives: {
@@ -102,7 +102,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 3. **Přidejte oporu ve znalostech**
                 Přidejte commitmenty \`KNOWLEDGE\` (přímý text, nebo lokální či importovatelné zdroje).
                 4. **Přidejte schopnosti**
-                Přidejte jen ty commitmenty \`USE*\` a \`MEMORY\`, které agent opravdu potřebuje.
+                Přidejte jen ty commitmenty \`USE*\`, které agent opravdu potřebuje.
                 5. **Doplňte profilová metadata**
                 Přidejte \`META DESCRIPTION\`, \`META AVATAR\` / \`META VISUAL\` nebo \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, \`META THINKING MESSAGE\` a případná upozornění.
                 6. **Připravte první interakci**
@@ -155,7 +155,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         capabilities: {
             title: 'Commitmenty USE',
             body: spaceTrim(`
-                Commitmenty \`USE*\` zapínají schopnosti (vyhledávání, prohlížeč, napojení na projekt, e-mail, generování obrázků a další).
+                Commitmenty \`USE*\` zapínají schopnosti (napojení na projekt, kalendář, generování obrázků a další).
                 Zpřístupňují běhové nástroje a doplňují pokyny do systémové zprávy.
             `),
         },
@@ -209,16 +209,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 '`CLOSED` brání tomu, aby se agent upravoval během konverzace.',
             ],
         },
-        'tool-using-browser-search-agent': {
-            title: 'Agent s nástroji (prohlížeč a vyhledávač)',
-            goal: 'Umožnit rešerši na internetu s jasnou prací se zdroji.',
-            walkthrough: [
-                '`USE SEARCH ENGINE` zpřístupní vyhledávání na webu a volitelné pokyny k němu.',
-                '`USE BROWSER` zapne stahování adres a interaktivní procházení webu.',
-                'Commitmenty `RULE` dělají požadavky na spolehlivost výslovnými a opakovatelnými.',
-                'Tento vzor se hodí pro agenty na aktuální dění a ověřování faktů.',
-            ],
-        },
         'rule-and-knowledge-agent': {
             title: 'Agent s RULE a KNOWLEDGE',
             goal: 'Opřít odpovědi o výslovná omezení a připravené zdroje.',
@@ -229,16 +219,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
                 'Tento vzor použijte pro compliance, podporu a interní postupy.',
             ],
         },
-        'memory-agent-with-long-term-memory': {
-            title: 'Agent s dlouhodobou pamětí (MEMORY)',
-            goal: 'Uchovat preference uživatele napříč konverzacemi.',
-            walkthrough: [
-                '`MEMORY` přidá běhové nástroje paměti a příslušné pokyny do systémové zprávy.',
-                'Commitmenty `RULE` zúží, co se smí pamatovat, a snižují tak rizika pro soukromí.',
-                'V Agents Serveru je paměť vedená za běhu a je vázaná na konkrétního uživatele.',
-                'Hodí se pro asistenty, kteří si musí držet kontext v čase.',
-            ],
-        },
         'use-project-integration-agent': {
             title: 'Napojení na projekt (USE PROJECT)',
             goal: 'Pracovat s repozitářem na GitHubu přes připojení projektu.',
@@ -283,7 +263,7 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
         {
             title: 'Neověřitelná tvrzení',
             dont: 'Agent odpovídá na otázky závislé na internetu bez nástrojů nebo bez uvedení zdrojů.',
-            doInstead: 'Přidejte `USE SEARCH ENGINE` / `USE BROWSER` a `RULE` zaměřené na citování.',
+            doInstead: 'Přidejte zdroje `KNOWLEDGE` a `RULE` zaměřené na citování.',
         },
         {
             title: 'Chybějící mantinely',
@@ -295,11 +275,6 @@ export const czechBookLanguageManualDictionary: BookLanguageManualDictionary = {
             dont: 'Dlouhé řetězce `FROM` bez vysvětlení, proč je každý rodič potřeba.',
             doInstead: 'Držte dědičnost mělkou a pro znovupoužití sáhněte po cíleném IMPORT nebo TEAM.',
         },
-        {
-            title: 'Nebezpečné zacházení s pamětí',
-            dont: 'Ukládání každého detailu do paměti bez jakýchkoli hranic.',
-            doInstead: 'Doplňte `MEMORY` výslovnými pravidly, co se smí uchovávat.',
-        },
     ],
     tutorialSections: {
         serverAgentsHint:

package/src/book-2.0/book-language-documentation/englishBookLanguageManualDictionary.ts

@@ -47,7 +47,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 2. **Behavior layer**:
                 \`RULE\`, \`KNOWLEDGE\`, \`WRITING SAMPLE\`, \`WRITING RULES\`, \`LANGUAGE\`, \`GOAL\`, and related commitments.
                 3. **Capability layer**:
-                \`USE*\`, \`MEMORY\`, and other tooling commitments exposing runtime abilities.
+                \`USE*\` and other tooling commitments exposing runtime abilities.
                 4. **Composition layer**:
                 \`FROM\` inheritance, \`IMPORT\` reuse, and \`TEAM\` delegation.
             `),
@@ -69,8 +69,8 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 4. **Composition over monoliths**:
                 Use \`TEAM\`/\`IMPORT\` for specialized responsibilities.
                 Tradeoff: orchestration overhead, stronger modularity and reuse.
-                5. **Controlled memory**:
-                If using \`MEMORY\`, define what must and must not be remembered.
+                5. **Controlled data access**:
+                If using \`USE PRIVACY\`, define what must and must not leave the conversation.
                 Tradeoff: stricter policy design, better privacy and signal quality.
             `),
         },
@@ -102,7 +102,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 3. **Add grounding**
                 Add \`KNOWLEDGE\` commitments (inline text or local/importable sources).
                 4. **Add capabilities**
-                Add only necessary \`USE*\` and/or \`MEMORY\` commitments.
+                Add only necessary \`USE*\` commitments.
                 5. **Set profile metadata**
                 Add \`META DESCRIPTION\`, \`META AVATAR\` / \`META VISUAL\` or \`META IMAGE\`, \`META INPUT PLACEHOLDER\`, \`META THINKING MESSAGE\`, and disclaimers if needed.
                 6. **Add first interaction**
@@ -155,7 +155,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         capabilities: {
             title: 'USE commitments',
             body: spaceTrim(`
-                \`USE*\` commitments enable capabilities (search, browser, project integration, email, image generation, etc.).
+                \`USE*\` commitments enable capabilities (project integration, calendar, image generation, etc.).
                 They expose runtime tools and system-message guidance used during execution.
             `),
         },
@@ -209,16 +209,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 '`CLOSED` prevents conversational self-modification.',
             ],
         },
-        'tool-using-browser-search-agent': {
-            title: 'Tool-using agent (Browser + Search engine)',
-            goal: 'Enable internet research with clear sourcing behavior.',
-            walkthrough: [
-                '`USE SEARCH ENGINE` provides web search tooling and optional search instructions.',
-                '`USE BROWSER` enables URL fetching and interactive browsing tools.',
-                '`RULE` commitments make reliability behavior explicit and repeatable.',
-                'This pattern is ideal for current-events and fact-checking agents.',
-            ],
-        },
         'rule-and-knowledge-agent': {
             title: 'Agent with RULE and KNOWLEDGE',
             goal: 'Ground responses in explicit constraints and curated sources.',
@@ -229,16 +219,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
                 'Use this pattern for compliance, support, and internal procedures.',
             ],
         },
-        'memory-agent-with-long-term-memory': {
-            title: 'MEMORY agent with long-term memory',
-            goal: 'Persist user preferences across conversations.',
-            walkthrough: [
-                '`MEMORY` adds runtime memory tools and memory-specific system guidance.',
-                '`RULE` commitments narrow what should be remembered to reduce privacy risks.',
-                'In Agents Server, memory is runtime-backed and user-scoped.',
-                'Use this for assistants that must preserve context over time.',
-            ],
-        },
         'use-project-integration-agent': {
             title: 'USE PROJECT external integration',
             goal: 'Work with a GitHub repository through a connected project integration.',
@@ -283,7 +263,7 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
         {
             title: 'Unverifiable claims',
             dont: 'The agent answers internet-dependent questions without tools or without citing sources.',
-            doInstead: 'Add `USE SEARCH ENGINE` / `USE BROWSER` and a citation-oriented `RULE`.',
+            doInstead: 'Add `KNOWLEDGE` sources and a citation-oriented `RULE`.',
         },
         {
             title: 'Missing guardrails',
@@ -295,11 +275,6 @@ export const englishBookLanguageManualDictionary: BookLanguageManualDictionary =
             dont: 'Using deep `FROM` chains without documenting why each parent is needed.',
             doInstead: 'Keep inheritance shallow and use focused IMPORT/TEAM composition for reuse.',
         },
-        {
-            title: 'Unsafe memory usage',
-            dont: 'Storing every detail in memory without boundaries.',
-            doInstead: 'Pair `MEMORY` with explicit rules about what is allowed to persist.',
-        },
     ],
     tutorialSections: {
         serverAgentsHint:

package/src/book-components/BookEditor/useBookEditorMonacoLanguage.ts

@@ -162,7 +162,7 @@ function createCommitmentRegex(commitmentTypes: ReadonlyArray<string>): RegExp {
 
     const commitmentPatterns = [...commitmentTypes]
         .sort((a: string, b: string) => b.length - a.length)
-        .map((type: string) => (type === 'META' ? 'META\\s+\\w+' : type.replace(/\s+/, '\\s+')))
+        .map((type: string) => type.replace(/\s+/, '\\s+'))
         .join('|');
 
     return new RegExp(`^\\s*(${commitmentPatterns})(?=\\s|$)`);

package/src/cli/cli-commands/coder/boilerplateCount.ts

@@ -0,0 +1,139 @@
+import { spaceTrim } from 'spacetrim';
+import { NotAllowed } from '../../../errors/NotAllowed';
+
+/**
+ * Separator between the number of generated files and the number of prompts in each of them,
+ * for example `10*7`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+const BOILERPLATE_COUNT_SEPARATOR = '*';
+
+/**
+ * Pattern of the `--count` option value, either `N` or `N*M`.
+ */
+const BOILERPLATE_COUNT_PATTERN = /^(?<filesCount>\d+)(?:\s*\*\s*(?<promptsPerFileCount>\d+))?$/u;
+
+/**
+ * How many prompt boilerplate files are generated and how many prompts each of them contains.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type BoilerplateCount = {
+    /**
+     * Number of generated prompt boilerplate files.
+     */
+    readonly filesCount: number;
+
+    /**
+     * Number of prompts written into each generated file.
+     *
+     * Note: More than one prompt per file is an advanced option - each prompt is one separate
+     *       coding task separated by `---` and tagged with its own fresh emoji tag.
+     */
+    readonly promptsPerFileCount: number;
+};
+
+/**
+ * Number of prompt boilerplate files and prompts per file used when `--count` is not provided.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const DEFAULT_BOILERPLATE_COUNT: BoilerplateCount = {
+    filesCount: 5,
+    promptsPerFileCount: 1,
+};
+
+/**
+ * Formats one boilerplate count back into the `N*M` notation of the `--count` option.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export function formatBoilerplateCount({ filesCount, promptsPerFileCount }: BoilerplateCount): string {
+    return `${filesCount}${BOILERPLATE_COUNT_SEPARATOR}${promptsPerFileCount}`;
+}
+
+/**
+ * Default value of the `--count` option rendered in the `N*M` notation, for example `5*1`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE = formatBoilerplateCount(DEFAULT_BOILERPLATE_COUNT);
+
+/**
+ * Description of the `--count` option shared by all commands which generate prompt boilerplates.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const BOILERPLATE_COUNT_OPTION_DESCRIPTION = spaceTrim(`
+    Number of generated prompt boilerplate files, optionally with the number of prompts in each of them.
+
+    Use \`N\` (or \`N*1\`) for N files with one prompt each,
+    or the advanced \`N*M\` notation for N files with M prompts each, for example \`10*7\`.
+`);
+
+/**
+ * Parses the `--count` option value into the number of files and the number of prompts in each of them.
+ *
+ * Both notations are supported:
+ * - `N` and `N*1` => N files with one prompt each
+ * - `N*M` => N files with M prompts each
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export function parseBoilerplateCount(countOption: string): BoilerplateCount {
+    const normalizedCountOption = countOption.trim();
+    const match = BOILERPLATE_COUNT_PATTERN.exec(normalizedCountOption);
+
+    if (match === null) {
+        throw new NotAllowed(
+            spaceTrim(`
+                Invalid value for \`--count\`: \`${countOption}\`.
+
+                Use either \`N\` for N files with one prompt each,
+                or the advanced \`N*M\` notation for N files with M prompts each:
+
+                - \`--count 5\`
+                - \`--count 5*1\`
+                - \`--count 10*7\`
+            `),
+        );
+    }
+
+    const filesCount = Number(match.groups?.filesCount);
+    const promptsPerFileCount =
+        match.groups?.promptsPerFileCount === undefined
+            ? DEFAULT_BOILERPLATE_COUNT.promptsPerFileCount
+            : Number(match.groups.promptsPerFileCount);
+
+    assertsPositiveBoilerplateCountPart(filesCount, countOption, 'number of generated files');
+    assertsPositiveBoilerplateCountPart(promptsPerFileCount, countOption, 'number of prompts in each file');
+
+    return { filesCount, promptsPerFileCount };
+}
+
+/**
+ * Asserts that one part of the `--count` option value is a positive integer.
+ *
+ * @private internal utility of `parseBoilerplateCount`
+ */
+function assertsPositiveBoilerplateCountPart(
+    countPart: number,
+    countOption: string,
+    countPartDescription: string,
+): void {
+    if (Number.isInteger(countPart) && countPart > 0) {
+        return;
+    }
+
+    throw new NotAllowed(
+        spaceTrim(`
+            Invalid value for \`--count\`: \`${countOption}\`.
+
+            The ${countPartDescription} must be **a positive integer**, for example \`--count 10*7\`.
+        `),
+    );
+}
+
+// Note: [🟡] Code for coder boilerplate count [boilerplateCount](src/cli/cli-commands/coder/boilerplateCount.ts) should never be published outside of `@promptbook/cli`
+// Note: [💞] Ignore a discrepancy between file name and exported helper names

package/src/cli/cli-commands/coder/generate-boilerplates.ts

@@ -13,6 +13,13 @@ import {
     normalizeCoderGitSyncCliOptions,
 } from '../common/coderGitSyncCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
+import type { BoilerplateCount } from './boilerplateCount';
+import {
+    BOILERPLATE_COUNT_OPTION_DESCRIPTION,
+    DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE,
+    formatBoilerplateCount,
+    parseBoilerplateCount,
+} from './boilerplateCount';
 import {
     buildCoderPromptSection,
     getDefaultCoderPromptTemplateDefinitions,
@@ -39,7 +46,7 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
         ),
     );
 
-    command.option('--count <count>', `Number of prompt boilerplate files to generate`, '5');
+    command.option('--count <count>', BOILERPLATE_COUNT_OPTION_DESCRIPTION, DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE);
     command.option(
         '--template <template>',
         spaceTrim(`
@@ -59,7 +66,7 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
                 readonly template?: string;
             } & CoderGitSyncCliOptions;
 
-            const filesCount = parseFilesCount(countOption);
+            const boilerplateCount = parseBoilerplateCount(countOption);
             const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
             const projectPath = process.cwd();
 
@@ -72,14 +79,14 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
 
             await generatePromptBoilerplate({
                 projectPath,
-                filesCount,
+                boilerplateCount,
                 templateOption,
             });
 
             await $commitCoderChanges({
                 gitSync,
                 projectPath,
-                commitMessage: `Prompts ${filesCount}x`,
+                commitMessage: `Prompts ${formatBoilerplateCount(boilerplateCount)}`,
             });
 
             return process.exit(0);
@@ -94,13 +101,15 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
  */
 export async function generatePromptBoilerplate({
     projectPath,
-    filesCount,
+    boilerplateCount,
     templateOption,
 }: {
     readonly projectPath: string;
-    readonly filesCount: number;
+    readonly boilerplateCount: BoilerplateCount;
     readonly templateOption?: string;
 }): Promise<void> {
+    const { filesCount, promptsPerFileCount } = boilerplateCount;
+
     // Note: Import these dynamically to avoid circular dependencies and keep CLI fast
     const { buildPromptFilename, getPromptNumbering } = await import(
         '../../../../scripts/utils/prompts/getPromptNumbering'
@@ -125,8 +134,10 @@ export async function generatePromptBoilerplate({
         colors.blue(`Highest existing number for ${promptNumbering.datePrefix} found: ${highestNumberFormatted}`),
     );
 
+    // Note: Every single generated prompt is one separate coding task, so each of them reserves its own fresh emoji tag
+    const promptsCount = filesCount * promptsPerFileCount;
     const { availableCount, selectedEmojis } = await getFreshPromptEmojiTags({
-        count: filesCount,
+        count: promptsCount,
         rootDir: projectPath,
     });
 
@@ -143,7 +154,9 @@ export async function generatePromptBoilerplate({
     for (let i = 0; i < filesCount; i++) {
         const number = promptNumbering.startNumber + i * promptNumbering.step;
         const title = titles[i % titles.length]!;
-        const emoji = selectedEmojis[i]!;
+        const emojiTags = selectedEmojis
+            .slice(i * promptsPerFileCount, (i + 1) * promptsPerFileCount)
+            .map((emoji) => formatPromptEmojiTag(emoji));
         const filename = buildPromptFilename(
             promptNumbering.datePrefix,
             number,
@@ -151,39 +164,18 @@ export async function generatePromptBoilerplate({
         );
         const filepath = join(PROMPTS_DIRECTORY_PATH, filename);
         const absoluteFilepath = join(projectPath, filepath);
-        const emojiTag = formatPromptEmojiTag(emoji);
-        const one = buildCoderPromptSection({
-            statusLine: '[-]',
-            emojiTag,
+        const content = buildBoilerplatePromptFileContent({
+            emojiTags,
             title,
             body: promptTemplate.content,
         });
-        const content = spaceTrim(
-            (block) => `
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-            `,
-        );
 
         filesToCreate.push({
             filepath,
             absoluteFilepath,
             filename,
             content,
-            emoji,
+            emojiTags,
             number,
         });
     }
@@ -193,26 +185,42 @@ export async function generatePromptBoilerplate({
 
     for (const file of filesToCreate) {
         writeFileSync(file.absoluteFilepath, file.content, 'utf-8');
-        console.info(colors.green(`✓ Created: ${file.filename} with ${formatPromptEmojiTag(file.emoji!)}`));
+        console.info(colors.green(`✓ Created: ${file.filename} with ${file.emojiTags.join(' ')}`));
     }
 
-    console.info(colors.bgGreen(` Successfully created ${filesToCreate.length} prompt boilerplate files! `));
+    console.info(
+        colors.bgGreen(
+            ` Successfully created ${promptsCount} prompts in ${filesToCreate.length} prompt boilerplate files! `,
+        ),
+    );
 }
 
 /**
- * Parses and validates the count of boilerplate files to create.
+ * Builds the markdown content of one generated prompt file with one prompt section per emoji tag.
+ *
+ * Multiple prompts in one file are separated by the `---` separator, exactly like the prompt runner expects them.
  *
  * @private internal utility of `generatePromptBoilerplate` command
  */
-function parseFilesCount(countOption: string): number {
-    const filesCount = Number(countOption);
-
-    if (!Number.isFinite(filesCount) || filesCount <= 0) {
-        console.info(colors.yellow(`Invalid --count '${countOption}'. Falling back to default 5.`));
-        return 5;
-    }
-
-    return Math.floor(filesCount);
+function buildBoilerplatePromptFileContent({
+    emojiTags,
+    title,
+    body,
+}: {
+    readonly emojiTags: ReadonlyArray<string>;
+    readonly title: string;
+    readonly body: string;
+}): string {
+    return emojiTags
+        .map((emojiTag) =>
+            buildCoderPromptSection({
+                statusLine: '[-]',
+                emojiTag,
+                title,
+                body,
+            }),
+        )
+        .join('\n\n---\n\n');
 }
 
 /**

package/src/cli/cli-commands/coder/getDefaultCoderPackageJsonScripts.ts

@@ -1,8 +1,10 @@
+import { DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE } from './boilerplateCount';
+
 /**
  * Default npm scripts initialized by `ptbk coder init`.
  */
 const DEFAULT_CODER_PACKAGE_JSON_SCRIPTS = {
-    'coder:generate-boilerplates': 'ptbk coder generate-boilerplates --template ./prompts/templates/common.md',
+    'coder:generate-boilerplates': `ptbk coder generate-boilerplates --count ${DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE} --template ./prompts/templates/common.md`,
     'coder:add': 'ptbk coder add --template ./prompts/templates/common.md',
     'coder:run':
         'ptbk coder run --harness openai-codex --model gpt-5.6-terra --thinking-level max --agent agents/developer.book --context AGENTS.md --test-before yes-and-fix',

package/src/cli/cli-commands/coder/init.ts

@@ -15,6 +15,7 @@ import { getHarnessDefinition } from '../common/harness/HarnessDefinition';
 import type { PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
 import { AGENT_CODING_FILE_PATH } from './agentCodingFile';
 import { AGENTS_FILE_PATH } from './agentsFile';
+import { DEFAULT_BOILERPLATE_COUNT } from './boilerplateCount';
 import { getDefaultCoderProjectPromptTemplateDefinitions } from './boilerplateTemplates';
 import { CODER_DEVELOPER_AGENT_FILE_PATH } from './ensureCoderDeveloperAgentFile';
 import { formatDisplayPath } from './formatDisplayPath';
@@ -89,7 +90,7 @@ export function $initializeCoderInitCommand(program: Program): $side_effect {
 
             const summary = await initializeCoderProjectConfiguration(projectPath);
             printInitializationSummary(summary);
-            await generatePromptBoilerplate({ projectPath, filesCount: 5 });
+            await generatePromptBoilerplate({ projectPath, boilerplateCount: DEFAULT_BOILERPLATE_COUNT });
 
             await $commitCoderChanges({
                 gitSync,

package/src/commitments/ACTION/ACTION.ts

@@ -66,7 +66,7 @@ export class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION
             Research Assistant
 
             PERSONA You are a helpful research assistant
-            USE SEARCH ENGINE
+            USE MCP https://mcp.example.com/server
             RULE Always cite your sources when providing information from the web
             \`\`\`
 
@@ -86,8 +86,8 @@ export class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION
             Code Assistant
 
             PERSONA You are a programming assistant
-            USE BROWSER
-            USE SEARCH ENGINE
+            USE PROJECT https://github.com/example/project
+            USE MCP https://mcp.example.com/server
             RULE Prefer the narrowest useful capability for the task.
             \`\`\`
         `);

package/src/commitments/{META → META_DESCRIPTION}/META_DESCRIPTION.ts

@@ -20,7 +20,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  */
 export class MetaDescriptionCommitmentDefinition extends BaseCommitmentDefinition<'META DESCRIPTION'> {
     public constructor() {
-        super('META DESCRIPTION', ['DESCRIPTION']);
+        super('META DESCRIPTION');
     }
 
     /**

package/src/commitments/META_FULLNAME/META_FULLNAME.ts

@@ -0,0 +1,70 @@
+import { spaceTrim } from 'spacetrim';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { TODO_USE } from '../../utils/organization/TODO_USE';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+
+/**
+ * META FULLNAME commitment definition
+ *
+ * The `META FULLNAME` commitment sets the full display name of the agent, which can differ
+ * from the agent name on the first line of the agent source, for example when the agent
+ * should be presented with academic titles.
+ * This commitment is metadata-only and does not modify model requirements.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export class MetaFullnameCommitmentDefinition extends BaseCommitmentDefinition<'META FULLNAME'> {
+    public constructor() {
+        super('META FULLNAME');
+    }
+
+    /**
+     * Short one-line description of META FULLNAME.
+     */
+    get description(): string {
+        return "Set the agent's full display name.";
+    }
+
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string {
+        return '🪪';
+    }
+
+    /**
+     * Markdown documentation for META FULLNAME commitment.
+     */
+    get documentation(): string {
+        return spaceTrim(`
+            # META FULLNAME
+
+            Sets the full display name of the agent shown in profiles, chats, and exports.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - If not present, the agent name from the first line of the agent source is used.
+            - If multiple \`META FULLNAME\` commitments are specified, the last one takes precedence.
+
+            ## Examples
+
+            \`\`\`book
+            Pavol Hejný
+
+            META FULLNAME Dr. Ing. Pavol Hejný, PhD.
+            PERSONA Developer with 10 years of experience in building AI applications.
+            \`\`\`
+        `);
+    }
+
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements {
+        TODO_USE(content);
+
+        // META FULLNAME does not modify the model requirements.
+        // It is consumed by profile parsing.
+        return requirements;
+    }
+}
+
+// Note: [💞] Ignore a discrepancy between file name and entity name