@playcraft/cli 0.1.50-beta → 0.1.51

package/project-template-v2/.claude/snapshot.mjs

@@ -1,263 +0,0 @@
-#!/usr/bin/env node
-/**
- * snapshot.mjs — Archive current project state + all AI sessions as a git commit + tag
- *
- * Usage:
- *   node snapshot.mjs                              # snapshot cwd project
- *   node snapshot.mjs <project-path>              # snapshot a specific project
- *   node snapshot.mjs --project <path>            # same as above, explicit flag
- *   node snapshot.mjs --name <label>              # custom label for the snapshot commit
- *   node snapshot.mjs --force                     # skip active-CLI check
- *
- * What gets archived:
- *   All tracked project files (git add -A)
- *   .playcraft/sessions/  — session JSONL files (main + subagents) from all three stores
- *                            (Claude Code / Claude Internal / CodeBuddy) matching the project path
- *
- * Output: git commit  snapshot: {label} ({MMDD_HHmm})
- */
-
-import { spawnSync } from 'child_process';
-import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync, rmSync, cpSync } from 'fs';
-import { join, basename, resolve } from 'path';
-import { homedir } from 'os';
-
-// ── helpers ──────────────────────────────────────────────────────────────────
-
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const opts = { project: null, name: null, force: false };
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--project' && args[i + 1]) opts.project = args[++i];
-    else if (args[i] === '--name' && args[i + 1]) opts.name = args[++i];
-    else if (args[i] === '--force') opts.force = true;
-    else if (!args[i].startsWith('--') && !opts.project) opts.project = args[i];
-  }
-  return opts;
-}
-
-function timestamp() {
-  const d = new Date();
-  const pad = n => String(n).padStart(2, '0');
-  return `${pad(d.getMonth() + 1)}${pad(d.getDate())}_${pad(d.getHours())}${pad(d.getMinutes())}`;
-}
-
-function isoNow() {
-  return new Date().toISOString();
-}
-
-// ── active CLI detection ─────────────────────────────────────────────────────
-
-// ── session collection ───────────────────────────────────────────────────────
-
-function findSessions(projectCwd) {
-  const home = homedir();
-  const stores = [
-    { name: 'claude-code',     path: join(home, '.claude', 'projects') },
-    { name: 'codebuddy',       path: join(home, '.codebuddy', 'projects') },
-  ];
-
-  const normalizedCwd = resolve(projectCwd).replace(/\\/g, '/');
-  const slugVariants = [
-    normalizedCwd.replace(/[:/]/g, '-').replace(/\//g, '-'),
-    normalizedCwd.replace(/\\/g, '-').replace(/:/g, '-'),
-  ];
-  const projectName = basename(normalizedCwd);
-
-  const found = [];
-
-  for (const store of stores) {
-    if (!existsSync(store.path)) continue;
-    let projects;
-    try { projects = readdirSync(store.path); } catch { continue; }
-
-    for (const proj of projects) {
-      const projLower = proj.toLowerCase();
-      const matches =
-        projLower.includes(projectName.toLowerCase()) ||
-        slugVariants.some(s => projLower.includes(s.toLowerCase().slice(-30)));
-
-      if (!matches) continue;
-
-      const projPath = join(store.path, proj);
-      let stat;
-      try { stat = statSync(projPath); } catch { continue; }
-      if (!stat.isDirectory()) continue;
-
-      let files;
-      try { files = readdirSync(projPath).filter(f => f.endsWith('.jsonl')); } catch { continue; }
-
-      for (const f of files) {
-        const sessionId = f.replace('.jsonl', '');
-        const sessionFile = join(projPath, f);
-        const subagentsDir = join(projPath, sessionId, 'subagents');
-        found.push({
-          store: store.name,
-          project: proj,
-          sessionId,
-          sessionFile,
-          subagentsDir: existsSync(subagentsDir) ? subagentsDir : null,
-        });
-      }
-    }
-  }
-
-  return found;
-}
-
-function waitForStable(sessionFile, maxRetries = 3, intervalMs = 500) {
-  let lastSize;
-  try { lastSize = statSync(sessionFile).size; } catch { return false; }
-
-  for (let i = 0; i < maxRetries; i++) {
-    const waitUntil = Date.now() + intervalMs;
-    while (Date.now() < waitUntil) { /* spin */ }
-
-    let newSize;
-    try { newSize = statSync(sessionFile).size; } catch { return false; }
-
-    if (newSize === lastSize) return true;
-    lastSize = newSize;
-  }
-
-  return false;
-}
-
-// ── git operations ───────────────────────────────────────────────────────────
-
-function gitExec(cwd, args, env = {}) {
-  const result = spawnSync('git', ['-C', cwd, ...args], {
-    encoding: 'utf8',
-    env: { ...process.env, ...env },
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-  if (result.status !== 0) {
-    const errMsg = result.stderr?.trim() || result.stdout?.trim() || 'unknown error';
-    throw new Error(`git ${args[0]} failed: ${errMsg}`);
-  }
-  return result.stdout?.trim() || '';
-}
-
-function gitExecWithRetries(cwd, args, env = {}, maxRetries = 3) {
-  for (let attempt = 1; attempt <= maxRetries; attempt++) {
-    try {
-      return gitExec(cwd, args, env);
-    } catch (err) {
-      if (attempt < maxRetries && err.message.includes('.git/index.lock')) {
-        console.warn(`   ⚠  git index locked, retrying (${attempt}/${maxRetries})...`);
-        const waitUntil = Date.now() + 1000;
-        while (Date.now() < waitUntil) { /* spin */ }
-        continue;
-      }
-      throw err;
-    }
-  }
-}
-
-// ── main ─────────────────────────────────────────────────────────────────────
-
-const opts = parseArgs();
-
-// ── snapshot creation ─────────────────────────────────────────────────────────
-
-const executionCwd = process.cwd();
-const projectDir = opts.project ? resolve(executionCwd, opts.project) : executionCwd;
-const projectName = basename(projectDir);
-const ts = timestamp();
-const label = opts.name || `manual`;
-
-console.log(`\n📦 Snapshotting project: ${projectName}`);
-console.log(`   Source: ${projectDir}\n`);
-
-// 1. Verify .git/ exists
-const gitDir = join(projectDir, '.git');
-if (!existsSync(gitDir)) {
-  console.error(`❌ No .git directory found at ${projectDir}`);
-  console.error('   Snapshot requires a git repository. Use "git init" first.');
-  process.exit(1);
-}
-
-// 2. Active CLI check
-if (!opts.force) {
-  console.warn('   ⚠  Use --force to skip active-CLI check.\n');
-}
-
-// 3. Collect sessions with write stability detection
-console.log('🗂  Finding sessions...');
-const sessions = findSessions(projectDir);
-
-const sessionsDir = join(projectDir, '.playcraft', 'sessions');
-if (existsSync(sessionsDir)) {
-  rmSync(sessionsDir, { recursive: true, force: true });
-}
-mkdirSync(sessionsDir, { recursive: true });
-
-if (sessions.length === 0) {
-  console.log('   ⚠  No sessions found for this project path');
-} else {
-  console.log(`   Found ${sessions.length} session(s):`);
-  for (const s of sessions) {
-    const stable = waitForStable(s.sessionFile);
-    if (!stable) {
-      console.warn(`   ⚠  Session file still being written: ${s.sessionId.slice(0, 8)}… — copying anyway`);
-    }
-
-    const sessionDestDir = join(sessionsDir, s.store, s.project);
-    mkdirSync(sessionDestDir, { recursive: true });
-    cpSync(s.sessionFile, join(sessionDestDir, `${s.sessionId}.jsonl`));
-
-    let subCount = 0;
-    if (s.subagentsDir) {
-      const subDest = join(sessionDestDir, s.sessionId, 'subagents');
-      mkdirSync(subDest, { recursive: true });
-      const subFiles = readdirSync(s.subagentsDir).filter(f => f.endsWith('.jsonl'));
-      for (const sf of subFiles) {
-        cpSync(join(s.subagentsDir, sf), join(subDest, sf));
-        subCount++;
-      }
-    }
-
-    const sizeMB = (statSync(s.sessionFile).size / 1024 / 1024).toFixed(2);
-    console.log(`   ✓ [${s.store}] ${s.sessionId.slice(0, 8)}… (${sizeMB}MB, ${subCount} subagents)`);
-  }
-}
-
-// 4. Write manifest
-const manifest = {
-  createdAt: isoNow(),
-  projectName,
-  projectPath: projectDir,
-  label: opts.name || 'manual',
-  sessionCount: sessions.length,
-  sessions: sessions.map(s => ({
-    store: s.store,
-    project: s.project,
-    sessionId: s.sessionId,
-    hasSubagents: !!s.subagentsDir,
-  })),
-};
-writeFileSync(join(sessionsDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
-
-// 5. Git add all changes (including sessions)
-console.log('\n📝 Staging changes...');
-const GIT_ENV = {
-  GIT_AUTHOR_NAME: 'PlayCraft Snapshot',
-  GIT_AUTHOR_EMAIL: 'snapshot@playcraft.local',
-  GIT_COMMITTER_NAME: 'PlayCraft Snapshot',
-  GIT_COMMITTER_EMAIL: 'snapshot@playcraft.local',
-};
-
-gitExecWithRetries(projectDir, ['add', '-A'], GIT_ENV);
-console.log('   ✓ Staged');
-
-// 6. Commit
-console.log('\n💾 Committing snapshot...');
-const commitMsg = `snapshot: ${label} (${ts})`;
-gitExecWithRetries(projectDir, ['commit', '--allow-empty', '-m', commitMsg], GIT_ENV);
-const commitHash = gitExec(projectDir, ['rev-parse', '--short', 'HEAD']);
-console.log(`   ✓ Commit: ${commitHash}`);
-
-// 7. Summary
-console.log(`\n✅ Snapshot complete!`);
-console.log(`   Hash: ${commitHash}`);
-console.log(`   Sessions archived: ${sessions.length}\n`);

package/project-template-v2/.playcraft/skills.lock.json

@@ -1,152 +0,0 @@
-{
-  "lockVersion": 2,
-  "entries": [
-    {
-      "skillRef": "platform/playcraft-3d-flip-sprite",
-      "version": "1.0.0",
-      "artifactHash": "95183007861a4dae5b67440ea9beed1c360eb616d17e4aa04b97383cc2b63516",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-3d-flip-sprite"
-    },
-    {
-      "skillRef": "platform/playcraft-asset-management",
-      "version": "1.0.0",
-      "artifactHash": "27209dba24f6e1851dc83682fbd24165894c802794c797cac32d8871f740cf14",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-asset-management"
-    },
-    {
-      "skillRef": "platform/playcraft-build",
-      "version": "1.0.0",
-      "artifactHash": "2ca96916041bcc04ee48e827599dd819072e67a626bf59a1c20281f337e4063a",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-build"
-    },
-    {
-      "skillRef": "platform/playcraft-code-editor",
-      "version": "1.0.0",
-      "artifactHash": "abcc9aafe2b15adb8de62eb89921dbcb35c7dc634055b937fe34bdf83ca6685d",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-code-editor"
-    },
-    {
-      "skillRef": "platform/playcraft-create-remix",
-      "version": "1.0.0",
-      "artifactHash": "8d2a4d4d096433ccec090f1003c050471ddfbc50d69c1c0c66f88424b52bacf6",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-create-remix"
-    },
-    {
-      "skillRef": "platform/playcraft-deploy",
-      "version": "1.0.1",
-      "artifactHash": "31ac7f90d93606eb40c2113d56204e09b97ecd9e49b910b2ce05445b824ccfdc",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-deploy"
-    },
-    {
-      "skillRef": "platform/playcraft-iteration-methodology",
-      "version": "1.1.0",
-      "artifactHash": "f67a2f1806e08a48a903408383a06802622da3760d24d72a0dcbbea202349be2",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-iteration-methodology"
-    },
-    {
-      "skillRef": "platform/playcraft-platform-intro",
-      "version": "1.0.0",
-      "artifactHash": "b37f6b0515a79822f5f69519fcddd1182d420b90eb9ba40298bb1ed73eced281",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-platform-intro"
-    },
-    {
-      "skillRef": "platform/playcraft-prefab",
-      "version": "1.0.0",
-      "artifactHash": "a4a991302922d6846a2e313dc4cd4514f54820040dc2166ccc864803053c1ea5",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-prefab"
-    },
-    {
-      "skillRef": "platform/playcraft-project-management",
-      "version": "1.1.0",
-      "artifactHash": "8653eefd40bc3b5a84728522f778515332c2334e64d90407ce2f8846a1f72e98",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-project-management"
-    },
-    {
-      "skillRef": "platform/playcraft-remix-workflow",
-      "version": "1.0.1",
-      "artifactHash": "23807ff591b4bd08c87daa4e9b2c9900b0505e4f2f601c47de51a96d6ebbed19",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-remix-workflow"
-    },
-    {
-      "skillRef": "platform/playcraft-save",
-      "version": "1.0.1",
-      "artifactHash": "6d42c681f91f849603bf3c4f235411ea05189a0d5e3ca1d3a8f92b69e536bdd1",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-save"
-    },
-    {
-      "skillRef": "platform/playcraft-template-upgrade-merge",
-      "version": "1.0.0",
-      "artifactHash": "354da60f395f3eb7a267db667783344f54567e12abcfec454b269193a5af1cb6",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__playcraft-template-upgrade-merge"
-    },
-    {
-      "skillRef": "platform/sound-effects",
-      "version": "1.0.0",
-      "artifactHash": "a6ba7ea91ddbf4f5a04ae8340a69c3725c5d97b239e8636bf64886928e8dd1da",
-      "surface": "portal-agent",
-      "mountPath": ".playcraft/skills/platform__sound-effects"
-    },
-    {
-      "skillRef": "remix/playcraft-adsdk",
-      "version": "1.0.0",
-      "artifactHash": "0de877b122246ed5c665a893f8dc408282007d0950b0f6c44876f87ceddb519f",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-adsdk"
-    },
-    {
-      "skillRef": "remix/playcraft-audio-generation",
-      "version": "1.0.0",
-      "artifactHash": "8d1b035b289545ca8fd6c247b9417bf34bddf5a26b31e114c35d001aa3a9ebf0",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-audio-generation"
-    },
-    {
-      "skillRef": "remix/playcraft-dist-publish",
-      "version": "1.0.0",
-      "artifactHash": "9a00acc9b3b6f140f276032b722bbe7bbf3a9b1fa61fe71cb65913ebcd118772",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-dist-publish"
-    },
-    {
-      "skillRef": "remix/playcraft-image-generation",
-      "version": "1.0.0",
-      "artifactHash": "91bec2422c750d9d47d5be2796ec5aaffb48de561f2c2d8b92112f37d576f489",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-image-generation"
-    },
-    {
-      "skillRef": "remix/playcraft-image-processing",
-      "version": "1.0.0",
-      "artifactHash": "d845c067bed103c3d1d3f145b1cb8246ffbd6a9ae91efcfbce2eae456819212d",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-image-processing"
-    },
-    {
-      "skillRef": "remix/playcraft-prefab",
-      "version": "1.0.0",
-      "artifactHash": "3cce28f5b67398fffaaa6295d27cf514c8e1e1e998d142524facaff7d2c25561",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-prefab"
-    },
-    {
-      "skillRef": "remix/playcraft-remix-workflow",
-      "version": "1.0.0",
-      "artifactHash": "e2a59c61ef5b094a821fbbab3b0f65f906bfc0dfda6f3d8c0b33a6f460dd0963",
-      "surface": "sandbox-agent",
-      "mountPath": ".playcraft/skills/remix__playcraft-remix-workflow"
-    }
-  ]
-}

package/project-template-v2/CLAUDE.md

@@ -1,146 +0,0 @@
-# PlayCraft Playable Ad Project
-
-这是一个正在制作中的 PlayCraft playable ad 工程,由模板 `project-template-v2` 生成。当前目录不是通用代码库,而是一个会随多 agent 制作流程逐步长出的 playable 项目。
-
-本文件是项目速览:帮助任何 agent 快速理解当前工程形态、入口文件、状态来源和安全边界。它不是调度剧本,也不是状态真源。
-
-## Current Snapshot
-
-- Package: `playcraft-game`, template version `0.4.0-alpha.0`.
-- Runtime stack: Vite + TypeScript.
-- Current pipeline: iteration 1, stage `ideate`, status `pending`.
-- Locked decisions: engine `unset`, coreAction `unset`.
-- Runtime code: `game/index.ts` is still an engine placeholder. Engine scaffold has not been applied yet.
-- Design artifacts are not created yet: `docs/design.md`, `docs/design-brief.md`, `docs/atom-tree.json`, and `docs/todo_list.md` will appear during iteration 1.
-- Optimize verification currently includes `playable-record`, `playable-debug`, and `playable-validate`.
-
-## State Sources
-
-- State command: `npm run state:get` is the normal read entry for current workflow state.
-- Process backing file: `docs/project-state.json` (JSON, JavaScript Object Notation, JavaScript 对象表示法); do not read it directly unless debugging the state scripts.
-- Human view: `docs/project-state.md`, generated from the process backing file.
-- Pipeline specification: `skills/_shared/scripts/pipeline/`.
-- Orchestrator flow: `docs/harness/orchestrator-flow.md`.
-- Stage flow notes: `docs/harness/iteration-1/`.
-- Do not hand-edit `docs/project-state.md`; update state through scripts.
-
-State describes current work; it does not by itself prove which process you are. Use your entry context first, then state.
-
-Main agent entry:
-
-Read `docs/harness/orchestrator-flow.md`.
-
-Named role subagent entry:
-
-```bash
-npm run state:get -- --json dispatch
-```
-
-If `dispatch.role` is not your role, stop and report that no workticket is assigned to you.
-
-## Project Map
-
-### Runtime
-
-- `index.html` - browser document entry (HTML, HyperText Markup Language, 超文本标记语言).
-- `main.ts` - TypeScript entry; imports styles and mounts `startGame("game-container")`.
-- `game/index.ts` - current playable entry. At bootstrap it only displays the engine-not-scaffolded message.
-- `index.css` - global page layout and styling (CSS, Cascading Style Sheets, 层叠样式表).
-- `globals.d.ts` - asset module declarations and `__DEV__` global.
-- `vite.config.ts` - dev/build configuration, asset alias, port preference.
-
-### Assets
-
-- `assets/images/bg/` - background image candidates.
-- `assets/images/ui/` - user interface image candidates.
-- `assets/images/tiles/` - tile or board image candidates.
-- `assets/images/vfx/` - visual effect images.
-- `assets/images/storyboard/` and `assets/images/reference/` - ideation and reference images.
-- `assets/audio/bgm/` and `assets/audio/sfx/` - music and sound effects.
-- `assets/models/` - 3D (Three-Dimensional, 三维) model assets.
-- `assets/bundles/` - generated or packaged asset bundles.
-
-### Project State And Design
-
-- `docs/project-state.json` - process backing file for workflow state; normally read via `npm run state:get`.
-- `docs/project-state.md` - generated state view.
-- `docs/harness/pipeline-design.md` - pipeline v2 design and TODO backlog.
-- `docs/harness/orchestrator-flow.md` - orchestrator runtime loop and dispatch rules.
-- `docs/harness/iteration-1/ideate-flow.md` - design discovery and `docs/design.md` rules.
-- `docs/harness/iteration-1/context-flow.md` - atom-tree and plan-equivalent todo task-card seeding rules.
-- `docs/harness/iteration-1/generate-flow.md` - todo-driven implementation loop.
-- `docs/harness/iteration-1/optimize-flow.md` - build/autoplay/record target and verification skill usage.
-- `docs/harness/iteration-1/wrapup-flow.md` - cleanup and this file refresh rules.
-
-Expected iteration-1 artifacts:
-
-- `docs/design-brief.md` - discovery and brainstorming log.
-- `docs/design.md` - core gameplay design.
-- `docs/atom-tree.json` - selected atom and skills match source.
-- `docs/todo_list.md` - human-readable todo index and cross-todo ref/gap overview.
-
-### Workflow Scripts
-
-- `skills/_shared/scripts/state-get.mjs` - read orchestrator or dispatch state.
-- `skills/_shared/scripts/state-set.mjs` - update state fields.
-- `skills/_shared/scripts/state-advance-stage.mjs` - advance the pipeline stage.
-- `skills/_shared/scripts/todo-add.mjs` / `todo-set.mjs` / `todo-remove.mjs` - manage todo pool.
-- `skills/_shared/scripts/handoff-append.mjs` - append role handoff records.
-- `skills/_shared/scripts/dod-check.mjs` - run DoD (Definition of Done, 完成定义) checks for the current stage.
-- `skills/_shared/scripts/render-project-state.mjs` - render `docs/project-state.md` from JSON state.
-
-### Agent And Skill Context
-
-- `.claude/agents/` - role cards for game-designer, developer, artist, technical-artist, and reviewer.
-- `.claude/agents/refs/` - role reference material.
-- `.claude/skills/` - local skills visible to agents.
-- `.claude/hooks/` - Claude hook scripts.
-- `.claude/settings.json` - hook registration and agent-team environment.
-
-## Common Commands
-
-```bash
-npm run dev
-npm run build
-npm run typecheck
-npm run state:get
-npm run state:get -- --json dispatch
-npm run dispatch:set -- id=<id> role=<role> goal="..."
-npm run dispatch:clear
-npm run todo:add -- id=<id> role=<role> title="..." goal="..." context="..." acceptance="..."
-npm run todo:get -- id=<id>
-npm run todo:set -- id=<id> status=<pending|in_progress|done|failed>
-npm run handoff:append -- role=<role> summary="..." artifactRefs="<files>"
-npm run dod:check
-npm run verify:contract
-npm run verify:firstwin
-npm run verify:fusion
-npm run record:mp4
-npm run verify:vlm-video
-```
-
-Notes:
-
-- `npm run typecheck` requires dependencies to be installed first.
-- `record:mp4` requires Playwright Chromium to be installed; run `npm run record:mp4:install` if the local browser binary is missing.
-
-## Agent Boundaries
-
-- This file is injected into every agent, so keep it as project context only.
-- Main agent reads `npm run state:get` and remains orchestrator.
-- Subagents read `npm run state:get -- --json dispatch`, work within `allowedFiles`, satisfy `acceptance`, then append handoff.
-- Todo status is updated by the orchestrator after reading handoff; subagents do not mark their own todo done.
-- Do not put `stageExit`, `dispatchableRoles`, full todo pools, handoff history, or future-stage plans in this file.
-- Do not infer workflow progress from file presence alone; use `npm run state:get` for workflow state.
-
-## Refresh Policy
-
-Refresh this file during wrapup when the project shape changes. Update:
-
-- current snapshot;
-- runtime entry status;
-- key artifact existence;
-- directory map changes;
-- high-impact known gaps.
-
-Do not copy dynamic workflow history into this file. Detailed process rules belong in `docs/harness/` and `skills/_shared/scripts/pipeline/`.