@aksp/opencrew 1.4.1 → 1.5.0

package/src/commands/init.js

@@ -2,26 +2,30 @@ import path from 'node:path';
 import { promises as fs } from 'node:fs';
 import { templatesDir, packageJsonPath } from '../lib/paths.js';
 import { copyDir, exists, writeFileSafe, readJson, writeBridgeFile } from '../lib/fsx.js';
-import { ideById, allIdeIds } from '../lib/ides.js';
-import { pickIdes } from '../lib/prompts.js';
+import { ideById, allIdeIds, AGENTS_BRIDGE } from '../lib/ides.js';
+import { pickIdes as promptIdes } from '../lib/prompts.js';
+import { UsageError } from '../lib/errors.js';
 import { c, log, info, ok, warn, step } from '../lib/ui.js';
 
-export async function init(opts = {}) {
+const STAMP = path.join('_opencrew', '.opencrew-version');
+// .gitignore / .env.example belong to the user: opencrew only owns a marked block at the end.
+const SHARED_BLOCK = { comment: 'hash', position: 'append' };
+
+/**
+ * @param {object} opts  parsed CLI options
+ * @param {{ pickIdes?: () => Promise<string[]> }} deps  injectable for tests
+ */
+export async function init(opts = {}, { pickIdes = promptIdes } = {}) {
   const target = process.cwd();
   const pkg = await readJson(packageJsonPath);
   const version = pkg.version;
-  const repairBridges = opts['repair-bridges'];
-
-  const alreadyInstalled = await exists(path.join(target, '_opencrew', 'core'));
+  const state = await workspaceState(target);
 
   // --repair-bridges mode: regenerate IDE bridge files in an existing workspace.
-  if (repairBridges && alreadyInstalled) {
+  if (opts['repair-bridges'] && state !== 'none') {
+    const ids = await resolveIdes(opts, async () => allIdeIds());
     log(`\n${c.bold(c.cyan('opencrew'))} ${c.dim('v' + version)} — repairing IDE bridges`);
     log(c.dim(`Target: ${target}\n`));
-
-    let ids = normalizeIdes(opts.ide);
-    if (opts.all) ids = allIdeIds();
-    if (opts.yes || !ids) ids = allIdeIds();
     await writeBridges(target, ids, { overwrite: true });
 
     log(`\n${c.green(c.bold('Done!'))} IDE bridges regenerated.\n`);
@@ -29,7 +33,7 @@ export async function init(opts = {}) {
     return;
   }
 
-  if (alreadyInstalled) {
+  if (state === 'complete') {
     warn('An opencrew workspace already exists here.');
     info(`To update only the framework, use: ${c.cyan('npx @aksp/opencrew update')}`);
     info(`To repair IDE bridges, use: ${c.cyan('npx @aksp/opencrew init --repair-bridges')}`);
@@ -37,28 +41,18 @@ export async function init(opts = {}) {
     return;
   }
 
+  // Every choice is resolved BEFORE the first write: a bad --ide or Ctrl+C on the
+  // prompt leaves the folder exactly as it was.
+  const ids = await resolveIdes(opts, pickIdes);
+
   log(`\n${c.bold(c.cyan('opencrew'))} ${c.dim('v' + version)} — scaffolding a crew workspace`);
   log(c.dim(`Target: ${target}\n`));
+  if (state === 'partial') info('A previous install was interrupted — resuming (existing files are kept).');
 
   // 1. Copy the framework payload (never clobber user work).
   step('Installing framework files');
-  const copied = { count: 0 };
-  await copyDir(path.join(templatesDir, '_opencrew'), path.join(target, '_opencrew'), {
-    overwrite: false,
-    // Never ship stray logs or browser sessions; keep the empty dir via .gitkeep only.
-    skip: (rel) =>
-      (rel.startsWith('logs/') && rel !== 'logs/.gitkeep') ||
-      rel.startsWith('_browser_profile/'),
-    onCopy: () => (copied.count += 1),
-  });
-  await copyDir(path.join(templatesDir, 'skills'), path.join(target, 'skills'), {
-    overwrite: false,
-    onCopy: () => (copied.count += 1),
-  });
-  await copyDir(path.join(templatesDir, 'crews'), path.join(target, 'crews'), {
-    overwrite: false,
-  });
-  ok(`Framework files ready (${copied.count} written, existing files preserved)`);
+  const copied = await installPayload(target);
+  ok(`Framework files ready (${copied} written, existing files preserved)`);
 
   // 2. System doc + root configs.
   step('Writing configuration');
@@ -68,13 +62,7 @@ export async function init(opts = {}) {
   await writeFileSafe(path.join(target, '_opencrew', 'core', 'system.md'), await tpl('AGENTS.md'));
   ok('_opencrew/core/system.md (full system definition)');
 
-  const agentsBridge = '# opencrew\n\n'
-    + 'The opencrew system definition lives at `_opencrew/core/system.md`.\n'
-    + 'Read that file and adopt the opencrew system role — follow all initialization,\n'
-    + 'command routing, and workflow instructions defined there.\n\n'
-    + 'Type `/opencrew` to open the main menu.\n';
-
-  const agentsResult = await writeBridgeFile(path.join(target, 'AGENTS.md'), agentsBridge);
+  const agentsResult = await writeBridgeFile(path.join(target, 'AGENTS.md'), AGENTS_BRIDGE);
   if (agentsResult.merged) info('AGENTS.md (merged — existing content preserved)');
   else ok('AGENTS.md (bridge to system.md)');
 
@@ -83,18 +71,13 @@ export async function init(opts = {}) {
   });
   info(mcpWritten ? '.mcp.json' : '.mcp.json (kept existing)');
 
-  await writeFileSafe(path.join(target, '.env.example'), await tpl('.env.example'));
-  const giWritten = await writeFileSafe(path.join(target, '.gitignore'), await tpl('gitignore'), {
-    overwrite: false,
-  });
-  info(giWritten ? '.gitignore' : '.gitignore (kept existing)');
+  for (const [file, template] of [['.env.example', '.env.example'], ['.gitignore', 'gitignore']]) {
+    const res = await writeBridgeFile(path.join(target, file), await tpl(template), SHARED_BLOCK);
+    info(res.merged ? `${file} (opencrew block added at the end — your lines kept)` : file);
+  }
 
   // 3. IDE bridge files.
   step('Configuring AI IDEs');
-  let ids = normalizeIdes(opts.ide);
-  if (opts.all) ids = allIdeIds();
-  if (opts.yes) ids = allIdeIds();
-  if (!ids) ids = await pickIdes();
   await writeBridges(target, ids, { overwrite: false });
 
   if (ids.includes('claude-code')) {
@@ -102,8 +85,8 @@ export async function init(opts = {}) {
     warn(`native Playwright plugin/extension to avoid the two conflicting.`);
   }
 
-  // 4. Version stamp.
-  await fs.writeFile(path.join(target, '_opencrew', '.opencrew-version'), version + '\n');
+  // 4. Version stamp — written LAST: it is what marks the install as complete.
+  await fs.writeFile(path.join(target, STAMP), version + '\n');
 
   // 5. Done.
   log(`\n${c.green(c.bold('Done!'))} opencrew is installed.\n`);
@@ -113,10 +96,56 @@ export async function init(opts = {}) {
   log(`     No API keys needed up front — opencrew asks for them in chat only if a skill you use requires one.\n`);
 }
 
+/**
+ * Copy the framework payload into `target` without overwriting anything.
+ * Never copies the version stamp: only a finished init writes it.
+ * @returns {Promise<number>} files written
+ */
+export async function installPayload(target) {
+  let count = 0;
+  const onCopy = () => (count += 1);
+  await copyDir(path.join(templatesDir, '_opencrew'), path.join(target, '_opencrew'), {
+    overwrite: false,
+    // Never ship stray logs, browser sessions or the template's own stamp.
+    skip: (rel) =>
+      (rel.startsWith('logs/') && rel !== 'logs/.gitkeep') ||
+      rel.startsWith('_browser_profile/') ||
+      rel === '.opencrew-version',
+    onCopy,
+  });
+  await copyDir(path.join(templatesDir, 'skills'), path.join(target, 'skills'), { overwrite: false, onCopy });
+  await copyDir(path.join(templatesDir, 'crews'), path.join(target, 'crews'), { overwrite: false });
+  return count;
+}
+
+/** 'none' (no core) · 'partial' (core without stamp: interrupted install) · 'complete'. */
+async function workspaceState(target) {
+  if (!(await exists(path.join(target, '_opencrew', 'core')))) return 'none';
+  return (await exists(path.join(target, STAMP))) ? 'complete' : 'partial';
+}
+
+/**
+ * Decide which IDEs to configure. --all / --yes → every IDE; --ide → validated list;
+ * nothing → `fallback()` (the interactive prompt). Throws UsageError if --ide names no
+ * valid IDE.
+ */
+async function resolveIdes(opts, fallback) {
+  if (opts.all || opts.yes) return allIdeIds();
+  const ids = normalizeIdes(opts.ide);
+  if (!ids) return fallback();
+  const invalid = ids.filter((id) => !ideById(id));
+  const valid = ids.filter((id) => ideById(id));
+  if (!valid.length) {
+    throw new UsageError(`Unknown IDE "${invalid.join('", "')}". Valid: ${allIdeIds().join(', ')}`);
+  }
+  for (const id of invalid) warn(`Unknown IDE "${id}" — skipped. Valid: ${allIdeIds().join(', ')}`);
+  return valid;
+}
+
 /**
  * Write IDE bridge files to the target directory.
  * @param {string} target — project root
- * @param {string[]} ids — IDE ids to configure
+ * @param {string[]} ids — validated IDE ids to configure
  * @param {{ overwrite: boolean }} opts
  */
 async function writeBridges(target, ids, { overwrite }) {
@@ -124,10 +153,6 @@ async function writeBridges(target, ids, { overwrite }) {
 
   for (const id of ids) {
     const ide = ideById(id);
-    if (!ide) {
-      warn(`Unknown IDE "${id}" — skipped. Valid: ${allIdeIds().join(', ')}`);
-      continue;
-    }
     for (const f of ide.files) {
       if (writtenPaths.has(f.path)) {
         info(`${f.path} (shared path — written once)`);
@@ -155,5 +180,6 @@ async function tpl(name) {
 function normalizeIdes(val) {
   if (!val || val === true) return null;
   const list = Array.isArray(val) ? val : String(val).split(',');
-  return list.map((s) => s.trim()).filter(Boolean);
+  const ids = list.map((s) => s.trim()).filter(Boolean);
+  return ids.length ? ids : null;
 }

package/src/commands/update.js

@@ -2,10 +2,12 @@ import path from 'node:path';
 import { promises as fs } from 'node:fs';
 import { templatesDir, packageJsonPath } from '../lib/paths.js';
 import { copyDir, exists, writeFileSafe, readJson, writeBridgeFile, readFile } from '../lib/fsx.js';
+import { AGENTS_BRIDGE, LEAKED_STATUS_SECTION, ideById } from '../lib/ides.js';
 import { c, log, info, ok, warn, step } from '../lib/ui.js';
 
 // Update refreshes ONLY the framework. It never touches:
-//   crews/, _opencrew/_memory/, _opencrew/_browser_profile/, .env, IDE bridges.
+//   crews/, _opencrew/_memory/, _opencrew/_browser_profile/, .env, IDE bridges
+//   (one exception: the CLAUDE.md block leaked by 1.4.0/1.4.1 — see removeLeakedStatusSection).
 // Note: catalog skills (skills/<name>/ that ship with the package) ARE fully
 // overwritten below — user edits to a catalog skill's own files are not preserved.
 // Only skill directories that don't exist in the package's templates/skills/ at all
@@ -72,24 +74,49 @@ export async function update(opts = {}) {
   await writeFileSafe(path.join(target, '_opencrew', 'core', 'system.md'), systemContent);
   ok('_opencrew/core/system.md refreshed');
 
-  const agentsBridge = '# opencrew\n\n'
-    + 'The opencrew system definition lives at `_opencrew/core/system.md`.\n'
-    + 'Read that file and adopt the opencrew system role — follow all initialization,\n'
-    + 'command routing, and workflow instructions defined there.\n\n'
-    + 'Type `/opencrew` to open the main menu.\n';
-
-  // If AGENTS.md is a legacy full-system doc (pre-v1.3), replace it entirely with the thin bridge.
-  const agentsPath = path.join(target, 'AGENTS.md');
-  const existingAgents = await readFile(agentsPath);
-  if (existingAgents.includes('# opencrew Instructions') && !existingAgents.includes('<!-- opencrew:start -->')) {
-    await writeFileSafe(agentsPath, agentsBridge);
-    ok('AGENTS.md (migrated from legacy full-system to thin bridge)');
-  } else {
-    await writeBridgeFile(agentsPath, agentsBridge);
-    ok('AGENTS.md refreshed');
-  }
+  await refreshAgentsBridge(target);
+  await removeLeakedStatusSection(target);
 
+  // Stamp last: a crash above leaves the old version, so the next update retries.
   await fs.writeFile(versionFile, version + '\n');
   log(`\n${c.green(c.bold('Updated to v' + version))}.`);
   log(c.dim('Your crews, memory, IDE bridges and .env were left untouched.\n'));
 }
+
+// Root AGENTS.md: create it if missing; a legacy full-system doc (pre-v1.3) is backed up
+// byte for byte and replaced by the thin bridge; otherwise only the marked block changes.
+async function refreshAgentsBridge(target) {
+  const agentsPath = path.join(target, 'AGENTS.md');
+  if (!(await exists(agentsPath))) {
+    await writeBridgeFile(agentsPath, AGENTS_BRIDGE);
+    ok('AGENTS.md (bridge created)');
+    return;
+  }
+  const existing = await readFile(agentsPath);
+  if (existing.includes('# opencrew Instructions') && !existing.includes('<!-- opencrew:start -->')) {
+    const backup = await freeBackupPath(agentsPath);
+    await fs.copyFile(agentsPath, backup);
+    await writeFileSafe(agentsPath, AGENTS_BRIDGE);
+    ok(`AGENTS.md (migrated from legacy full-system to thin bridge — backed up to ${path.basename(backup)})`);
+    return;
+  }
+  await writeBridgeFile(agentsPath, AGENTS_BRIDGE);
+  ok('AGENTS.md refreshed');
+}
+
+async function freeBackupPath(file) {
+  const bak = `${file}.bak`;
+  if (!(await exists(bak))) return bak;
+  return `${file}.bak-${new Date().toISOString().replace(/[:.]/g, '-')}`;
+}
+
+// 1.4.0/1.4.1 shipped the maintainer's STATUS.md workflow inside CLAUDE.md's opencrew
+// block. Rewrite that block (only that block, only if the leak is there).
+async function removeLeakedStatusSection(target) {
+  const claudePath = path.join(target, 'CLAUDE.md');
+  if (!(await exists(claudePath))) return;
+  if (!(await readFile(claudePath)).includes(LEAKED_STATUS_SECTION)) return;
+  const bridge = ideById('claude-code').files.find((f) => f.path === 'CLAUDE.md');
+  await writeBridgeFile(claudePath, bridge.content);
+  ok('CLAUDE.md (removed the STATUS.md section shipped by mistake in 1.4.0/1.4.1)');
+}

package/src/lib/errors.js

@@ -0,0 +1,12 @@
+// Error types the CLI turns into exit codes (see src/cli.js → exitCodeFor).
+
+/** Wrong flags/arguments — reported in one line, exit 1, nothing written. */
+export class UsageError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'UsageError';
+  }
+}
+
+/** @inquirer throws this when the user presses Ctrl+C on a prompt. */
+export const isPromptCancel = (e) => e?.name === 'ExitPromptError';

package/src/lib/fsx.js

@@ -54,17 +54,21 @@ export async function writeFileSafe(p, content, { overwrite = true } = {}) {
  * Write a bridge file using marked-block strategy.
  * - File doesn't exist → creates with content wrapped in HTML markers
  * - File exists with markers → replaces only the block between markers
- * - File exists without markers → prepends marked block, preserves existing content
+ * - File exists without markers → adds the marked block (prepend or append), preserving
+ *   existing content byte for byte
  *
  * @param {string}   p       File path
  * @param {string}   block   Content to place between markers
  * @param {object}   opts
- * @param {string}   opts.marker  Marker name (default: 'opencrew')
+ * @param {string}   opts.marker    Marker name (default: 'opencrew')
+ * @param {'html'|'hash'} opts.comment  `<!-- x:start -->` (markdown) or `# x:start` (.gitignore, .env)
+ * @param {'prepend'|'append'} opts.position  Where a new block goes in an unmarked file
  * @returns {Promise<{written: boolean, merged: boolean}>}
  */
-export async function writeBridgeFile(p, block, { marker = 'opencrew' } = {}) {
-  const start = `<!-- ${marker}:start -->`;
-  const end = `<!-- ${marker}:end -->`;
+export async function writeBridgeFile(p, block, { marker = 'opencrew', comment = 'html', position = 'prepend' } = {}) {
+  const [start, end] = comment === 'hash'
+    ? [`# ${marker}:start`, `# ${marker}:end`]
+    : [`<!-- ${marker}:start -->`, `<!-- ${marker}:end -->`];
   const marked = `${start}\n${block.trimEnd()}\n${end}`;
 
   if (!(await exists(p))) {
@@ -77,9 +81,11 @@ export async function writeBridgeFile(p, block, { marker = 'opencrew' } = {}) {
 
   // Already has markers → replace just the block, keep everything else
   if (existing.includes(start) && existing.includes(end)) {
+    // Innermost block only: an orphan start marker (end deleted by hand) must never make
+    // the match swallow the user lines between it and the real block.
     const updated = existing.replace(
-      new RegExp(escapeRx(start) + '[\\s\\S]*?' + escapeRx(end), 'g'),
-      marked,
+      new RegExp(`${escapeRx(start)}(?:(?!${escapeRx(start)})[\\s\\S])*?${escapeRx(end)}`, 'g'),
+      () => marked,
     );
     if (updated !== existing) {
       await fs.writeFile(p, updated);
@@ -88,8 +94,11 @@ export async function writeBridgeFile(p, block, { marker = 'opencrew' } = {}) {
     return { written: false, merged: false };
   }
 
-  // User content exists → prepend block, preserve everything
-  await fs.writeFile(p, marked + '\n\n' + existing.trimStart());
+  // User content exists → add the block, preserve everything
+  const merged = position === 'append'
+    ? `${existing.trimEnd()}\n\n${marked}\n`
+    : `${marked}\n\n${existing.trimStart()}`;
+  await fs.writeFile(p, merged);
   return { written: true, merged: true };
 }
 

package/src/lib/ides.js

@@ -41,42 +41,17 @@ Type \`/opencrew\` to open the main menu.
 - All checkpoint questions use \`AskUserQuestion\`.
 - opencrew ships its own Playwright MCP (\`.mcp.json\`); disable the native Playwright plugin.
 - Do not manually edit files under \`_opencrew/core/\` unless you know what you're doing.
+`;
 
-## STATUS.md (gestão de sessão)
-
-This project uses \`STATUS.md\` for session continuity. The file is local (gitignored).
-
-**At the start of every session:**
-- Read \`STATUS.md\`. If it doesn't exist, create it with the template below.
-- Report a 3-line summary: what was in progress, what's next, any blockers.
-
-**During the session:**
-- Move items from ⬜ Pendente to 🔄 Em andamento when you start working on them.
-- Move items to ✅ Concluído when finished.
-- Add new items that emerge during work.
-
-**Before ending the session:**
-- Ensure \`STATUS.md\` reflects the real state.
-- Update \`Última sessão\` timestamp.
-
-**Template:**
-\`\`\`markdown
-# STATUS — OpenCrew
-
-> Última sessão: {today}
-> Skill: /status
-
-## 🔄 Em andamento
-
-## ⬜ Pendente
-
-## ✅ Concluído (esta sessão)
-
-## 📋 Backlog
+// Root AGENTS.md: thin bridge to the full system definition (written by init and update).
+export const AGENTS_BRIDGE = '# opencrew\n\n'
+  + 'The opencrew system definition lives at `_opencrew/core/system.md`.\n'
+  + 'Read that file and adopt the opencrew system role — follow all initialization,\n'
+  + 'command routing, and workflow instructions defined there.\n\n'
+  + 'Type `/opencrew` to open the main menu.\n';
 
-## 💡 Decisões
-\`\`\`
-`;
+// Marker that identifies the maintainer STATUS.md section leaked into CLAUDE.md by 1.4.0/1.4.1.
+export const LEAKED_STATUS_SECTION = '## STATUS.md (gestão de sessão)';
 
 const render = (title, extra = '') =>
   `# ${title}\n\n${BRIDGE}${extra ? `\n\n${extra}` : ''}\n`;

package/templates/AGENTS.md

@@ -1,6 +1,7 @@
 # opencrew Instructions
 
-You are now operating as the opencrew system. Your primary role is to help users create, manage, and run AI agent crews.
+You are operating as the opencrew system. Your primary role is to help users
+create, manage, and run AI agent crews.
 
 ## Initialization
 
@@ -8,55 +9,48 @@ On activation, perform these steps IN ORDER:
 
 1. Read the company context file: `{project-root}/_opencrew/_memory/company.md`
 2. Read the preferences file: `{project-root}/_opencrew/_memory/preferences.md`
-3. Check if company.md is empty or contains only the template — if so, trigger ONBOARDING flow
+3. Check if company.md is empty or contains only the template — if so, trigger ONBOARDING
 4. Otherwise, display the MAIN MENU
 
 ## Onboarding Flow (first time only)
 
 If `company.md` is empty or contains `<!-- NOT CONFIGURED -->`:
 
-1. Welcome the user warmly to opencrew
-2. Ask their name (save to preferences.md)
-3. Ask their preferred language for outputs (save to preferences.md)
-4. Ask for their company name/description and website URL
-5. Use WebFetch on their URL + WebSearch with their company name to research:
-   - Company description and sector
-   - Target audience
-   - Products/services offered
-   - Tone of voice (inferred from website copy)
-   - Social media profiles found
-6. Present the findings in a clean summary and ask the user to confirm or correct
-7. Save the confirmed profile to `_opencrew/_memory/company.md`
-8. Show the main menu
+1. Welcome the user warmly; ask their name and preferred output language (save to
+   preferences.md)
+2. Ask for company name/description and website URL
+3. Use WebFetch on the URL + WebSearch on the company name to research:
+   description/sector, target audience, products/services, tone of voice,
+   social media profiles
+4. Present findings in a clean summary, ask the user to confirm or correct,
+   save the profile to `_opencrew/_memory/company.md`
+5. Show the main menu
 
 ## Main Menu
 
-When the user types `/opencrew` or asks for the menu, present an interactive selector with these options (max 4 per question). Use your IDE's native interactive-choice mechanism if it has one (e.g. Claude Code's `AskUserQuestion`); otherwise present the options as a numbered list and ask the user to reply with a number:
+When the user types `/opencrew` or asks for the menu, present an interactive
+selector with these options (max 4 per question). Use your IDE's native
+interactive-choice mechanism if it has one; otherwise present the options as a
+numbered list and ask the user to reply with a number.
 
-**Primary menu (first question):**
-- **Create a new crew** — Describe what you need and I'll build a crew for you
-- **Run an existing crew** — Execute a crew's pipeline
-- **My crews** — View, edit, repair, or delete your crews
-- **More options** — Skills, company profile, settings, and help
+**Primary menu:** Create a new crew · Run an existing crew · My crews ·
+More options
 
-If the user selects "More options", present a second selector the same way:
-- **Skills** — Browse, install, create, and manage skills for your crews
-- **Company profile** — View or update your company information
-- **Settings & Help** — Language, preferences, configuration, and help
+**More options:** Skills · Company profile · Settings & Help
 
 ## Command Routing
 
-Parse user input and route to the appropriate action:
+Route input to the matching action:
 
 | Input Pattern | Action |
 |---------------|--------|
 | `/opencrew` or `/opencrew menu` | Show main menu |
 | `/opencrew help` | Show help text |
 | `/opencrew create <description>` | Load Architect → Create Crew flow |
-| `/opencrew list` | List all crews in `crews/` directory |
+| `/opencrew list` | List all crews in `crews/` |
 | `/opencrew run <name>` | Load Pipeline Runner → Execute crew |
 | `/opencrew edit <name> <changes>` | Load Architect → Edit Crew flow |
-| `/opencrew repair <name>` | Load `_opencrew/core/prompts/repair.prompt.md` → fix agent names / rebuild crew-party.csv manifest |
+| `/opencrew repair <name>` | Load `_opencrew/core/prompts/repair.prompt.md` → fix agent names / rebuild crew-party.csv |
 | `/opencrew skills` | Load Skills Engine → Show skills menu |
 | `/opencrew install <name>` | Install a skill from the catalog |
 | `/opencrew uninstall <name>` | Remove an installed skill |
@@ -74,7 +68,7 @@ When a specific agent needs to be activated:
 1. Read the agent's `.agent.md` file completely
 2. Adopt the agent's persona (role, identity, communication_style, principles)
 3. Follow the agent's menu/workflow instructions
-4. When the agent's task is complete, return to opencrew main context
+4. When the agent's task is complete, return to the opencrew main context
 
 ## Loading the Pipeline Runner
 
@@ -82,37 +76,26 @@ When running a crew:
 
 1. Read `crews/{name}/crew.yaml` to understand the pipeline
 2. Read `crews/{name}/crew-party.csv` to load all agent personas
-3. For each agent in the party CSV, also read their full `.agent.md` file from agents/ directory
-4. Load company context from `_opencrew/_memory/company.md`
+3. For each agent in the party CSV, also read their full `.agent.md` file
+4. Load company context from `_opencrew/_memory/company.md` and user preferences
+   from `_opencrew/_memory/preferences.md` (used to check the Dashboard toggle)
 5. Load crew memory from `crews/{name}/_memory/memories.md`
-6. Load user preferences from `_opencrew/_memory/preferences.md` (used to check the Dashboard toggle — see below)
-7. Read the pipeline runner instructions from `_opencrew/core/runner.pipeline.md`
-7b. **Pre-Execution Agent Selection** — only when `crew.yaml` declares
-    `agent_dependencies:`. The runner analyzes the user's request against the decision
-    matrix, presents the agents as a numbered multi-select (IDE-neutral), lets the user
-    confirm/adjust, warns about broken dependencies, and builds the filtered step list
-    (see `_opencrew/core/runner.pipeline.md` step 4b). Crews without the field skip this
-    and run all agents.
-8. Execute the pipeline step by step following runner instructions
+6. Read the pipeline runner instructions from `_opencrew/core/runner.pipeline.md`
+7. **Pre-Execution Agent Selection** — only when `crew.yaml` declares
+   `agent_dependencies:`. Analyze the user's request against the decision matrix,
+   present the agents as a numbered multi-select (IDE-neutral), let the user
+   confirm/adjust, warn about broken dependencies, and build the filtered step
+   list. Crews without the field skip this and run all agents.
+8. Execute the pipeline step by step following the runner instructions
 
 ## Dashboard (Optional)
 
-opencrew ships an optional visual dashboard — a self-contained HTML file
-(`dashboard/index.html`) that shows a crew run in progress as an animated
-virtual office. It is **disabled by default** and most installs never use it,
-so the Pipeline Runner does not write `state.json` unless the user has turned
-it on.
-
-- To use: open `dashboard/index.html` in a browser and point it at the
-  `crews/{name}/state.json` written during a run.
-- Toggle: `Dashboard: enabled` (or `disabled`) in `_opencrew/_memory/preferences.md`,
-  editable via `/opencrew settings`.
-- When disabled (default): the runner never creates, writes, or deletes `state.json`.
-- When enabled: the runner writes `crews/{name}/state.json` before each step and at
-  every handoff, exactly as described in `_opencrew/core/runner.pipeline.md`.
-- The dashboard auto-polls `state.json` every 1.5 seconds when in live mode;
-  it also includes a built-in demo mode so you can see what it looks like
-  without running a real crew.
+The dashboard is an optional animated view of a crew run (`dashboard/index.html`).
+It is **disabled by default**; most installs never use it. Toggle it via
+`Dashboard: enabled|disabled` in `_opencrew/_memory/preferences.md` (editable via
+`/opencrew settings`). When disabled, the runner never writes `state.json`; when
+enabled, it writes `crews/{name}/state.json` before each step and at every handoff
+(see `_opencrew/core/runner.pipeline.md`).
 
 ## Language Handling
 
@@ -120,13 +103,9 @@ it on.
 - All user-facing output should be in the user's preferred language
 - Internal file names and code remain in English
 - Agent personas communicate in the user's language
-- **Exception — crew memory scaffolding stays in PT-BR regardless of Output Language.**
-  The section headers in `crews/{name}/_memory/memories.md` (e.g. `## Estilo de Escrita`)
-  and the table columns in `crews/{name}/_memory/runs.md` (e.g. `Data | Run ID | Tema`) are
-  fixed structural labels, not generated prose — see `_opencrew/core/runner.pipeline.md`.
-  opencrew's primary supported audience is PT-BR (see README), so these are intentionally
-  not localized per-user. Only the *content* written into those sections follows the
-  user's Output Language.
+- Exception: crew memory scaffolding (`memories.md` headers, `runs.md` columns)
+  keeps fixed PT-BR structural labels regardless of the user's language —
+  see `_opencrew/core/runner.pipeline.md`
 
 ## Critical Rules
 

package/templates/_opencrew/.opencrew-version

@@ -1 +1 @@
-1.4.1
+1.5.0

package/templates/_opencrew/core/best-practices/copywriting.md

@@ -17,7 +17,10 @@ version: "1.0.0"
 5. Present 3 distinct hook options before drafting the body.
 6. Align completely with brand voice and audience-specific vocabulary.
 7. Write concise, one-idea sentences and short paragraphs.
-8. Use specific numbers and concrete details instead of vague claims.
+8. Use specific numbers and concrete details instead of vague claims — but only REAL ones
+   (briefing, research with source, company profile). Never invent cases, testimonials, clients,
+   numbers or first-person stories: nunca invente; write `[PREENCHER: o que falta]` instead and
+   the user fills it in at final approval.
 9. Select one dominant psychological driver and anchor the piece to it.
 10. Deploy the appropriate framework (AIDA, PAS, BAB) based on the funnel stage.
 11. Inject an objection neutralizer immediately before the CTA.

package/templates/_opencrew/core/best-practices/image-design.md

@@ -88,7 +88,7 @@ Present all rendered images to the user or downstream agent. Include the design
 ## Platform Specifications
 
 ### Instagram Post / Carousel
-- **Viewport**: 1080 x 1440 (3:4 portrait)
+- **Viewport**: 1080 x 1350 (4:5 portrait)
 - **Min font sizes**: Hero 58px, Heading 43px, Body 34px, Caption 24px
 - **Optimal slide count**: 5-10 slides. Under 5 feels incomplete, over 10 causes drop-off.
 - **Structure**: Hook on slide 1, CTA on last slide, value in between.
@@ -135,7 +135,7 @@ Present all rendered images to the user or downstream agent. Include the design
 DESIGN SYSTEM
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Platform: Instagram Carousel
-Viewport: 1080 x 1440
+Viewport: 1080 x 1350
 Slides: 7 (hook + 5 content + CTA)
 
 Colors:
@@ -181,7 +181,7 @@ File: slide-01.html
     @import url('https://fonts.googleapis.com/css2?family=Inter:wght@500;700&display=swap');
     * { margin: 0; padding: 0; box-sizing: border-box; }
     body {
-      width: 1080px; height: 1440px; overflow: hidden;
+      width: 1080px; height: 1350px; overflow: hidden;
       background: #1A1A2E;
       font-family: 'Inter', sans-serif;
       display: flex; flex-direction: column;
@@ -342,7 +342,7 @@ Design rationale: Clean white background matches LinkedIn's professional aesthet
 
 3. **Document design rationale.** After each completed design, briefly explain why you made the key visual choices: color rationale, font selection, layout strategy. This helps the user understand the design thinking and makes iteration faster.
 
-4. **Match viewport exactly.** Body width and height in CSS must match the browser viewport resize dimensions exactly. A 1080x1440 carousel slide means body { width: 1080px; height: 1440px; }.
+4. **Match viewport exactly.** Body width and height in CSS must match the browser viewport resize dimensions exactly. A 1080x1350 carousel slide means body { width: 1080px; height: 1350px; }.
 
 ## Vocabulary Guidance
 
@@ -350,7 +350,7 @@ Design rationale: Clean white background matches LinkedIn's professional aesthet
 
 - **"Design system"**: The foundational term for consistent visual identity across pieces. Always define it before creating individual assets.
 - **"Visual hierarchy"**: How the eye moves through the design. Use this when explaining font size, weight, and positioning choices.
-- **"Viewport: WxH"**: Always state the target dimensions explicitly. "Instagram carousel at 1080x1440" not "standard Instagram size."
+- **"Viewport: WxH"**: Always state the target dimensions explicitly. "Instagram carousel at 1080x1350" not "standard Instagram size."
 - **"Contrast ratio"**: Reference WCAG contrast standards when justifying color combinations. "4.5:1 minimum for body text."
 - **"Self-contained HTML"**: The non-negotiable constraint. Reinforce that every file must render independently without external dependencies.
 - **"Rendering verification"**: The step where you visually confirm the screenshot matches the intended design before proceeding.