@bovinphang/frontend-craft 2.5.0

package/docs/runtimes/claude.md

@@ -0,0 +1,171 @@
+# frontend-craft: Claude (Claude Code)
+
+Recommended path for most Claude Code users: install through **Claude Code Marketplace** so Claude Code is the single plugin loader.
+
+Use the CLI only when you need cross-runtime installation, offline/scripted file copies, or a non-Marketplace environment:
+
+```bash
+npx frontend-craft@latest install --local claude
+# or
+npx frontend-craft@latest install --global claude
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+
+Choose one active source of truth for the same Claude scope: Marketplace/native plugin, CLI install, or `--plugin-dir`. They can technically coexist, but running multiple complete copies in the same Claude session can duplicate commands, skills, agents, and hooks.
+
+The CLI enforces this for Marketplace installs: if Claude Code Marketplace already manages `frontend-craft`, `frontend-craft install/update claude` stops and tells you to update through Marketplace instead. `--force` does not override a Marketplace install.
+
+---
+
+## Claude Code Marketplace
+
+You can install `frontend-craft` as a Claude Code marketplace plugin. This loads the plugin natively inside Claude Code.
+
+---
+
+## Quick start after Marketplace install
+
+Get started in a few minutes:
+
+### Step 1: Install the plugin
+
+```bash
+# Add marketplace
+/plugin marketplace add bovinphang/frontend-craft
+
+# Install plugin
+/plugin install frontend-craft@bovinphang-frontend-craft
+
+# Activate
+/reload-plugins
+```
+
+### Step 2: Initialize project config (recommended)
+
+```bash
+# Copy project templates to .claude/ directory
+/fec-init
+```
+
+After initialization, customize for your project:
+
+1. `.claude/CLAUDE.md` — Update project info, package manager, common commands (source templates: `templates/claude/`; `/fec-init` copies into `.claude/`)
+2. `.claude/rules/` — Remove inapplicable rules (e.g. delete `fec-vue.md` for React-only projects, delete `fec-i18n.md` if i18n is not needed)
+3. `.claude/settings.json` — Adjust permission whitelist
+
+> **Why this step?** The plugin provides reusable Skills, Agents, and Hooks. CLAUDE.md and rules are project-level config and must live under the project root `.claude/` for Claude Code to recognize them. The `/fec-init` command helps you set this up quickly.
+>
+> `/fec-init` initializes project config; it is not a second plugin install. Keep the plugin body managed by Marketplace, CLI, or `--plugin-dir`, not more than one at once.
+
+### Step 3: Start using
+
+```bash
+# Code review (outputs to reports/code-review-*.md)
+/fec-review
+
+# Create page/feature/component by convention
+/fec-scaffold page UserDetail
+/fec-scaffold component DataTable
+
+# List available commands
+/plugin list frontend-craft@bovinphang-frontend-craft
+```
+
+You now have access to the bundled agents, skills, and commands (see the root README **Feature overview** for the current list).
+
+---
+
+## Alternate install paths (Claude Code only)
+
+> **Requirements:** Claude Code v1.0.33+, Node.js 22+, npm/pnpm/yarn.
+
+### Option 1: Install as plugin (recommended)
+
+Same as **Step 1: Install the plugin** under **Quick start after Marketplace install** above (add marketplace, install plugin, `/reload-plugins`). You can also skip typing those commands in chat and add the marketplace via `~/.claude/settings.json` or project `.claude/settings.json`:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "frontend-craft": {
+      "source": {
+        "source": "github",
+        "repo": "bovinphang/frontend-craft"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Team project-level auto-install
+
+Add the `extraKnownMarketplaces` config above to `.claude/settings.json` in the project root. Team members will be prompted to install when they trust the project directory.
+
+### Option 3: Local development / testing
+
+Clone the repo and load via `--plugin-dir` (no install, suitable for development and debugging):
+
+```bash
+git clone https://github.com/bovinphang/frontend-craft.git
+claude --plugin-dir ./frontend-craft
+```
+
+When using `--plugin-dir` for development, disable or avoid a Marketplace install of the same plugin in that session so you know which copy is running.
+
+### Option 4: Git Submodule (project-level sharing)
+
+```bash
+# Add as submodule in project root
+git submodule add https://github.com/bovinphang/frontend-craft.git .claude/plugins/frontend-craft
+
+git add .gitmodules .claude/plugins/frontend-craft
+git commit -m "feat: add frontend-craft as shared Claude Code plugin"
+```
+
+After cloning, team members run:
+
+```bash
+git submodule update --init --recursive
+```
+
+Then load with `--plugin-dir`:
+
+```bash
+claude --plugin-dir .claude/plugins/frontend-craft
+```
+
+---
+
+## Updating (Marketplace and submodule)
+
+For Marketplace installs, run in Claude Code:
+
+```text
+/plugin marketplace update bovinphang-frontend-craft
+```
+
+Or enable auto-update so Claude Code pulls the latest on each start:
+
+1. Run `/plugin` in Claude Code to open the plugin manager
+2. Switch to the **Marketplaces** tab
+3. Select `bovinphang-frontend-craft`
+4. Choose **Enable auto-update**
+
+> Third-party Marketplaces do not enable auto-update by default. After enabling, Claude Code will refresh Marketplace data and update installed plugins on each start.
+
+For Git submodule installs:
+
+```bash
+git submodule update --remote .claude/plugins/frontend-craft
+```
+
+**CLI installs:** re-run `npx frontend-craft@latest update claude --local` or `... --global` for the same scope, and read [CHANGELOG.md](../../CHANGELOG.md) for release notes. If Claude Code Marketplace is already installed, the CLI refuses Claude install/update and prints the Marketplace update path. If the opposite CLI scope is already installed, interactive terminals ask whether to keep that source updated or uninstall it before switching; non-interactive terminals print the exact commands to run.
+
+```bash
+npx frontend-craft@latest update claude --global
+npx frontend-craft@latest update claude --local
+```
+
+---
+
+**Other languages:** [简体中文](claude.zh-CN.md)

package/docs/runtimes/claude.zh-CN.md

@@ -0,0 +1,169 @@
+# frontend-craft：Claude（Claude Code）
+
+大多数 Claude Code 用户推荐走 **Claude Code Marketplace**，让 Claude Code 原生插件系统作为唯一加载来源。
+
+仅当你需要跨运行时安装、离线/脚本化复制文件，或处在非 Marketplace 环境时，再使用 CLI：
+
+```bash
+npx frontend-craft@latest install --local claude
+# 或
+npx frontend-craft@latest install --global claude
+```
+
+> **非交互场景：** 请加上 `--local` 或 `--global`，避免询问安装位置。交互与脚本行为说明见根目录 README **通用安装**。
+
+同一个 Claude 作用域请只选择一个激活来源：Marketplace/原生插件、CLI 安装或 `--plugin-dir`。它们技术上可以共存，但不推荐在同一个 Claude 会话里同时启用多份完整插件，否则 commands、skills、agents 与 hooks 可能重复。
+
+CLI 会对 Marketplace 安装执行单一来源保护：如果已经由 Claude Code Marketplace 管理 `frontend-craft`，`frontend-craft install/update claude` 会停止，并提示改用 Marketplace 更新。`--force` 不会覆盖 Marketplace 安装。
+
+---
+
+## Claude Code Marketplace
+
+仍可将 `frontend-craft` 作为 Claude Code 的 Marketplace 插件安装，由 Claude Code 原生加载插件。
+
+---
+
+## Marketplace 安装后的快速开始
+
+### 第一步：安装插件
+
+```bash
+# 添加市场
+/plugin marketplace add bovinphang/frontend-craft
+
+# 安装插件
+/plugin install frontend-craft@bovinphang-frontend-craft
+
+# 激活
+/reload-plugins
+```
+
+### 第二步：初始化项目配置（推荐）
+
+```bash
+# 将项目模板复制到当前项目的 .claude/ 目录
+/fec-init
+```
+
+初始化后请根据项目实际情况修改：
+
+1. `.claude/CLAUDE.md` — 修改项目基础信息、包管理器、常用命令（仓库内模板位于 `templates/claude/`，`/fec-init` 会复制到 `.claude/`）
+2. `.claude/rules/` — 删除不适用的规则文件（如纯 React 项目删除 `fec-vue.md`，不需要 i18n 的项目删除 `fec-i18n.md`）
+3. `.claude/settings.json` — 调整权限白名单
+
+> **为什么需要这一步？** 插件提供可复用的 Skills、Agents 和 Hooks；CLAUDE.md 与 rules 属于项目级配置，须位于项目根目录的 `.claude/` 下才能被 Claude Code 识别。`/fec-init` 用于快速完成该步骤。
+>
+> `/fec-init` 是项目配置初始化，不是第二次安装插件本体。插件本体请交给 Marketplace、CLI 或 `--plugin-dir` 其中之一管理。
+
+### 第三步：开始使用
+
+```bash
+# 代码评审（输出到 reports/code-review-*.md）
+/fec-review
+
+# 按规范创建页面/功能/组件
+/fec-scaffold page UserDetail
+/fec-scaffold component DataTable
+
+# 查看可用命令
+/plugin list frontend-craft@bovinphang-frontend-craft
+```
+
+具体 agents、skills、commands 清单见根目录 README **功能概览**。
+
+---
+
+## 其他安装方式（仅 Claude Code）
+
+> **要求：** Claude Code v1.0.33+，Node.js 22+，npm/pnpm/yarn。
+
+### 选项 1：作为插件安装（推荐）
+
+与上文 **「Marketplace 安装后的快速开始」** 中 **第一步：安装插件** 相同（添加市场、安装插件、`/reload-plugins`）。亦可不在对话里执行命令，直接写入 `~/.claude/settings.json` 或项目 `.claude/settings.json`：
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "frontend-craft": {
+      "source": {
+        "source": "github",
+        "repo": "bovinphang/frontend-craft"
+      }
+    }
+  }
+}
+```
+
+### 选项 2：团队项目级自动安装
+
+在项目根目录的 `.claude/settings.json` 中添加上述 `extraKnownMarketplaces` 配置，团队成员 trust 项目目录后会收到安装提示。
+
+### 选项 3：本地开发 / 测试
+
+克隆仓库后使用 `--plugin-dir` 加载（无需安装，适合开发调试）：
+
+```bash
+git clone https://github.com/bovinphang/frontend-craft.git
+claude --plugin-dir ./frontend-craft
+```
+
+使用 `--plugin-dir` 做开发调试时，请避免在同一会话里同时启用 Marketplace 版本，这样才能确定当前运行的是哪一份代码。
+
+### 选项 4：Git Submodule（项目内共享）
+
+```bash
+# 在项目根目录添加 submodule
+git submodule add https://github.com/bovinphang/frontend-craft.git .claude/plugins/frontend-craft
+
+git add .gitmodules .claude/plugins/frontend-craft
+git commit -m "feat: add frontend-craft as shared Claude Code plugin"
+```
+
+团队成员克隆后执行：
+
+```bash
+git submodule update --init --recursive
+```
+
+再使用 `--plugin-dir` 加载：
+
+```bash
+claude --plugin-dir .claude/plugins/frontend-craft
+```
+
+---
+
+## 更新（Marketplace 与 submodule）
+
+通过 Marketplace 安装的插件，在 Claude Code 中执行：
+
+```text
+/plugin marketplace update bovinphang-frontend-craft
+```
+
+或开启自动更新，每次启动 Claude Code 时拉取最新版本：
+
+1. 在 Claude Code 中执行 `/plugin` 打开插件管理器
+2. 切换到 **Marketplaces** 标签页
+3. 选中 `bovinphang-frontend-craft`
+4. 选择 **Enable auto-update**
+
+> 第三方 Marketplace 默认不开启自动更新。启用后，Claude Code 每次启动时会刷新 Marketplace 数据并更新已安装插件。
+
+若使用 Git submodule 安装：
+
+```bash
+git submodule update --remote .claude/plugins/frontend-craft
+```
+
+**CLI 安装：** 对同一作用域执行 `npx frontend-craft@latest update claude --local` 或 `... --global`，版本说明见 [CHANGELOG.zh-CN.md](../../CHANGELOG.zh-CN.md) 或 [CHANGELOG.md](../../CHANGELOG.md)。如果已经检测到 Claude Code Marketplace 安装，CLI 会拒绝 Claude install/update，并提示通过 Marketplace 更新。如果另一个 CLI 作用域已安装，交互式终端会询问是保持该来源并更新，还是卸载后切换；非交互终端会打印可执行命令。
+
+```bash
+npx frontend-craft@latest update claude --global
+npx frontend-craft@latest update claude --local
+```
+
+---
+
+**English:** [claude.md](claude.md)

package/docs/runtimes/cline.md

@@ -0,0 +1,10 @@
+# frontend-craft: cline
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install cline
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/codebuddy.md

@@ -0,0 +1,10 @@
+# frontend-craft: codebuddy
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install codebuddy
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/codex.md

@@ -0,0 +1,10 @@
+# frontend-craft: codex
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install codex
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/copilot.md

@@ -0,0 +1,10 @@
+# frontend-craft: copilot
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install copilot
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/cursor.md

@@ -0,0 +1,10 @@
+# frontend-craft: cursor
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install cursor
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/gemini.md

@@ -0,0 +1,10 @@
+# frontend-craft: gemini
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install gemini
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/kilo.md

@@ -0,0 +1,10 @@
+# frontend-craft: kilo
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install kilo
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/openclaw.md

@@ -0,0 +1,10 @@
+# frontend-craft: openclaw
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install openclaw
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/opencode.md

@@ -0,0 +1,10 @@
+# frontend-craft: opencode
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install opencode
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/qoder.md

@@ -0,0 +1,19 @@
+# frontend-craft: qoder
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install qoder
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. Local installs write to `.qoder/`; global installs write to `~/.qoder` or `QODER_CONFIG_DIR`.
+
+Installed assets:
+
+- `skills/` -> `.qoder/skills/`
+- `commands/` -> `.qoder/commands/`
+- `agents/` -> `.qoder/agents/`
+- shared rules -> `.qoder/rules/`
+- hook scripts -> `.qoder/hooks/`
+- hook configuration -> `.qoder/settings.json`
+

package/docs/runtimes/trae.md

@@ -0,0 +1,10 @@
+# frontend-craft: trae
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install trae
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+

package/docs/runtimes/windsurf.md

@@ -0,0 +1,10 @@
+# frontend-craft: windsurf
+
+See root README **Universal Install** and run:
+
+```bash
+npx frontend-craft install windsurf
+```
+
+> **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.
+