@bovinphang/frontend-craft 2.8.0 → 3.0.0

package/dist/hooks/fec-run-tests.js

@@ -1 +1,5 @@
-import{existsSync as i,readFileSync as n}from"node:fs";import{execSync as o}from"node:child_process";try{let e=function(t){if(c[t])try{o(`${s} run ${t}`,{stdio:["ignore","pipe","pipe"],timeout:12e4})}catch{r=!0}};a=e,process.stdin.resume(),process.stdin.on("data",()=>{}),i("package.json")||process.exit(0);let p=process.env.FRONTEND_CRAFT_VALIDATION_MODE==="blocking",r=!1,c={};try{c=JSON.parse(n("package.json","utf-8")).scripts??{}}catch{process.exit(0)}let s="npm";i("pnpm-lock.yaml")?s="pnpm":i("yarn.lock")&&(s="yarn"),e("lint"),c["type-check"]?e("type-check"):e("typecheck"),e("test"),e("build"),p&&r&&process.exit(1)}catch{process.env.FRONTEND_CRAFT_VALIDATION_MODE==="blocking"&&process.exit(1)}var a;process.exit(0);
+import{existsSync as f,readFileSync as k}from"node:fs";import{execSync as y}from"node:child_process";import{existsSync as d}from"node:fs";function g(n){let e=n?.match(/^(npm|pnpm|yarn|bun)@/i)?.[1]?.toLowerCase();if(e==="npm"||e==="pnpm"||e==="yarn"||e==="bun")return e;let a=[["pnpm-lock.yaml","pnpm"],["yarn.lock","yarn"],["bun.lock","bun"],["bun.lockb","bun"],["package-lock.json","npm"]],t=new Set(a.filter(([c])=>d(c)).map(([,c])=>c));return t.size===1?[...t][0]:"npm"}process.stdin.resume();process.stdin.on("data",()=>{});f("package.json")||process.exit(0);var l=process.env.FRONTEND_CRAFT_VALIDATION_MODE==="blocking",o=!1;try{let n=JSON.parse(k("package.json","utf8")),e=n.scripts??{},a=g(n.packageManager),t=["lint",e["type-check"]?"type-check":"typecheck","test","build"],c=t.filter(s=>e[s]&&!t.some(r=>r!==s&&u(e,r,s)));for(let s of c)try{y(`${a} run ${s}`,{stdio:["ignore","pipe","pipe"],timeout:12e4})}catch(r){o=!0;let i=r,p=[i.stderr,i.stdout,i.message].map(m=>String(m??"").trim()).find(Boolean);process.stderr.write(`[frontend-craft] ${s} failed${p?`:
+${p.slice(-2e3)}`:"."}
+`)}o&&process.stderr.write(`[frontend-craft] Validation failed (${l?"blocking":"advisory"} mode).
+`)}catch(n){o=!0,process.stderr.write(`[frontend-craft] Validation could not run: ${n instanceof Error?n.message:String(n)}
+`)}process.exit(l&&o?1:0);function u(n,e,a,t=new Set){return!n[e]||t.has(e)?!1:(t.add(e),[...n[e].replace(/"(?:\\.|[^"\\])*"|'[^']*'/g," ").matchAll(/(?:^|&&|;|\|\|)\s*(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?([a-z][\w:-]*)\b/gi)].map(r=>r[1]).some(r=>r===a||u(n,r,a,t)))}

package/dist/hooks/fec-session-start.js

@@ -1 +1 @@
-import{existsSync as a,readFileSync as c}from"node:fs";process.stdin.resume();process.stdin.on("data",()=>{});a("package.json")||process.exit(0);var r="unknown";try{let t=JSON.parse(c("package.json","utf-8")),e={...t.dependencies,...t.devDependencies},n=[];(e.vue||e.nuxt)&&n.push("Vue "+(e.vue||e.nuxt)),(e.react||e.next)&&n.push("React "+(e.react||e.next)),e["@angular/core"]&&n.push("Angular "+e["@angular/core"]),r=n.join(", ")||"unknown"}catch{}var s="npm";a("pnpm-lock.yaml")?s="pnpm":a("yarn.lock")?s="yarn":a("bun.lockb")&&(s="bun");r!=="unknown"&&process.stdout.write(`[frontend-craft] Framework: ${r} | Package manager: ${s}`);process.exit(0);
+import{existsSync as i,readFileSync as u}from"node:fs";import{existsSync as p}from"node:fs";function o(a){let n=a?.match(/^(npm|pnpm|yarn|bun)@/i)?.[1]?.toLowerCase();if(n==="npm"||n==="pnpm"||n==="yarn"||n==="bun")return n;let e=[["pnpm-lock.yaml","pnpm"],["yarn.lock","yarn"],["bun.lock","bun"],["bun.lockb","bun"],["package-lock.json","npm"]],c=new Set(e.filter(([r])=>p(r)).map(([,r])=>r));return c.size===1?[...c][0]:"npm"}process.stdin.resume();process.stdin.on("data",()=>{});i("package.json")||process.exit(0);var t="unknown",s;try{let a=JSON.parse(u("package.json","utf-8"));s=a.packageManager;let n={...a.dependencies,...a.devDependencies},e=[];(n.vue||n.nuxt)&&e.push("Vue "+(n.vue||n.nuxt)),(n.react||n.next)&&e.push("React "+(n.react||n.next)),n["@angular/core"]&&e.push("Angular "+n["@angular/core"]),t=e.join(", ")||"unknown"}catch{}var g=o(s);t!=="unknown"&&process.stdout.write(`[frontend-craft] Framework: ${t} | Package manager: ${g}`);process.exit(0);

package/docs/common-migration.md

@@ -0,0 +1,61 @@
+# Common capability migration in frontend-craft3.0
+
+The exact common dependency is`@bovinphang/craft-common@2.0.0`: a final version number prepared but not published. Frontend3.0.0 and backend 1.0.0 remain unreleased with unchanged product versions. Paths, explicit planning sessions, ownership, locks and recovery are shared; products retain conversion and their CLI/native-channel policies.
+
+Version 3.0 delivers 53 frontend and 21 common entries, 74 in total. Version 2.0.0 retains 1.0.1 recovery repairs. Do not mix 1.x or development snapshots with 2.0.0: exit all old shared consumers using the old product CLIs and resolve retained edits before installing matching products. Public installation awaits actual common/product publication and the existing supply-chain policy window.
+
+| Previous entry | Version 3.0 |
+| --- | --- |
+| fec-drawio-studio | cc-drawio-studio |
+| fec-source-driven-development | cc-source-driven-development; frontend domain rule filenames retain their fec names |
+| fec-image-generation | cc-technical-diagrams for technical diagrams; keep the frontend entry for UI/product imagery and editing |
+| fec-doc-sync | Keep frontend documentation workflow; use cc-doc-sync-core for the shared method |
+| fec-debug-framework | Keep frontend diagnosis; use cc-debug-methodology for the shared method |
+| fec-refactoring | Keep frontend refactoring and its subsystem; use cc-refactoring-core for the shared method |
+| fec-tdd-workflow | Keep frontend test selection; use cc-tdd-methodology for the shared method |
+
+Run the read-only check before updating references:
+
+```sh
+fec runtime check-migration codex --local
+fec runtime check-migration codex --local --json
+fec runtime check-migration codex --global --json
+```
+
+Omit the runtime to inspect all supported runtimes. Exit codes: 0 no pending items; 1 references or legacy installations need review; 2 argument, read or manifest errors. Checks never rewrite user files or echo complete matching lines. Secrets, dependencies, build outputs, binary files and symlinks are excluded; text files larger than 2 MiB are skipped. Global checks inspect managed files and legacy common skill directories, not the whole home directory.
+
+Text findings are suggestions. Migration tables, historical records and same-named domain rules may legitimately retain old names. Frontend entries that remain supported are not mechanically renamed; split suggestions depend on same-line task context and require review.
+
+Then install or refresh runtime resources:
+
+```sh
+fec runtime install codex --local
+fec runtime update codex --local
+```
+
+An unchanged legacy common entry owned by the old frontend manifest is retired in the same transaction as the new installation. Modified, unknown, symlinked or unowned legacy entries block migration. Back up and review customizations, then manually integrate or move the legacy entry before retrying; never clear an entire runtime directory.
+
+Consumers sharing the same actual skill directory must agree on exact common version, content digest and language. Conflicts fail before writes. Removing one consumer preserves common files used by others. Partial frontend uninstall retains the common reference while modified frontend files remain. The last consumer removes only unchanged owned files; edited files retain their ownership record.
+
+After interruption, rerun with the same product, scope and directories. Recoverable local transactions are repaired; uncertain locks or path boundaries preserve the evidence and fail safely.
+
+The same product manifest path cannot change runtime, local/global scope or common target; uninstall the original identity first. Migration from an old global configuration also checks legacy common files before writing and preserves the original directory. Recovery covers local process interruption, without power-loss durability or multi-host shared-filesystem coordination guarantees.
+
+Dual-consumer CLI installation is verified. Claude/OpenClaw native packages include complete common snapshots; cross-product native-plugin deduplication is outside this release's guarantee. Public registry publication remains a separate release step and is not performed automatically during development.
+
+## 2026-11-08 coordinated2.0.0 upgrade / 当前协调升级
+
+Current source: common 2.0.0 (release prepared, unpublished), frontend 3.0.0/backend 1.0.0 (unchanged, unreleased). 2.0.0同样要求版本、语言和摘要一致；不自动升级另一个产品。
+
+1. Back up user edits and inspect local/global/runtime identity. 备份修改，确认安装范围。
+2. With each OLD product CLI, uninstall its runtime resources and resolve preserved edits until both old common consumers exit. 使用各旧 CLI 退出旧公共引用，不用新 CLI 越权接管。
+3. Install both matching product builds using verified artifacts; public clean install must wait for common publication. 安装新匹配产品前执行 runtime check-migration。
+4. Managed unchanged legacy language entries retire in the same transaction as new cc deployment. Unknown files, edits, links or invalid ownership block the whole install; dry-run writes nothing. 原领域入口不建立假别名。
+
+Rename: fec-typescript-project-standard → cc-typescript-project-standard; bec-{rust,go,java,python,c,cpp}-project-standard → cc-*-project-standard; bec-{rust-async,go-concurrency,python-async,java-runtime,native-memory-safety} → cc-* equivalents. Frontend retains its earlier drawio/source-driven rename policy.
+
+Checks return 0 (nothing found), 1 (reviewable references/owned retired entries), 2 (invalid arguments, scan failure or retirement conflict). Reports show paths, IDs and line numbers, never full source lines. No-Skill hosts receive reference material rather than a fabricated native Skill alias. 双原生产品去重仍不在保证范围。
+
+<!-- engineering-practices-20261108 -->
+
+本轮2.0.0包含工程实践内容，仍要求两产品版本、语言和内容摘要精确一致。新内容不放宽旧消费者冲突；退出旧引用并处理保留编辑后，再安装两份匹配产品。Cline/Trae/Copilot的私有reference-skills包含新增三公共资源与本地卡，不宣称原生Skill支持，也不登记common consumer。

package/docs/example-prompts.md

@@ -23,10 +23,14 @@ Each example follows the same shape:
 
 | Scenario              | Prompt                                                                                                                                                                      | Best for                                                    | Expected output                                                                                   | Notes                                                                            |
 | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| Default project review | "`/fec-review`" | cmd: `/fec-review` | Project risk assessment with coverage, exclusions and remaining modules. | Defaults to full project review even when Git changes exist. |
 | Review recent changes | "Review my recent changes before merge. Focus on architecture, type safety, rendering behavior, styles, accessibility, and missing tests. Put findings first."              | skill: `fec-code-review` · agent: `fec-code-reviewer` · cmd: `/fec-review`       | Severity-ordered review with file references and test gaps.                                       | Add branch or diff range if needed.                                              |
-| PR readiness review   | "Review `src/features/checkout/` as if this is a PR. Call out blockers, risky assumptions, and what must be tested before merge."                                           | agent: `fec-code-reviewer`                                         | Merge readiness assessment and structured report.                                                 | Include PR link if the runtime can access it.                                    |
+| PR readiness review | "Review the changes in this PR. Call out blockers, risky assumptions, and what must be tested before merge." | agent: `fec-code-reviewer` | Merge readiness assessment and structured report. | Provide the PR link or explicit diff range. |
+| Review a specified file | "Review `src/components/Button.tsx`, including unchanged code. Report only; do not fix." | cmd: `/fec-review` · skill: `fec-code-review` | File risk assessment and coverage. | No Git diff required. |
+| Review a directory | "Review all existing frontend code in `src/features/checkout/`, including unchanged code." | agent: `fec-code-reviewer` | Directory risk assessment and unreviewed inventory. | Explicit scope overrides the default project mode. |
+| Review the entire project | "Review all project-owned frontend code, related tests, configuration and dependency declarations. Inventory first, review by module, record exclusions and unreviewed scope, and mark incomplete coverage partial. Report only; do not fix." | skill: `fec-code-review` · cmd: `/fec-review` | Project risk assessment and coverage inventory. | Works without changes; does not replace backend audit. |
 | TypeScript专项 review | "Audit the changed `.ts` and `.tsx` files for unsafe types, async bugs, over-wide interfaces, stale derived state, and non-idiomatic React/TypeScript."                     | agent: `fec-typescript-reviewer`                                   | TypeScript-focused findings, usually report-only.                                                 | Best when JS/TS changes dominate.                                                |
-| Type contract review  | "Review the API DTOs, component props, generic helpers, and type guards in `src/features/billing/` for unsound assertions, over-wide types, and missing runtime narrowing." | skill: `fec-typescript-project-standard` · agent: `fec-typescript-reviewer`     | Type-boundary findings with safer models and type-test suggestions.                               | Good for SDK, design-system, or API-heavy changes.                               |
+| Type contract review  | "Review the API DTOs, component props, generic helpers, and type guards in `src/features/billing/` for unsound assertions, over-wide types, and missing runtime narrowing." | skill: `cc-typescript-project-standard` · agent: `fec-typescript-reviewer`     | Type-boundary findings with safer models and type-test suggestions.                               | Good for SDK, design-system, or API-heavy changes.                               |
 | Security review       | "Audit `src/lib/auth.ts`, API clients, and any user HTML rendering for XSS, token leakage, unsafe storage, CSRF assumptions, and dangerous DOM APIs."                       | skill: `fec-security-review` · agent: `fec-security-reviewer`              | Security findings ranked by severity with concrete fixes.                                         | Include auth model and storage constraints.                                      |
 | Accessibility review  | "Check `src/components/ConfirmDialog.tsx` for focus trapping, keyboard flow, labels, ARIA usage, screen-reader behavior, touch targets, and WCAG 2.2 AA issues."            | skill: `fec-accessibility-check`                                   | A11y findings and implementation guidance.                                                        | Provide screenshots for visual focus issues.                                     |
 | Performance review    | "Analyze dashboard performance with evidence: Core Web Vitals, bundle size, render hotspots, data waterfalls, memory leaks, and a realistic performance budget."            | skill: `fec-performance-optimization` · agent: `fec-performance-optimizer` | Performance report with baseline evidence, priorities, verification commands, and targeted fixes. | Include profiles, Lighthouse output, traces, or the slow user flow if available. |
@@ -39,7 +43,7 @@ Each example follows the same shape:
 | Plan a feature         | "Before coding, plan the account billing feature: route structure, component boundaries, data flow, state ownership, validation flow, and rollout risks."                                      | cmd: `/fec-plan` · agent: `fec-architect`                            | Architecture proposal and implementation plan.                                                               | Give acceptance criteria and constraints.                  |
 | Split a complex page   | "Refactor `src/pages/Dashboard.tsx` on paper first. Propose component boundaries, hooks, state ownership, and a safe step-by-step migration."                                                  | agent: `fec-architect` · skill: `fec-refactor-clean`                   | Refactor plan with risk controls.                                                                            | Ask for no code changes if you only want planning.         |
 | Test strategy          | "For the checkout rewrite, map risks to static checks, unit tests, component tests, E2E, visual checks, accessibility, and security coverage."                                                 | cmd: `/fec-plan` · skill: `fec-testing-strategy` · agent: `fec-test-planner` | Testing matrix and priority order.                                                                           | Useful before a large implementation.                      |
-| Source-driven decision | "Before changing our Next.js caching approach, verify the current project code and official docs. Summarize the version assumptions, recommended pattern, migration impact, and tests needed." | skill: `fec-source-driven-development`                         | Source-backed decision summary with project facts, official references, assumptions, and verification steps. | Best for framework/library behavior that may have changed. |
+| Source-driven decision | "Before changing our Next.js caching approach, verify the current project code and official docs. Summarize the version assumptions, recommended pattern, migration impact, and tests needed." | skill: `cc-source-driven-development`                         | Source-backed decision summary with project facts, official references, assumptions, and verification steps. | Best for framework/library behavior that may have changed. |
 | Legacy migration       | "We have a jQuery multi-page app in `public/js/legacy/`. Create a phased plan to migrate to React + TypeScript without stopping feature work."                                                 | skill: `fec-legacy-to-modern-migration`                        | Migration plan, risks, milestones, compatibility strategy.                                                   | Include release cadence and legacy constraints.            |
 
 ## Implementation
@@ -51,9 +55,9 @@ Each example follows the same shape:
 | Next.js App Router  | "Review and improve `app/(dashboard)/reports/page.tsx` for App Router data fetching, metadata, loading/error states, server/client boundaries, and actions."                                          | skill: `fec-nextjs-project-standard`                                | Next.js-specific findings or code changes.                                                       | Include route segment behavior.                                   |
 | Nuxt 3 page         | "Build the admin reports page in Nuxt 3 with correct SSR behavior, `useFetch`/composables, middleware, and typed server routes."                                                                      | skill: `fec-nuxt-project-standard`                                  | Nuxt implementation following conventions.                                                       | State whether route is SSR, SSG, or SPA.                          |
 | Vite config         | "Audit `vite.config.ts` for HMR, env variable exposure, dev proxy, build output, dependency pre-bundling, and plugin ordering."                                                                       | skill: `fec-vite-project-standard`                                  | Vite config findings and safe edits.                                                             | Include build or dev-server symptoms.                             |
-| Official-docs check | "Check whether our Vite dependency pre-bundling workaround is still needed in the installed version. Use project config and official docs before recommending removal."                               | skill: `fec-source-driven-development` · skill: `fec-vite-project-standard` | Version-aware recommendation with source notes and rollback/verification plan.                   | Useful before removing compatibility code.                        |
+| Official-docs check | "Check whether our Vite dependency pre-bundling workaround is still needed in the installed version. Use project config and official docs before recommending removal."                               | skill: `cc-source-driven-development` · skill: `fec-vite-project-standard` | Version-aware recommendation with source notes and rollback/verification plan.                   | Useful before removing compatibility code.                        |
 | Monorepo boundaries | "Check `apps/web` and `packages/ui` for package boundaries, workspace dependencies, build scripts, and Turborepo/Nx task graph issues."                                                               | skill: `fec-monorepo-project-standard`                              | Boundary and task orchestration review.                                                          | Include package manager and workspace files.                      |
-| Dependency upgrade  | "Plan the Vite and Storybook upgrade in this repo: read release notes, identify breaking changes, review lockfile and peer dependency risks, and propose the validation matrix."                      | skill: `fec-dependency-upgrade` · skill: `fec-source-driven-development`    | Upgrade batches, source-backed risks, affected areas, verification commands, and rollback notes. | Keep major upgrades separate from unrelated refactors.            |
+| Dependency upgrade  | "Plan the Vite and Storybook upgrade in this repo: read release notes, identify breaking changes, review lockfile and peer dependency risks, and propose the validation matrix."                      | skill: `fec-dependency-upgrade` · skill: `cc-source-driven-development`    | Upgrade batches, source-backed risks, affected areas, verification commands, and rollback notes. | Keep major upgrades separate from unrelated refactors.            |
 | Server-state data   | "Review `src/queries/useReports.ts`: query keys, cache lifetime, invalidation, optimistic updates, error states, and suspense/loading behavior."                                                      | skill: `fec-data-fetching`                                          | TanStack Query/server-state guidance or implementation.                                          | Include API volatility and UX expectations.                       |
 | State ownership     | "Audit dashboard state ownership: decide what belongs in URL params, TanStack Query, local component state, browser persistence, or a global store, then propose a safe migration."                   | skill: `fec-state-management`                                       | State inventory, ownership decisions, store boundaries, and verification steps.                  | Useful before store refactors or removing duplicated state.       |
 | Backend handoff     | "Write a frontend-to-backend requirements handoff for the order detail page: data to display, user actions, UI states, permission rules, uncertainties, and questions for backend."                   | skill: `fec-backend-requirements-handoff`                           | Backend-facing requirements document focused on UI needs and open questions.                     | Use before API contract design when backend owns implementation.  |
@@ -67,7 +71,7 @@ Each example follows the same shape:
 | Canvas/Three.js     | "Add a WebGL shader background or Three.js product viewer with responsive sizing, WebGL2/shader error checks, accessible fallback, performance safeguards, and verification that the canvas renders." | skill: `fec-canvas-threejs`                                         | 3D/canvas/shader implementation and visual verification.                                         | Include assets, shader requirements, and interaction constraints. |
 | SVG animation       | "Add reduced-motion-aware SVG micro-interactions to the hero illustration using the animation library already used in the app."                                                                       | skill: `fec-svg-animation`                                          | SVG animation with fallback behavior.                                                            | Include motion constraints and target browsers.                   |
 | Cross-skill absorption | "Absorb the testing strategy from this reference repository into our project: keep what fits, redesign in our conventions, and write a 1-page plan that names reusable patterns and a migration path."                                                          | skill: `fec-alchemy`                                                | Reusable pattern inventory, redesign proposal, and migration path.                               | Provide the reference repo URL or local path; note stack and project constraints.          |
-| Editable tech diagram   | "Generate an editable draw.io architecture diagram for the auth flow: emit a `.drawio` source, run the lint, produce a viewer URL, and export a PNG. Use existing shape and brand symbol lookups." | skill: `fec-drawio-studio`                                          | `.drawio` source, lint report, viewer/editor URL, and PNG export.                                | If the data is data-residency sensitive, use a self-hosted base URL or local CLI export.    |
+| Editable tech diagram   | "Generate an editable draw.io architecture diagram for the auth flow: emit a `.drawio` source, run the lint, produce a viewer URL, and export a PNG. Use existing shape and brand symbol lookups." | skill: `cc-drawio-studio`                                          | `.drawio` source, lint report, viewer/editor URL, and PNG export.                                | If the data is data-residency sensitive, use a self-hosted base URL or local CLI export.    |
 
 ## UI And Design
 
@@ -75,10 +79,10 @@ Each example follows the same shape:
 | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
 | Design-to-code             | "Implement the UI from Figma node `123:456`. Use existing design tokens and components, match spacing and responsive states, and document assumptions."                                                                      | skill: `fec-implement-from-design` · agent: `fec-figma-implementer` | UI code plus design implementation notes/report.                                    | Works best with MCP credentials configured.                                             |
 | Screenshot-to-polish       | "Polish this dashboard UI so it feels like a production SaaS tool: density, hierarchy, empty/loading/error states, responsive layout, and interaction states."                                                               | skill: `fec-ui-design`                                      | UI improvements and visual QA notes.                                                | Provide screenshot or local URL if possible.                                            |
-| Image and diagram generation | "Generate an editable architecture diagram and PNG, then run PNG QA for overlap, clipped labels, and stacked connectors; repair the source for up to two rounds."                                                          | skill: `fec-image-generation` · skill: `fec-ui-design`              | Editable source, exported PNG, QA report, and repair notes.                         | Use manifest coordinates when the renderer can expose layout boxes.                     |
-| System blueprint diagram | "Create a presentation-ready system blueprint for our checkout platform. Keep the JSON and generated HTML as source, then export SVG and PNG delivery artifacts." | skill: `fec-image-generation` | JSON/HTML source, exported SVG/PNG, and source/asset handoff notes. | Best for architecture, deployment topology, agent runtime, memory, and before/after system maps. |
-| Process workflow diagram | "Turn this approval and automation flow into a readable process workflow diagram with lanes, ordered steps, decisions, exception paths, loop-backs, and waypoint-routed edges." | skill: `fec-image-generation` | Workflow JSON/HTML source, exported image, and notes about lanes, nodes, edges, and waypoints. | Use when ownership and branching matter more than exact infrastructure topology. |
-| Interactive live diagram | "Start a local interactive diagram session for the onboarding flow. Add nodes and edges incrementally, let me drag, relabel, remove, zoom, and then export the final deliverables." | skill: `fec-image-generation` | Live browser preview plus saved JSON/SVG/PNG or a handoff to HTML/draw.io source. | Good for collaborative sketching; switch to HTML technical diagrams or draw.io for long-term source ownership. |
+| Image and diagram generation | "Generate an editable architecture diagram and PNG, then run PNG QA for overlap, clipped labels, and stacked connectors; repair the source for up to two rounds."                                                          | skill: `cc-technical-diagrams` · skill: `fec-ui-design`              | Editable source, exported PNG, QA report, and repair notes.                         | Use manifest coordinates when the renderer can expose layout boxes.                     |
+| System blueprint diagram | "Create a presentation-ready system blueprint for our checkout platform. Keep the JSON and generated HTML as source, then export SVG and PNG delivery artifacts." | skill: `cc-technical-diagrams` | JSON/HTML source, exported SVG/PNG, and source/asset handoff notes. | Best for architecture, deployment topology, agent runtime, memory, and before/after system maps. |
+| Process workflow diagram | "Turn this approval and automation flow into a readable process workflow diagram with lanes, ordered steps, decisions, exception paths, loop-backs, and waypoint-routed edges." | skill: `cc-technical-diagrams` | Workflow JSON/HTML source, exported image, and notes about lanes, nodes, edges, and waypoints. | Use when ownership and branching matter more than exact infrastructure topology. |
+| Interactive live diagram | "Start a local interactive diagram session for the onboarding flow. Add nodes and edges incrementally, let me drag, relabel, remove, zoom, and then export the final deliverables." | skill: `cc-technical-diagrams` | Live browser preview plus saved JSON/SVG/PNG or a handoff to HTML/draw.io source. | Good for collaborative sketching; switch to HTML technical diagrams or draw.io for long-term source ownership. |
 | Web video presentation | "Turn this article into a recordable 16:9 web video presentation: create script and outline, scaffold a Vite/React stage, and define chapter steps for screen recording." | skill: `fec-web-video-presentation` · skill: `fec-ui-design` | Script/outline, step-driven presentation scaffold, theme notes, and recording checklist. | Best for talks, lessons, product demos, and narrated explainers. |
 | Responsive layout          | "Fix this admin table for 375px, 768px, and 1440px: decide mobile column priority, container-query behavior, touch targets, safe-area handling, and overflow rules."                                                         | skill: `fec-responsive-layout` · agent: `fec-ui-checker`            | Responsive strategy, layout changes, viewport checks, and remaining risks.          | Include screenshots or a local route when possible.                                     |
 | Tailwind design system     | "Refactor these Tailwind components into semantic tokens and variants: theme extension, dark mode, class composition, dynamic class safety, and Storybook state coverage."                                                   | skill: `fec-tailwind-design-system` · skill: `fec-ui-design`        | Token/variant plan or implementation with class governance and dark-mode checks.    | Useful before a shared UI package grows too large.                                      |
@@ -105,6 +109,14 @@ Each example follows the same shape:
 | E2E smoke test      | "Add Playwright smoke tests for login and checkout. Use Page Objects, stable selectors, CI-friendly retries, and trace artifacts on failure."                 | skill: `fec-e2e-testing` · agent: `fec-e2e-runner` | E2E tests, runner guidance, and summary report. | Include test account or mock strategy.              |
 | Flaky E2E diagnosis | "The checkout E2E test is flaky in CI. Analyze likely timing, network, storage, and selector issues, then stabilize it without hiding failures."              | skill: `fec-e2e-testing` · agent: `fec-e2e-runner` | Root-cause analysis and targeted fix.           | Include CI logs or traces.                          |
 
+## Refactoring
+
+| Scenario | Prompt | Best for | Expected output | Notes |
+| --- | --- | --- | --- | --- |
+| Smell diagnosis only | "Use `/fec-smell` on `src/features/compose/`. Show evidence, confidence, false-positive checks, and candidate techniques; do not edit business code." | cmd: `/fec-smell` · skill: `fec-code-smells` | Prioritized smell report. | Use when you want diagnosis before committing to a change. |
+| Refactoring plan only | "Use `/fec-refactor-plan` to turn the current compose-module smells into ordered, small, behavior-preserving steps with risk, diff budget, validation, and rollback boundaries." | cmd: `/fec-refactor-plan` · skill: `fec-refactoring` | Refactoring plan. | Plan-only; no source edits. |
+| Behavior-preserving execution | "Use `/fec-refactor` on this validation/request/state function. Keep observable behavior unchanged, apply one main transformation at a time, verify each step, and revert before repairing a regression." | cmd: `/fec-refactor` · agent: `fec-refactoring-expert` | Validated refactoring plus report. | Pure refactoring uses GREEN → REFACTOR → GREEN. |
+
 ## Debugging
 
 | Scenario             | Prompt                                                                                                                                                                                              | Best for                              | Expected output                                                              | Notes                                                                       |
@@ -120,7 +132,7 @@ Each example follows the same shape:
 | Dead-code cleanup     | "Find and safely remove unused exports, dead routes, stale styles, and unused dependencies. Preserve public API and write a report."                                              | cmd: `/fec-refactor-clean` · skill: `fec-refactor-clean` · agent: `fec-refactor-cleaner`       | Cleanup plan/changes and report.                                                   | Good before releases.                           |
 | Documentation sync    | "Update the README and docs so setup, scripts, environment variables, API routes, UI routes, and deployment notes match the current frontend code and config."                     | cmd: `/fec-doc-sync` · skill: `fec-doc-sync` · agent: `fec-doc-updater`                        | Synchronized docs and verification notes.                                          | Avoid copying temporary reports into docs.      |
 | Capability docs sync  | "This repo publishes skills and commands. Sync the capability tables, metadata, runtime docs, and package files with the installed contents."                                      | cmd: `/fec-doc-sync` · skill: `fec-doc-sync` · agent: `fec-doc-updater`                        | Distribution docs grounded in installed files.                                     | Use for skill/agent/command repos.              |
-| Source-backed upgrade | "Plan a safe upgrade for React Router/TanStack Query/Vite. Check official migration notes, compare current project usage, list breaking changes, and propose verification steps." | skill: `fec-dependency-upgrade` · skill: `fec-source-driven-development` · cmd: `/fec-doc-sync` | Upgrade decision notes, affected files, migration risks, and validation checklist. | Pair with docs sync if public guidance changes. |
+| Source-backed upgrade | "Plan a safe upgrade for React Router/TanStack Query/Vite. Check official migration notes, compare current project usage, list breaking changes, and propose verification steps." | skill: `fec-dependency-upgrade` · skill: `cc-source-driven-development` · cmd: `/fec-doc-sync` | Upgrade decision notes, affected files, migration risks, and validation checklist. | Pair with docs sync if public guidance changes. |
 | Legacy maintenance    | "Improve `public/js/legacy/cart.js` while keeping the current jQuery/MPA stack. Reduce risk, improve structure, and do not rewrite it to React yet."                              | skill: `fec-legacy-web-standard`                                                 | Safe legacy maintenance changes or recommendations.                                | Mention browser support constraints.            |
 
 ## Power-User Prompts
@@ -137,4 +149,9 @@ Use these when you know the internal entry point you want.
 | Slash command build fix | "`/fec-debug` Fix the failing validation commands from this log: <paste log>."                                                                                           | cmd: `/fec-debug`      | Incremental validation fixes.         | Paste exact logs.                                     |
 | Slash command cleanup   | "`/fec-refactor-clean` Safely remove unused exports and dependencies from this package."                                                                                     | cmd: `/fec-refactor-clean` | Cleanup report and safe edits.        | Run tests after.                                      |
 | Slash command docs      | "`/fec-doc-sync` Sync README, docs, env examples, scripts, API/route notes, and deploy docs with the current project."                                                  | cmd: `/fec-doc-sync`       | Docs updates and verification.        | Use before releases.                                  |
-| Explicit agent          | "Delegate to `fec-code-reviewer` for a PR-style review of `src/features/payments/`, then summarize blockers first."                                                          | agent: `fec-code-reviewer`        | Specialized agent report and summary. | Best for focused expert review.                       |
+| Explicit agent | "Delegate to `fec-code-reviewer` to review existing code in `src/features/payments/`, including unchanged code, then summarize blockers first." | agent: `fec-code-reviewer` | Targeted risk assessment and specialist report. | No Git diff required. |
+
+
+Technical diagram quality: `cc-technical-diagrams` prefers local Mermaid for standard sequence/workflow diagrams and the draw.io workflow for editable architecture, with JSON/HTML fallback when tools are unavailable. Export a browser-measured manifest scaled to the PNG, run QA and inspect the final image. Preserve complete text, explicit layout and relationships; repair the source for at most two automatic rounds and report unresolved issues. Reproducible fixtures are in `skills/cc-technical-diagrams/assets/quality-examples/`.
+
+[Review scope and technical diagram delivery](review-and-diagram-workflows.md) — scope, tool prerequisites, export commands, and QA limits.

package/docs/ja-JP/README.md

@@ -22,6 +22,9 @@
 
 </div>
 
+
+[ランタイム互換性とアップグレード](../runtimes/compatibility.md)
+
 ---
 
 `frontend-craft` は、以下の **15 の AI コーディングアシスタント**に統一されたフロントエンドエンジニアリング標準をもたらす**汎用フロントエンドプラグイン**です：
@@ -32,7 +35,7 @@
 
 各ランタイムのパスと注意事項は [`docs/runtimes/`](../runtimes/) にあります。
 
-**13 の専門エージェント**、**45 の自動起動スキル**、**8 のスラッシュコマンド**、**5 のイベント駆動フック**、6 つのデザインツールエンドポイント向け **MCP 統合**、そして完全な**ルールライブラリ**をひとつのパッケージにまとめています。コマンドひとつ実行するだけで、チームのすべての AI セッションが React、Vue、Next.js、Nuxt を同じように書きます——型安全で、アクセシブルで、セキュアで、一貫性を持って。
+**14 の専門エージェント**、**61 の自動起動スキル**、**11 のスラッシュコマンド**、**5 のイベント駆動フック**、6 つのデザインツールエンドポイント向け **MCP 統合**、そして完全な**ルールライブラリ**をひとつのパッケージにまとめています。コマンドひとつ実行するだけで、チームのすべての AI セッションが React、Vue、Next.js、Nuxt を同じように書きます——型安全で、アクセシブルで、セキュアで、一貫性を持って。
 
 ---
 
@@ -40,10 +43,10 @@
 
 | 課題                                                                          | frontend-craft の解決策                                                                                        |
 | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| AI アシスタントが一貫性のない、型なしの、安全でないフロントエンドコードを書く | **45 のスキル**がチーム標準をエンコード——該当ファイルに触れると自動起動                                        |
+| AI アシスタントが一貫性のない、型なしの、安全でないフロントエンドコードを書く | **61 のスキル**がチーム標準をエンコード——該当ファイルに触れると自動起動                                        |
 | AI ツールごとにプラグイン形式が異なる                                         | **ひとつの CLI** で同じルール、エージェント、フックを 15 のランタイムにインストール                            |
 | デザインからコードへの受け渡しで情報が失われる                                | **MCP 統合**が Figma、Figma Desktop、Sketch、MasterGo、Pixso、墨刀からより豊富なデザインコンテキストを取り込み |
-| レビューが場当たり的で浅い                                                    | **13 のエージェント**がグレード付きレポートを出力：コード、セキュリティ、a11y、パフォーマンス、TS、UI 忠実度   |
+| レビューが場当たり的で浅い                                                    | **14 のエージェント**がグレード付きレポートを出力：コード、セキュリティ、a11y、パフォーマンス、TS、UI 忠実度   |
 | 誰も lint やテストを実行するのを忘れる                                        | **イベント駆動フック**が保存時とセッション終了時に自動検証                                                     |
 | 新規プロジェクトが毎回ゼロから始まる                                          | **`/fec-init`** が CLAUDE.md、ルール、設定を数秒でスキャフォールド                                             |
 
@@ -76,7 +79,7 @@ fec setup claude --global
 fec setup all --global
 
 # 6. プレビュー / 確認
-fec install --all --dry-run --global
+fec runtime install --all --dry-run --global
 fec list
 ```
 
@@ -89,17 +92,17 @@ fec list
 npx @bovinphang/frontend-craft@latest
 
 # 2. 現在のプロジェクトに接続
-npx @bovinphang/frontend-craft@latest install --local codex
-npx @bovinphang/frontend-craft@latest install --local claude
-npx @bovinphang/frontend-craft@latest install --all --local
+npx @bovinphang/frontend-craft@latest runtime install --local codex
+npx @bovinphang/frontend-craft@latest runtime install --local claude
+npx @bovinphang/frontend-craft@latest runtime install --all --local
 
 # 3. グローバル接続、すべてのプロジェクトで利用
-npx @bovinphang/frontend-craft@latest install --global codex
-npx @bovinphang/frontend-craft@latest install --global claude
-npx @bovinphang/frontend-craft@latest install --all --global
+npx @bovinphang/frontend-craft@latest runtime install --global codex
+npx @bovinphang/frontend-craft@latest runtime install --global claude
+npx @bovinphang/frontend-craft@latest runtime install --all --global
 
 # 4. プレビュー / 確認
-npx @bovinphang/frontend-craft@latest install --all --dry-run --global
+npx @bovinphang/frontend-craft@latest runtime install --all --dry-run --global
 npx @bovinphang/frontend-craft@latest list
 ```
 
@@ -109,7 +112,7 @@ npx @bovinphang/frontend-craft@latest list
 
 Claude Code ユーザーには、**Claude Code Marketplace** からの单一ソースでのインストールを推奨します。CLI を Claude 用に使うのは、クロスランタイムインストール、スクリプト/オフラインのファイルコピー、または非 Marketplace 環境の場合に限ってください。
 
-Marketplace が既にインストールされている場合、CLI は `--force` を付けても 2 つ目の Claude コピーをインストールまたはアップデートしません。代わりに Claude Code Marketplace からアップデートしてください。他のスコープに CLI 管理の Claude インストールが既に存在する場合、対話型ターミナルではそのソースを最新に保つか、アンインストールしてから切り替えるかを確認します。非対話型ターミナルでは停止し、実行すべき `update`、`uninstall`、`install` コマンドを正確に表示します。
+Marketplace が既にインストールされている場合、CLI は `--force` を付けても 2 つ目の Claude コピーをインストールまたはアップデートしません。代わりに Claude Code Marketplace からアップデートしてください。他のスコープに CLI 管理の Claude インストールが既に存在する場合、対話型ターミナルではそのソースを最新に保つか、アンインストールしてから切り替えるかを確認します。非対話型ターミナルでは停止し、実行すべき `runtime update`、`runtime uninstall`、`runtime install` コマンドを正確に表示します。
 
 完全な Claude 固有の手順は [docs/runtimes/claude.md](../runtimes/claude.md) · [简体中文](../runtimes/claude.zh-CN.md) にあります。
 
@@ -163,14 +166,31 @@ Marketplace が既にインストールされている場合、CLI は `--force`
 | コマンド              | 用途                                                                   | レポート                                             |
 | --------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------- |
 | `/fec-init`           | プロジェクトテンプレート（CLAUDE.md、ルール、設定）を初期化            | —                                                    |
-| `/fec-review`         | 指定または最近変更したファイルの構造化レビュー                         | `code-review-*.md`                                   |
+| `/fec-review`         | 既定はプロジェクト全体。ファイル・ディレクトリや変更範囲の明示も可能 | `code-review-*.md`                                   |
 | `/fec-scaffold`       | 規約に従い page / feature / component のボイラープレートを作成         | —                                                    |
 | `/fec-plan`           | 統合計画：実装アーキテクチャまたはテスト戦略                           | `architecture-proposal-*.md` または `test-plan-*.md` |
 | `/fec-tdd`            | 赤 → 緑 → リファクタリングのフロントエンド TDD ループ                  | —                                                    |
 | `/fec-debug`          | フロントエンド問題の診断と修復：ビルド、ランタイム、UI、API 障害       | `debug-*.md`                                         |
 | `/fec-refactor-clean` | デッドコード、未使用 export、スタイル、依存関係を分類して安全に削除    | `refactor-clean-*.md`                                |
+| `/fec-smell` | Diagnose code smells without editing | `refactoring/smell-*.md` |
+| `/fec-refactor-plan` | Plan behavior-preserving refactoring | `refactoring/plan-*.md` |
+| `/fec-refactor` | Execute validated behavior-preserving refactoring | `refactoring/refactoring-*.md` |
 | `/fec-doc-sync`       | README、docs、環境変数、スクリプト、API/ルート説明、デプロイ文書を同期 | —                                                    |
 
+### レビュー範囲
+
+`/fec-review`、コード / TypeScript / セキュリティのレビューエージェントとスキルは、次の3つのモードを使用します。
+
+- **変更レビュー**：最近の変更、今回の編集、ステージ済み変更、PR・コミットを明示的に指定した場合、または現在のタスクで変更範囲が明確な場合にレビューします。変更がなければその旨を報告し、最近のコミットに自動で切り替えません。
+- **指定範囲レビュー**：ファイルまたはディレクトリを指定し、未変更のコードもレビューします。Git の差分は不要です。
+- **プロジェクト全体レビュー（既定）**：範囲や変更の文脈を指定しない場合、または全体を依頼した場合、プロジェクト所有のフロントエンドコード、関連テスト、設定、依存関係の宣言を一覧化し、モジュールごとにレビューします。
+
+ファイル・ディレクトリの指定は全内容のレビューです。変更のみを確認する場合は明示してください。変更があっても `/fec-review` 単独は全体レビューです。開始時にモードと範囲を示し、編集後の自動委任には今回の変更範囲を明示します。
+
+例：`/fec-review`、`/fec-review 最近の変更をレビュー`、`/fec-review src/components/Button.tsx をレビュー`、`/fec-review src/features/ をレビュー`、`/fec-review プロジェクト全体をレビュー`。これは自然言語の指示であり、CLI オプションではありません。明示された範囲を優先します。
+
+依存関係のディレクトリ、ビルド成果物、キャッシュ、生成ファイル、第三者コードは既定で除外します。レポートにはモード、対象範囲、レビュー済み・未レビューのファイルやモジュール、除外項目、完了状態、検証結果を記録します。未完了なら部分完了と明記します。呼び出し元の参照や全体の lint・型チェックは手動レビューの完了を意味しません。変更レビューはマージ判断、指定範囲・全体レビューは確認済み範囲のリスク評価を示します。バックエンド監査を代替せず、修正の依頼がなければ業務コードを変更しません。
+
 ### スキル（自動起動）
 
 スキルはファイルパターン、フレームワーク、タスクコンテキストに基づいて**自動起動**するワークフロー定義です。レビュー観点、出力規約、レポート形式をエンコードしています。
@@ -187,7 +207,7 @@ Marketplace が既にインストールされている場合、CLI は `--force`
 | `fec-nuxt-project-standard`       | Nuxt 3 SSR/SSG、Composition API、データ取得、ミドルウェア               |
 | `fec-vite-project-standard`       | Vite 設定、環境変数安全性、HMR、開発プロキシ、ビルド最適化              |
 | `fec-monorepo-project-standard`   | pnpm workspace、Turborepo、Nx の構造とタスクオーケストレーション        |
-| `fec-typescript-project-standard` | TypeScript 設定、公開 API 型、宣言ファイル、DTO、ジェネリクス           |
+| `cc-typescript-project-standard` | TypeScript 設定、公開 API 型、宣言ファイル、DTO、ジェネリクス           |
 
 **実装機能** — 特定のフロントエンド機能を構築する際に起動：
 
@@ -227,13 +247,29 @@ Marketplace が既にインストールされている場合、CLI は `--force`
 | `fec-performance-optimization` | Core Web Vitals、バンドル、レンダリング、メモリ、ネットワーク、予算レビュー   |
 | `fec-refactor-clean`           | デッドコード、未使用 export、スタイル、ルート、依存関係の安全なクリーンアップ |
 
+**Refactoring**
+
+| Skill | Scope |
+| --- | --- |
+| `fec-refactoring` | Behavior-preserving refactoring capability |
+| `fec-code-smells` | Behavior-preserving refactoring capability |
+| `fec-refactoring-catalog` | Behavior-preserving refactoring capability |
+| `fec-refactoring-functions` | Behavior-preserving refactoring capability |
+| `fec-refactoring-encapsulation` | Behavior-preserving refactoring capability |
+| `fec-refactoring-move-features` | Behavior-preserving refactoring capability |
+| `fec-refactoring-data` | Behavior-preserving refactoring capability |
+| `fec-refactoring-control` | Behavior-preserving refactoring capability |
+| `fec-refactoring-api` | Behavior-preserving refactoring capability |
+| `fec-refactoring-inheritance` | Behavior-preserving refactoring capability |
+| `fec-refactoring-validation` | Behavior-preserving refactoring capability |
+
 **デザイン UI** — デザイン実装、デザインシステム、視覚仕上げで起動：
 
 | スキル                        | 範囲                                                                                                             |
 | ----------------------------- | ---------------------------------------------------------------------------------------------------------------- |
 | `fec-ui-design`               | プロダクト文脈に沿った UI 方向性、反テンプレート設計ダイヤル、メディア戦略、状態、ビジュアル QA                  |
-| `fec-image-generation`        | システムブループリント、プロセスワークフロー、インタラクティブなライブ図、HTML/SVG/PNG エクスポート、画像生成/編集、ビジュアルアセット、PNG QA |
-| `fec-drawio-studio`           | 編集可能な draw.io / diagrams.net 技術図、XML/Mermaid/CSV URL 受け渡し、shape 検索、自動レイアウト、コード構造図 |
+| `fec-image-generation`        | UI・製品・ブランド画像の生成と編集、共通 PNG 品質チェック |
+| `cc-drawio-studio`           | 編集可能な draw.io / diagrams.net 技術図、XML/Mermaid/CSV URL 受け渡し、shape 検索、自動レイアウト、コード構造図 |
 | `fec-web-video-presentation`  | 記事、台本、レッスン、demo から録画可能な 16:9 step-driven Web プレゼンを作成                                    |
 | `fec-tailwind-design-system`  | Tailwind token、テーマ拡張、variants、class 管理、ダークモード                                                   |
 | `fec-responsive-layout`       | モバイルファースト、container queries、データ密集 responsive UI                                                  |
@@ -241,6 +277,10 @@ Marketplace が既にインストールされている場合、CLI は `--force`
 | `fec-implement-from-design`   | デザインツール、スクリーンショット、または section 単位のビジュアル参照から UI を実装                            |
 | `fec-storybook-component-doc` | Storybook コンポーネント文書、デザインシステム表示、隔離状態プレビュー                                           |
 
+技術図の品質: 標準のシーケンス図とフローチャートはローカル Mermaid、編集可能な構成図は draw.io を優先します。ツールがない場合は JSON/HTML を使用します。PNG と同じ倍率の実測 manifest で QA を実行し、最終画像を目視確認します。修正は原則 2 回までで、未解決の問題を報告します。
+
+[レビューと技術図のガイド](../review-and-diagram-workflows.md).
+
 **レガシー移行** — モダナイゼーション時に起動：
 
 | スキル                           | 範囲                                                                           |
@@ -260,7 +300,7 @@ Marketplace が既にインストールされている場合、CLI は `--force`
 | ---------------------------------- | --------------------------------------------------------------------------------------- |
 | `fec-backend-requirements-handoff` | Frontend-to-backend handoff for UI data needs, actions, states, rules, and questions    |
 | `fec-doc-sync`                     | フロントエンド文書をコード、設定、スクリプト、ルート、API、環境変数、デプロイ事実と同期 |
-| `fec-source-driven-development`    | プロジェクト事実と公式ソースでバージョン依存の判断を検証                                |
+| `cc-source-driven-development`    | プロジェクト事実と公式ソースでバージョン依存の判断を検証                                |
 
 ### エージェント
 
@@ -276,6 +316,7 @@ Marketplace が既にインストールされている場合、CLI は `--force`
 | `fec-test-planner`          | リスク→階層マトリクス：静的、ユニット、コンポーネント、E2E、視覚、a11y、セキュリティ | `test-plan-*.md`             |
 | `fec-debugger`              | ビルド、ランタイム、UI、API 障害の複雑なフロントエンド診断                           | `debug-*.md`                 |
 | `fec-refactor-cleaner`      | 未使用コード、export、スタイル、ルート、依存関係の分類と安全な削除                   | `refactor-clean-*.md`        |
+| `fec-refactoring-expert` | Behavior-preserving refactoring orchestration | `refactoring/refactoring-*.md` |
 | `fec-e2e-runner`            | E2E 作成と実行（Playwright/Cypress）、flaky 隔離、トレース                           | `e2e-summary-*.md`           |
 | `fec-doc-updater`           | README、ランタイムドキュメント、構造、機能表、メタデータの同期                       | —                            |
 | `fec-ui-checker`            | 視覚的問題のデバッグとデザイン忠実度評価                                             | `ui-fidelity-review-*.md`    |
@@ -419,33 +460,55 @@ $env:MODAO_TOKEN = "your-modao-token"
 
 ## アップデートと削除
 
-`fec` は `frontend-craft` の短いコマンドです。グローバルの `fec` コマンドをインストールしていない場合は、同じ引数を `npx @bovinphang/frontend-craft@latest` に渡してください。例：`npx @bovinphang/frontend-craft@latest update`。
+### CLI 自体の管理（3.0）
 
-### アップデート
+`fec update`（別名 `upgrade`）は元の npm/pnpm と registry の `latest` でグローバル CLI を更新し、新しい CLI で現在のプロジェクトとユーザー全体の管理リソースを更新します。最新版でもリソースを更新します。他のプロジェクトの走査や Marketplace の管理は行いません。CLI 更新失敗時は停止し、リソースの部分失敗は段階別に報告します。CLI はロールバックせず、`fec runtime update` で再試行できます。
+
+`fec uninstall`（別名 `remove`）は既定で CLI だけを削除します。`--purge` は先に管理リソースを削除し、ユーザーの変更を保持します。削除処理が失敗すると CLI を保持します。対話端末では確認し、非対話実行では `--yes` が必要です。検証済みの npm/pnpm registry グローバルインストールのみ対応します。ソースリンク、プロジェクト依存、未知の配布元、他のパッケージを含む pnpm 共有グループは変更前に拒否します。共有グループは元のパッケージマネージャーで手動管理してください。`--dry-run` は読み取り専用で、インストール、削除、後続更新を実行しません。
+
+```bash
+fec update
+fec uninstall --dry-run
+fec uninstall --purge --yes
+```
+
+一時的な npx 実行ではグローバル CLI を作成せず、CLI の削除もできません。npx のトップレベル `update` は実行中のバージョンが registry の `latest` と一致する場合のみリソースを更新します。一致しなければ `npx @bovinphang/frontend-craft@latest runtime update` を使用してください。
+
+| 2.x リソースコマンド | 3.0 の代替 |
+| --- | --- |
+| `fec update [runtime] [options]` | `fec runtime update [runtime] [options]` |
+| `fec uninstall [runtime] [options]` | `fec runtime uninstall [runtime] [options]` |
+| `fec install [runtime] [options]` | `fec runtime install [runtime] [options]` |
+
+トップレベル update/uninstall は旧 runtime 引数と `--global` などのリソースオプションを変更前に拒否します。`setup` は継続し、トップレベル `install` は非推奨の互換エイリアスです。リソースオプションと `runtime upgrade/remove` の別名は維持されます。`runtime update` は実行中の CLI パッケージのみを使用し、新しいパッケージをネットから取得しません。
+
+`fec` は `frontend-craft` の短いコマンドです。グローバル CLI がない場合、リソース操作には `npx @bovinphang/frontend-craft@latest runtime update`（または `runtime install/uninstall`）を使用してください。
+
+### リソースのアップデート
 
 ```bash
-fec update                         # 検出された CLI 管理インストールをすべてアップデート
-fec update <runtime> --local        # ローカルの CLI 管理インストールを 1 つアップデート
-fec update <runtime> --global       # グローバルの CLI 管理インストールを 1 つアップデート
-fec upgrade <runtime> --global      # `upgrade` は `update` のエイリアス
+fec runtime update                              # 検出された CLI 管理インストールをすべてアップデート
+fec runtime update <runtime> --local            # ローカルの CLI 管理インストールを 1 つアップデート
+fec runtime update <runtime> --global           # グローバルの CLI 管理インストールを 1 つアップデート
+fec runtime upgrade <runtime> --global          # `upgrade` は `update` のエイリアス
 ```
 
-### 削除
+### リソースの削除
 
 ```bash
-fec uninstall                       # 検出された CLI 管理インストールをすべて削除
-fec remove                          # `remove` は `uninstall` のエイリアス
-fec uninstall <runtime>             # 指定 runtime のインストールを削除
-fec remove <runtime>                # エイリアスで指定 runtime を削除
-fec uninstall --global              # 検出されたグローバルインストールだけを削除
-fec remove --local                  # 検出されたローカルインストールだけを削除
-fec uninstall <runtime> --dry-run   # 削除内容をプレビュー
-fec uninstall <runtime> --force     # 変更済みの管理ファイルも削除
+fec runtime uninstall                           # 検出された CLI 管理インストールをすべて削除
+fec runtime remove                              # `remove` は `uninstall` のエイリアス
+fec runtime uninstall <runtime>                 # 指定 runtime のインストールを削除
+fec runtime remove <runtime>                    # エイリアスで指定 runtime を削除
+fec runtime uninstall --global                  # 検出されたグローバルインストールだけを削除
+fec runtime remove --local                      # 検出されたローカルインストールだけを削除
+fec runtime uninstall <runtime> --dry-run       # 削除内容をプレビュー
+fec runtime uninstall <runtime> --force         # 変更済みの管理ファイルも削除
 ```
 
-CLI はランタイムディレクトリに `frontend-craft.manifest.json` を書き込みます。runtime を指定しない場合、`update` はこれらの manifest を自動検出し、**ローカルで修正したファイルをスキップ**します——カスタマイズはアップデート後も保持されます。
+CLI はランタイムディレクトリに `frontend-craft.manifest.json` を書き込みます。runtime を指定しない場合、`runtime update` はこれらの manifest を自動検出し、**ローカルで修正したファイルをスキップ**します——カスタマイズはアップデート後も保持されます。
 
-`uninstall`/`remove` は manifest に記録されたファイルだけを削除します。変更済みファイルは既定でスキップされます。変更済みの管理ファイルも削除したい場合のみ `--force` を追加してください。`--force` は Claude Code Marketplace インストールを上書きしません。
+`runtime uninstall`/`runtime remove` は manifest に記録されたファイルだけを削除します。変更済みファイルは既定でスキップされます。変更済みの管理ファイルも削除したい場合のみ `--force` を追加してください。`--force` は Claude Code Marketplace インストールを上書きしません。
 
 **Claude Code Marketplace** または **submodule** インストールのアップデート方法は [docs/runtimes/claude.md](../runtimes/claude.md) · [简体中文](../runtimes/claude.zh-CN.md) を参照してください。`/fec-init` はプロジェクト設定を初期化するだけであり、2 回目のプラグインインストールではありません。
 
@@ -491,3 +554,35 @@ npx skills check                           # 利用可能なアップデート
 **frontend-craft がチームの助けになったら、[Star をお願いします](https://github.com/bovinphang/frontend-craft)。**
 
 </div>
+
+## 3.0 の共通機能
+
+3.0.0は未公開のままです。フロントエンド専用53個と共通21個、合計74個のSkillを提供します。共通依存は`@bovinphang/craft-common@2.0.0`に固定します。2.0.0は公開準備中の正式バージョンで、backend1.0.0も未公開です。commonを先に公開・検証し、製品バージョンを変更したり自動公開したりしません。
+
+言語・役割・フレームワークを別々に選びます。C/C++には独立した入口があり、Tauri/Electronは共通のデスクトップ専門機能です。製品名で言語を制限しません。
+
+- `cc-c-project-standard`
+- `cc-cpp-project-standard`
+- `cc-debug-methodology`
+- `cc-doc-sync-core`
+- `cc-drawio-studio`
+- `cc-electron-project-standard`
+- `cc-go-concurrency`
+- `cc-go-project-standard`
+- `cc-java-project-standard`
+- `cc-java-runtime`
+- `cc-native-memory-safety`
+- `cc-python-async`
+- `cc-python-project-standard`
+- `cc-refactoring-core`
+- `cc-rust-async`
+- `cc-rust-project-standard`
+- `cc-source-driven-development`
+- `cc-tauri-project-standard`
+- `cc-tdd-methodology`
+- `cc-technical-diagrams`
+- `cc-typescript-project-standard`
+
+`fec runtime check-migration codex --local --json`を実行し、旧CLIで旧共通参照を解除して保存された編集を処理してから、一致する製品を導入します。別の利用者や不明なファイルを強制上書きしません。CLIとネイティブ配布は排他的で、二製品のネイティブ重複排除は保証しません。
+
+[移行](../common-migration.md) · [変更履歴](../../CHANGELOG.md) · [構成](../project-structure.md)