mixdog 0.9.138 → 0.9.139

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mixdog",
-  "version": "0.9.138",
+  "version": "0.9.139",
   "private": false,
   "type": "module",
   "description": "Standalone mixdog coding-agent CLI/TUI workspace.",
@@ -52,6 +52,7 @@
     "smoke:boot": "node scripts/boot-smoke.mjs",
     "smoke:compact": "node scripts/compact-smoke.mjs",
     "test:compact": "node --test scripts/suite-compact-test.mjs",
+    "test:markdown": "node --test scripts/markdown-surface-test.mjs",
     "smoke:loop": "node scripts/smoke-loop.mjs",
     "smoke:loop:final": "node scripts/smoke-loop-report.mjs --require-complete --min-elapsed 5h --min-iterations 400 --max-gap 60s --max-smoke-ms 10000 --max-avg-smoke-ms 8500 --max-step-ms smoke.mjs=4000 --max-step-ms boot-smoke.mjs=8000 --max-rss-mb 140 --max-rss-growth-mb 50",
     "smoke:loop:report": "node scripts/smoke-loop-report.mjs",
@@ -63,11 +64,10 @@
     "test:embedding-runtime:warmup": "node scripts/verify-embedding-runtime.mjs --warmup",
     "test:release-assets": "node --check scripts/verify-release-assets.mjs && node --check scripts/release-gate-test.mjs && node --check scripts/prepare-native-assets.mjs && node --test scripts/release-gate-test.mjs scripts/prepare-native-assets-test.mjs",
     "test:native-edit-wire": "node scripts/native-edit-wire-test.mjs",
-    "test:release-focused": "npm run test:release-critical && npm run test:compact && npm run test:shellhardening && npm run test:tool-contracts && npm run test:session && npm run test:session-transport",
     "test:release-critical": "npm run test:release-assets && npm run smoke:patch && npm run test:providers",
     "test:spec-advisory": "node scripts/advisory-spec-test.mjs && npm run test:spec-advisory --prefix apps/desktop",
     "test:session-transport": "node --test scripts/session-transport-test.mjs scripts/daemon-bootstrap-test.mjs",
-    "test:session": "node --test scripts/runtime-turn-contract-test.mjs scripts/session-save-fault-store-test.mjs src/runtime/shared/tool-surface.test.mjs",
+    "test:session": "node --test scripts/runtime-turn-contract-test.mjs scripts/session-save-fault-store-test.mjs scripts/turn-review-revert-test.mjs src/runtime/shared/tool-surface.test.mjs",
     "test:media": "node --test src/runtime/media/store.test.mjs src/runtime/media/renditions.test.mjs src/runtime/media/adapters/codex-image.test.mjs",
     "failures": "node scripts/tool-failures.mjs",
     "trace:llm": "node scripts/llm-trace-summary.mjs",

package/scripts/model-catalog-audit.mjs

@@ -5,7 +5,7 @@ import {
   loadModelsDevCatalog,
   warmModelMetadataCatalogs,
 } from '../src/runtime/agent/orchestrator/providers/model-catalog.mjs';
-import { QUICK_SEARCH_MODELS } from '../src/session-runtime/quick-search-models.mjs';
+import { QUICK_WEB_SEARCH_MODELS } from '../src/session-runtime/quick-web-search-models.mjs';
 
 const args = new Set(process.argv.slice(2));
 const json = args.has('--json');
@@ -155,7 +155,7 @@ for (const [name, provider] of getAllProviders()) {
 }
 
 const quickRows = [];
-for (const [provider, models] of Object.entries(QUICK_SEARCH_MODELS)) {
+for (const [provider, models] of Object.entries(QUICK_WEB_SEARCH_MODELS)) {
   for (const model of models) {
     if (model?.contextWindow == null) continue;
     const external = externalMeta(modelsDev, litellm, provider, model.id);

package/scripts/tool-stress.mjs

@@ -87,11 +87,11 @@ try {
         timed(metric('find'), /tool-defs|no fuzzy match/, () => executeBuiltinTool('find', {
           query: 'tool-defs', limit: 8,
         }, root, opts)),
-        timed(metric('list'), /01-tool\.md|file/, () => executeBuiltinTool('list', {
+        timed(metric('list'), /10-tool-workflow\.md|file/, () => executeBuiltinTool('list', {
           path: 'src/rules/shared',
         }, root, opts)),
-        timed(metric('read'), /Tool Use|read/, () => executeBuiltinTool('read', {
-          path: [['src/rules/shared/01-tool.md', 0, 10], ['package.json', 0, 5]],
+        timed(metric('read'), /Tool Workflow|read/, () => executeBuiltinTool('read', {
+          path: [['src/rules/shared/10-tool-workflow.md', 0, 10], ['package.json', 0, 5]],
         }, root, opts)),
         timed(metric('code_graph'), /symbol|binding|files|edges/i, () => executeCodeGraphTool('code_graph', {
           mode: 'symbols', files: 'scripts/smoke.mjs',

package/src/defaults/mixdog-config.template.json

@@ -1,8 +1,8 @@
 {
-  "outputStyle": "default",
+  "outputStyle": "simple",
   "agent": {
     "mcpServers": {},
-    "profile": { "title": "", "language": "system" },
+    "profile": { "title": "", "language": "system", "experienceLevel": "" },
     "recap": { "enabled": true }
   },
   "channels": {},

package/src/defaults/skills/setup/SKILL.md

@@ -31,9 +31,9 @@ description: Use this skill only to inspect or modify a Mixdog user's persisted
 |---|---|
 | Lead 모델 | `agent.presets[id=workflow-lead]` + `agent.default` |
 | 에이전트 라우트 | `agent.agents.<id>` |
-| Search 모델 | `agent.searchRoute` |
+| Web Search 모델 | `agent.webSearchRoute` |
 | Provider·MCP·프로필·스킬·업데이트·셸·autoClear·compaction | `agent.*` |
-| Web search 도구 | `agent.modules.search.enabled` |
+| Web search 도구 | `agent.modules.webSearch.enabled` |
 | Recap(배경 사이클) | `agent.recap.enabled` |
 | 출력 스타일 | 루트 `outputStyle` |
 | Webhook server | `channels.webhook.*` |
@@ -98,11 +98,11 @@ API 키·토큰·OAuth 자격은 config에 쓰지 않는다.
 
 ### 웹 검색 모델
 
-1. **확인**: Desktop **Workflows → Default agents → Web Search**, TUI `/search`, `getSearchRoute()`, 디스크 `agent.searchRoute`.
-2. **변경**: Desktop **Web Search → Edit** 또는 TUI `/search` → `setSearchRoute()`.
-3. **검증**: 저장 route가 native-search 가능 provider/model인지 확인하고 다음 `search` 도구 호출에서 사용되는지 확인한다.
+1. **확인**: Desktop **Workflows → Default agents → Web Search**, TUI `/websearch`, `getWebSearchRoute()`, 디스크 `agent.webSearchRoute`.
+2. **변경**: Desktop **Web Search → Edit** 또는 TUI `/websearch` → `setWebSearchRoute()`.
+3. **검증**: 저장 route가 native web-search 가능 provider/model인지 확인하고 다음 `web_search` 도구 호출에서 사용되는지 확인한다.
 
-`/search` 인자는 route를 직접 지정하지 않으며 피커를 연다.
+`/websearch` 인자는 route를 직접 지정하지 않으며 피커를 연다.
 
 ### Web search 도구 토글
 
@@ -110,7 +110,7 @@ API 키·토큰·OAuth 자격은 config에 쓰지 않는다.
 
 1. **확인**: Desktop **Settings → General → Web search**, TUI `/setting → Web search`.
 2. **변경**: toggle → `setWebSearchEnabled()`.
-3. **저장**: `agent.modules.search.enabled`.
+3. **저장**: `agent.modules.webSearch.enabled`.
 4. **검증**: 다음 세션의 tool surface.
 
 ### reasoning effort / Fast
@@ -119,7 +119,7 @@ API 키·토큰·OAuth 자격은 config에 쓰지 않는다.
 - Fast: `/fast [on|off]` 또는 model picker의 Tab → 현재 Main route에 저장
 - Desktop 세션 헤더에서도 같은 Main route를 바꾼다.
 - 진행 중 turn은 시작 값을 유지하고 새 값은 다음 turn부터 적용된다.
-- agent/search route의 effort/Fast는 각 route에 격리되며 Main의 `modelSettings`를 덮어쓰지 않는다.
+- agent/web-search route의 effort/Fast는 각 route에 격리되며 Main의 `modelSettings`를 덮어쓰지 않는다.
 
 ### 워크플로 팩
 
@@ -188,7 +188,9 @@ API 키·토큰·OAuth 자격은 config에 쓰지 않는다.
 3. **사용자 정의**: `<mixdogData>/output-styles/<id>.md`.
 4. **검증**: 대화 이력이 있으면 현재 chat에는 적용되지 않으므로 `/clear` 후 확인한다.
 
-`agent.outputStyle`은 읽기 호환용 레거시 경로다. 변경 시 루트 `outputStyle`에 저장하고 `agent.outputStyle`은 제거한다.
+루트 `outputStyle`만 읽고 쓴다. `agent.outputStyle`은 더 이상 읽지 않으므로 발견하면 제거한다.
+
+사용자 정의 스타일은 기본적으로 빌트인 공통 포맷(`output-styles/common.md`)을 상속한다. 전면 교체는 frontmatter에 `keep-shared-format: false`를 넣고, 공통 포맷 자체를 바꾸려면 `<mixdogData>/output-styles/common.md`를 둔다.
 
 ### 테마
 

package/src/help.mjs

@@ -33,7 +33,7 @@ export const HELP_LINES = [
   '  /context                      show current context surface',
   '  /usage [refresh]              show total provider quota / balance',
   '  /model [name|refresh]         switch model for subsequent turns',
-  '  /search                       set the web search provider/model',
+  '  /websearch                    set the web search provider/model',
   '  /workflow [name]              switch the active workflow',
   '  /OutputStyle [name]           switch Lead output style (alias: /style)',
   '  /theme [id]                   change the TUI color theme',

package/src/lib/rules-builder.cjs

@@ -18,11 +18,13 @@
  *   BP4 = live user/task messages and compacted tail
  *
  * Source files (rules/):
- *   - shared/01-tool.md              — universal tool policy (Lead + agent BP1, identical full set)
+ *   - shared/*.md                    — ordered universal policies (Lead + agent BP1, identical full set)
  *   - lead/lead-tool.md             — Lead-specific control-tower / delegation / ToolSearch guidance
  *   - lead/lead-brief.md            — Lead brief contract (delegating workflows only)
  *   - lead/01-general.md             — Lead general
- *   - output-styles/<name>.md        — Lead output style, selected by config outputStyle
+ *   - lead/02-persona.md             — Lead communication personality
+ *   - output-styles/common.md        — shared built-in output composition policy
+ *   - output-styles/<name>.md        — selected built-in depth variant or standalone user style
  *   - agent/00-core.md               — universal agent constraints (BP3, all profiles)
  *   - agent/00-common.md             — public-agent-only extras (BP3 full profile)
  *   - agent/10..50-*.md              — per-hidden-agent bodies (consumed by loadScopedRoleInstructions)
@@ -53,6 +55,19 @@ function readOptional(filePath) {
   try { return fs.readFileSync(filePath, 'utf8').trim(); } catch { return ''; }
 }
 
+function readMarkdownDirectory(dirPath) {
+  try {
+    return fs.readdirSync(dirPath)
+      .filter((name) => name.endsWith('.md'))
+      .sort()
+      .map((name) => readOptional(path.join(dirPath, name)))
+      .filter(Boolean)
+      .join('\n');
+  } catch {
+    return '';
+  }
+}
+
 function readUnifiedConfig(dataDir) {
   try {
     const unified = JSON.parse(fs.readFileSync(path.join(dataDir, 'mixdog-config.json'), 'utf8'));
@@ -90,13 +105,36 @@ const PROFILE_LANGUAGE_PROMPTS = Object.freeze({
 });
 
 const PROFILE_TITLE_MAX = 64;
+const PROFILE_EXPERIENCE_LEVELS = Object.freeze({
+  beginner: {
+    label: 'Beginner',
+    prompt: 'Assume no development background; briefly explain only the terms and prerequisites needed to understand the answer.',
+  },
+  'vibe-coder': {
+    label: 'Vibe coder',
+    prompt: 'Lead with what the result does and how to use it; briefly unpack implementation jargon when it is needed for understanding.',
+  },
+  junior: {
+    label: 'Junior',
+    prompt: 'Assume basic development knowledge; make otherwise implicit connections clear when they are needed for easy understanding.',
+  },
+  expert: {
+    label: 'Expert',
+    prompt: 'Do not unnecessarily unpack familiar basics, but preserve the explanations needed for accurate understanding and judgment. Use familiar technical terminology naturally.',
+  },
+});
 
 function normalizeProfileConfig(value = {}) {
   const raw = value && typeof value === 'object' ? value : {};
   const title = String(raw.title ?? raw.name ?? '').trim().slice(0, PROFILE_TITLE_MAX);
   const requested = String(raw.language ?? raw.lang ?? 'system').trim();
   const language = requested === 'system' || PROFILE_LANGUAGE_PROMPTS[requested] ? requested : 'system';
-  return { title, language };
+  const requestedExperienceLevel = String(raw.experienceLevel ?? '')
+    .trim().toLowerCase().replace(/[\s_]+/g, '-');
+  const experienceLevel = Object.prototype.hasOwnProperty.call(PROFILE_EXPERIENCE_LEVELS, requestedExperienceLevel)
+    ? requestedExperienceLevel
+    : '';
+  return { title, language, experienceLevel };
 }
 
 function systemLocaleId(locale) {
@@ -131,6 +169,11 @@ function buildProfilePreferencesContent(dataDir) {
     lines.push(`- User title: ${profile.title}.`);
     lines.push(`- Use "${profile.title}" when directly addressing the user; do not repeat it in routine progress updates or pre-tool preambles.`);
   }
+  const experience = PROFILE_EXPERIENCE_LEVELS[profile.experienceLevel];
+  if (experience) {
+    lines.push(`- Development experience: ${experience.label}. ${experience.prompt}`);
+    lines.push('- Adapt vocabulary and assumed background to this level without adding lessons, examples, or tips unless the task needs them; output style still controls information depth.');
+  }
   return `# Profile Preferences${lines.length ? `\n\n${lines.join('\n')}` : ''}`;
 }
 
@@ -152,9 +195,12 @@ function stripFrontmatter(markdown) {
   return String(markdown || '').replace(/^---[ \t]*\r?\n[\s\S]*?\r?\n---[ \t]*(?:\r?\n|$)/, '').trim();
 }
 
-const SEARCH_ROUTE_RE = /web\/current→`search`;\s*returned URL body→`web_fetch`;\s*/g;
-const RECALL_ROUTE_RE = /prior work→`recall`\s*\(history only, never current local state\);\s*/g;
-const MEMORY_ROUTE_RE = /durable compact English memory→`memory`;\s*/g;
+const WEB_SEARCH_ROUTE_RE = /^[ \t]*current or external information discovery→`web_search`;[ \t]*\r?\n?/gm;
+const WEB_FETCH_ROUTE_RE = /^[ \t]*page or documentation body retrieval from a known URL→`web_fetch`\.[ \t]*\r?\n?/gm;
+const RECALL_ROUTE_RE = /^-[ \t]*past facts recorded in prior work or sessions→`recall`[ \t]*\r?\n[ \t]*\(stored history only, never current local state\)\.[ \t]*\r?\n?/gm;
+const MEMORY_ROUTE_RE = /^-[ \t]*Durable memory creation or update→`memory`; store a compact English[ \t]*\r?\n[ \t]*statement\.[\s\S]*$/m;
+const EMPTY_RESEARCH_RE = /^# Research[ \t]*\r?\n(?:[ \t]*\r?\n)*-[ \t]*Research routes:[ \t]*\r?\n?/gm;
+const EMPTY_MEMORY_RE = /^# Memory[ \t]*\r?\n(?:[ \t]*\r?\n)*/gm;
 
 function omitKeySet(omitTools) {
   return new Set((Array.isArray(omitTools) ? omitTools : []).map((name) => String(name || '').toLowerCase()).filter(Boolean));
@@ -164,51 +210,159 @@ function omitKeySet(omitTools) {
 function omitToolRoutes(text, omitTools = []) {
   const deny = omitKeySet(omitTools);
   let out = String(text || '');
-  if (deny.has('search') || deny.has('web_fetch')) out = out.replace(SEARCH_ROUTE_RE, '');
+  if (deny.has('web_search')) out = out.replace(WEB_SEARCH_ROUTE_RE, '');
+  if (deny.has('web_fetch')) out = out.replace(WEB_FETCH_ROUTE_RE, '');
   if (deny.has('recall')) out = out.replace(RECALL_ROUTE_RE, '');
   if (deny.has('memory')) out = out.replace(MEMORY_ROUTE_RE, '');
+  if (deny.has('web_search') && deny.has('web_fetch')) {
+    out = out.replace(EMPTY_RESEARCH_RE, '');
+  }
+  if (deny.has('recall') && deny.has('memory')) out = out.replace(EMPTY_MEMORY_RE, '');
   return out.replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n');
 }
 
-function normalizeOutputStyleName(value) {
-  const name = String(value || 'simple').trim();
-  return /^[A-Za-z0-9_.-]+$/.test(name) ? name : 'simple';
+const DEFAULT_OUTPUT_STYLE_ID = 'simple';
+const OUTPUT_STYLE_ORDER = ['detailed', 'simple', 'minimal', 'extreme-minimal'];
+const OUTPUT_STYLE_ALIASES = new Map([
+  ['extreme', 'extreme-minimal'],
+  ['extremesimple', 'extreme-minimal'],
+  ['extreme-simple', 'extreme-minimal'],
+  ['extreme_simple', 'extreme-minimal'],
+  ['extrememinimal', 'extreme-minimal'],
+  ['extreme_minimal', 'extreme-minimal'],
+  ['mono', 'extreme-minimal'],
+  ['oneline', 'extreme-minimal'],
+  ['one-line', 'extreme-minimal'],
+  ['one_line', 'extreme-minimal'],
+]);
+
+function normalizeOutputStyleId(value) {
+  const raw = String(value || '').trim().toLowerCase();
+  if (!raw) return '';
+  const slug = raw.replace(/[_\s]+/g, '-').replace(/^-+|-+$/g, '');
+  const compact = slug.replace(/[_.-]+/g, '');
+  if (OUTPUT_STYLE_ALIASES.has(slug)) return OUTPUT_STYLE_ALIASES.get(slug);
+  if (OUTPUT_STYLE_ALIASES.has(compact)) return OUTPUT_STYLE_ALIASES.get(compact);
+  return /^[a-z0-9.-]+$/.test(slug) ? slug : '';
 }
 
-function loadOutputStyle({ PLUGIN_ROOT, DATA_DIR }) {
-  const config = readUnifiedConfig(DATA_DIR);
-  const configured = config.outputStyle || (config.agent && config.agent.outputStyle);
-  const styleName = normalizeOutputStyleName(configured);
-  const candidates = [
-    path.join(DATA_DIR, 'output-styles', `${styleName}.md`),
-    path.join(PLUGIN_ROOT, 'output-styles', `${styleName}.md`),
-  ];
-  for (const candidate of candidates) {
-    const body = stripFrontmatter(readOptional(candidate));
-    if (body) return body;
+function outputStyleCompactKey(value) {
+  return normalizeOutputStyleId(value).replace(/[_.-]+/g, '');
+}
+
+function titleCaseOutputStyle(id) {
+  return String(id || '')
+    .split(/[_.-]+/)
+    .filter(Boolean)
+    .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+    .join(' ') || 'Default';
+}
+
+function parseOutputStyleFrontmatter(markdown) {
+  const match = String(markdown || '').match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  const meta = {};
+  if (!match) return meta;
+  for (const line of match[1].split(/\r?\n/)) {
+    const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.*?)\s*$/);
+    if (!kv) continue;
+    meta[kv[1]] = kv[2].replace(/^['"]|['"]$/g, '').trim();
   }
-  if (styleName !== 'simple') {
-    const fallback = [
-      path.join(DATA_DIR, 'output-styles', 'simple.md'),
-      path.join(PLUGIN_ROOT, 'output-styles', 'simple.md'),
-    ];
-    for (const candidate of fallback) {
-      const body = stripFrontmatter(readOptional(candidate));
-      if (body) return body;
+  return meta;
+}
+
+function outputStyleFlag(value, fallback) {
+  const raw = String(value ?? '').trim().toLowerCase();
+  if (!raw) return fallback;
+  if (/^(?:true|1|yes|on)$/.test(raw)) return true;
+  if (/^(?:false|0|no|off)$/.test(raw)) return false;
+  return fallback;
+}
+
+function readOutputStyleEntry(filePath, source) {
+  const raw = readOptional(filePath);
+  if (!raw) return null;
+  const meta = parseOutputStyleFrontmatter(raw);
+  if (/^(?:true|1|yes)$/i.test(String(meta.partial || '').trim())) return null;
+  const fileId = normalizeOutputStyleId(path.basename(filePath).replace(/\.md$/i, ''));
+  const id = normalizeOutputStyleId(meta.name) || fileId;
+  if (!id) return null;
+  return {
+    id,
+    label: String(meta.title || meta.label || '').trim() || titleCaseOutputStyle(id),
+    aliases: String(meta.aliases || '').split(',')
+      .map((alias) => normalizeOutputStyleId(alias))
+      .filter(Boolean),
+    // Built-in and custom styles both inherit the shared format partial; a
+    // style opts out only by declaring `keep-shared-format: false`.
+    keepSharedFormat: outputStyleFlag(meta['keep-shared-format'], true),
+    source,
+    raw,
+  };
+}
+
+function listOutputStyleEntries({ PLUGIN_ROOT, DATA_DIR }) {
+  const byId = new Map();
+  for (const { dir, source } of [
+    { dir: path.join(PLUGIN_ROOT, 'output-styles'), source: 'builtin' },
+    { dir: path.join(DATA_DIR, 'output-styles'), source: 'user' },
+  ]) {
+    let files = [];
+    try { files = fs.readdirSync(dir).filter((name) => name.toLowerCase().endsWith('.md')).sort(); } catch {}
+    for (const name of files) {
+      const style = readOutputStyleEntry(path.join(dir, name), source);
+      if (style) byId.set(style.id, style);
     }
   }
-  return '';
+  return [...byId.values()].sort((a, b) => {
+    const ai = OUTPUT_STYLE_ORDER.indexOf(a.id);
+    const bi = OUTPUT_STYLE_ORDER.indexOf(b.id);
+    if (ai !== bi) return (ai < 0 ? 999 : ai) - (bi < 0 ? 999 : bi);
+    return a.label.localeCompare(b.label, 'en', { sensitivity: 'base' });
+  });
+}
+
+function findOutputStyleEntry(value, styles) {
+  const id = normalizeOutputStyleId(value);
+  const compact = outputStyleCompactKey(value);
+  if (!id && !compact) return null;
+  return styles.find((style) => {
+    if (style.id === id || outputStyleCompactKey(style.id) === compact) return true;
+    if (outputStyleCompactKey(style.label) === compact) return true;
+    return style.aliases.some((alias) => alias === id || outputStyleCompactKey(alias) === compact);
+  }) || null;
+}
+
+/** Shared format partial: a user copy in DATA_DIR overrides the built-in one. */
+function readSharedFormatPartial({ PLUGIN_ROOT, DATA_DIR }) {
+  return stripFrontmatter(readOptional(path.join(DATA_DIR, 'output-styles', 'common.md')))
+    || stripFrontmatter(readOptional(path.join(PLUGIN_ROOT, 'output-styles', 'common.md')));
+}
+
+function loadOutputStyle({ PLUGIN_ROOT, DATA_DIR }) {
+  // Root `outputStyle` is the only configured location; the retired
+  // `agent.outputStyle` key is dropped by config canonicalization.
+  const configured = String(readUnifiedConfig(DATA_DIR).outputStyle || '').trim() || DEFAULT_OUTPUT_STYLE_ID;
+  const styles = listOutputStyleEntries({ PLUGIN_ROOT, DATA_DIR });
+  const style = findOutputStyleEntry(configured, styles)
+    || findOutputStyleEntry(DEFAULT_OUTPUT_STYLE_ID, styles)
+    || styles[0];
+  if (!style) return '';
+  const selected = stripFrontmatter(style.raw);
+  if (!selected) return '';
+  const common = style.keepSharedFormat ? readSharedFormatPartial({ PLUGIN_ROOT, DATA_DIR }) : '';
+  return [`# Output Style: ${style.label}`, common, selected].filter(Boolean).join('\n\n');
 }
 
 function buildSharedToolContent({ PLUGIN_ROOT, omitTools = [] } = {}) {
   const SHARED_DIR = path.join(PLUGIN_ROOT, 'rules', 'shared');
-  return omitToolRoutes(readOptional(path.join(SHARED_DIR, '01-tool.md')), omitTools);
+  return omitToolRoutes(readMarkdownDirectory(SHARED_DIR), omitTools);
 }
 
 function buildLeadRoleContent({ PLUGIN_ROOT, DATA_DIR, includeLeadBrief = true }) {
   const RULES_DIR = path.join(PLUGIN_ROOT, 'rules');
   const LEAD_DIR = path.join(RULES_DIR, 'lead');
   const general = readOptional(path.join(LEAD_DIR, '01-general.md'));
+  const persona = readOptional(path.join(LEAD_DIR, '02-persona.md'));
   const parts = [];
 
   if (includeLeadBrief) {
@@ -217,6 +371,7 @@ function buildLeadRoleContent({ PLUGIN_ROOT, DATA_DIR, includeLeadBrief = true }
   }
 
   if (general) parts.push(general);
+  if (persona) parts.push(persona);
 
   return parts.join('\n\n');
 }
@@ -305,7 +460,7 @@ function buildAgentRoleContent({ PLUGIN_ROOT, profile = 'full' }) {
 function buildAgentRetrievalInjectionContent({ PLUGIN_ROOT }) {
   const AGENT_DIR = path.join(PLUGIN_ROOT, 'rules', 'agent');
   const core = readOptional(path.join(AGENT_DIR, '00-core.md'));
-  // Full shared tool policy (01-tool.md) now ships via BP1 for retrieval
+  // Full ordered shared policy now ships via BP1 for retrieval
   // roles too; no compact duplicate here.
   const parts = [];
   if (core) parts.push(core.trim());

package/src/output-styles/common.md

@@ -0,0 +1,54 @@
+---
+name: common
+title: Shared Output Format
+description: Shared structure, formatting, and readability policy
+partial: true
+---
+
+## Shared Output Format
+
+- Lead with the answer or action. Write for a person, not as a console log. Match
+  the request's language, tone, and apparent expertise; use complete grammatical
+  sentences and explain unfamiliar terms without talking down to the reader.
+- Select content according to the active depth variation before formatting it.
+  Formatting must never restore information that variation discarded.
+- Choose the presentation from the content, the reader, and the task. Markdown is
+  available, not mandatory. Use paragraphs, line breaks, bullets, numbered steps,
+  headings, tables, or code in any combination that makes the particular answer
+  easier to understand; no response shape is the default or a required mapping
+  from question type to format.
+- Output renders as GitHub-flavored Markdown — tables, task lists, footnotes,
+  fenced code with a language tag, and `$$…$$` math — in a proportional-width
+  surface. Space-aligned columns and ASCII art do not line up there; use a real
+  table or a fenced block instead.
+- Keep simple answers visually simple. For longer answers, add only the structure
+  that creates useful grouping, order, contrast, or emphasis. Do not rotate
+  formats for variety, force a recurring template, label the opening answer or
+  closing paragraph, create headings for tiny blocks, or nest lists without need.
+- Never produce an essay-shaped wall of text. When a block contains several
+  separable ideas or becomes hard to scan, split it or choose a clearer structure.
+  Do not overcorrect into fragments or excessive sections when a compact answer
+  already reads cleanly.
+- Use tables only for short enumerable or quantitative facts when they genuinely
+  improve comparison. Keep explanatory reasoning outside table cells.
+- Keep the flow linear so each sentence builds on what came before without
+  semantic backtracking. Keep related ideas together and give each paragraph or
+  list item one main idea. Split or list a block as soon as it serves multiple
+  roles. Avoid essay-shaped walls of text, fragments, excessive dashes,
+  symbol-heavy shorthand, dense paragraphs, and decorative emphasis.
+- Use an inverted pyramid when useful: answer first, then the context needed to
+  understand it, then lower-priority detail. State each material point once; do
+  not repeat the opening conclusion in a `Summary`, `Conclusion`, or `In short`
+  ending, and never force a recurring response template.
+- Keep established facts separate from plausible inference. Do not invent a
+  mechanism, value, consequence, or certainty to make an explanation feel
+  complete.
+- Use user-facing terms without unexplained internal shorthand, routine process
+  narration, raw output dumps, or emojis unless requested. Show code and file
+  references only when their exact form helps the reader.
+- Reader understanding outranks terseness, but every retained sentence must earn
+  its place. Do not restate the request or announce compliance with constraints
+  such as language or tool use. Remove preamble, filler, obvious statements, and
+  repetition. Once every requested point is covered, stop; do not append a recap,
+  solution, recommendation, next step, or offer of more help unless requested or
+  necessary to prevent a misleading answer. Preserve exact technical literals.

package/src/output-styles/detailed.md

@@ -1,25 +1,16 @@
 ---
 name: detailed
 title: Detailed
-description: Claude Code default-depth responses
+description: Concrete explanation with full requested depth
 aliases: verbose, full
-keep-coding-instructions: true
 ---
 
-# Output Style
+## Depth Variation
 
-Detailed — a teammate's update; clarity outranks terseness.
+Detailed — concrete explanation.
 
-- Outcome first, then what a cold reader needs: complete user-language
-  sentences readable in one pass, expanded jargon, rationale only where it
-  adds value; no filler or process narration.
-- Structure matches complexity: casual answers stay plain prose; reports
-  order outcome → changes → verification → next steps.
-- 3+ parallel facts become a flat `- ` list: one fact per bullet, one line
-  when possible, ordered by importance, parallel phrasing, related points
-  merged, never nested; tables only for short enumerable facts.
-- No hard cap, but brevity first: the shortest report understood without
-  rereads (~10 lines is plenty); trivial results stay 1–2 sentences.
-- Cite `file:line`; snippets only when load-bearing; never dump raw tool
-  output; blockers and failures in one clause each; never name this style
-  unless asked.
+- Information depth: retain the answer plus every established explanatory layer
+  that materially improves understanding—mechanism, evidence, trade-offs,
+  implications, and useful examples. Deepen the requested subject without
+  filling evidentiary gaps or broadening into fixes, recommendations, or adjacent
+  lessons unless asked.

package/src/output-styles/extreme-minimal.md

@@ -1,14 +1,17 @@
 ---
 name: extreme-minimal
 title: Extreme Minimal
-description: Single sentence under 100 characters
+description: Final decision or direct answer in one or two sentences
 aliases: extreme, oneline, one-line, one line, mono
-keep-coding-instructions: true
 ---
 
-# Output Style
+## Depth Variation
 
-Extreme minimal — exactly one sentence under 100 characters.
+Extreme minimal — final decision or answer.
 
-- Net result only; no second sentence, list, heading, label, or follow-up.
-- At most one decisive path, command, symbol, or error verbatim if it fits.
+- Information depth: the entire response is one or two short sentences containing
+  only the final decision, result, or direct answer. Include no heading, label,
+  list, explanation, supporting fact, scope, caveat, recap, or follow-up, even
+  when asked to explain or report. For a cause question, the direct answer is the
+  highest-level cause, not its concrete causal chain. Never pack discarded detail
+  into a longer sentence.

package/src/output-styles/minimal.md

@@ -1,15 +1,16 @@
 ---
 name: minimal
 title: Minimal
-description: Net result within 400 characters
-keep-coding-instructions: true
+description: Conclusion, core cause, and one decisive fact
 ---
 
-# Output Style
+## Depth Variation
 
-Minimal — net result in plain sentences; hard cap 400 characters.
+Minimal — conclusion and core cause.
 
-- Outcome sentence first, then only decisive follow-ups; concept level only:
-  no headings, bullets, labels, or per-file detail, even for reports.
-- Only decisive paths, commands, symbols, or errors verbatim; user-language
-  sentences; never name this style unless asked.
+- Information depth: retain the conclusion, the single core cause that determines
+  it, and one or two decisive concrete facts that make the cause clear. Include
+  the immediate consequence when it completes the answer, then stop before a
+  full explanation. Do not add secondary evidence, deployment state, unaffected
+  scope, broader impact, exceptions, remediation, or process unless that category
+  is the requested answer.

package/src/output-styles/simple.md

@@ -1,21 +1,17 @@
 ---
 name: simple
 title: Simple
-description: Lightly trimmed default-style updates within 800 characters
-aliases: concise, handoff
-keep-coding-instructions: true
+description: Concise summary with the essential explanation
+aliases: default, concise, handoff
 ---
 
-# Output Style
+## Depth Variation
 
-Simple — a teammate's update, tightened; hard cap 800 characters.
+Simple — concise summary.
 
-- Outcome first in complete user-language sentences; no filler or process
-  narration; reports order outcome → changes → verification.
-- Short answers stay plain prose; 3+ parallel facts become a flat `- `
-  list — one fact per bullet, one line, ordered by importance, never nested.
-- Each material fact once, secondary detail and non-load-bearing rationale
-  dropped; `file:line` anchors, technical literals verbatim; the cap is a
-  ceiling, not a target.
-- Never dump raw tool output; blockers and failures in one clause each.
-  Never name this style unless asked.
+- Information depth: preserve enough context for the answer to stand on its own.
+  Retain the main answer, the essential causal sequence, strongest supporting
+  evidence, direct consequences, and material scope or caveat. Prefer a complete
+  explanation over compression that makes the reader infer a missing step. Omit
+  only secondary evidence, exhaustive implementation detail, examples, edge
+  cases, adjacent implications, alternatives, and unrequested remediation.

package/src/rules/lead/01-general.md

@@ -2,8 +2,10 @@
 
 - You are Mixdog, the coding-agent CLI/TUI assistant for multi-provider
   workflows; never generic OpenAI/ChatGPT.
-- Preamble: one useful sentence maximum; no direct names, honorifics, headings,
-  labels, or routine lookup narration.
+- Before the first tool call, state in one short sentence what you are about
+  to do; add a short update when you find something load-bearing, change
+  direction, or work a stretch without one. No direct names, honorifics,
+  headings, labels, or a colon before a tool call.
 - Confirm destructive/hard-to-reverse actions against explicit validated paths;
   never `~`, a root, or unresolved variables/globs; report material deletion
   recoverability.