peach-setup-ui-proto

peach-setup-ui-proto — UI Proto 规约设置

根据规约系统设置目标项目的 CLAUDE.md 和 AGENTS.md。 CLAUDE.md 是 20 行以内的最简入口，AGENTS.md 是 70～90 行的核心规则。

角色

UI Proto 规约设置专家。 移除 CLAUDE.md 中与 AGENTS.md 重复的内容，并检查 AGENTS.md 的 4 个章节，发现缺失时予以补充。 删除 cursor rules。

---

前提条件

• 在目标项目根目录中运行（而非 peach-harness 本身）
• 必须是 Frontend-Only 结构（存在 src/modules*，且不存在 api/ 和 front/）
• 必须已安装 peach-harness 技能

---

工作流

Step 1：分析当前状态

检查以下内容：

# CLAUDE.md 존재 여부 + 내용
cat CLAUDE.md 2>/dev/null || echo "CLAUDE.md 없음"

# AGENTS.md 존재 여부 + 내용
cat AGENTS.md 2>/dev/null || echo "AGENTS.md 없음"

# 프로젝트 구조 감지
ls -d api/ front/ 2>/dev/null && echo "모노레포 구조 — peach-setup-harness 사용 권고" || echo "모노레포 아님"
ls -d src/modules*/ 2>/dev/null && echo "Frontend-Only UI Proto 프로젝트" || echo "src/modules*/ 없음"

# 모듈 루트 감지
ls -d src/modules*/ 2>/dev/null

# 디자인 시스템 감지
ls src/**/theme.css 2>/dev/null && echo "디자인 시스템 존재" || echo "theme.css 없음"

# cursor rules 존재 여부
ls .cursor/rules/ 2>/dev/null && echo "root cursor rules 존재" || echo "root cursor rules 없음"
ls .cursorrules 2>/dev/null && echo ".cursorrules 존재" || echo ".cursorrules 없음"

整理分析结果：

• CLAUDE.md：是否存在、当前行数、与 AGENTS.md 重复的章节列表
• AGENTS.md：是否存在、是否包含 4 个章节
• 项目类型：确认是 Frontend-Only（src/modules*）
• 模块根目录：使用 ls -d src/modules*/ 的结果作为 {모듈구조}
• 设计系统：theme.css 是否存在
• cursor rules：是否存在及文件列表

Step 2：检查 AGENTS.md 的 4 个章节

如果 AGENTS.md 存在，检查是否包含以下 4 个章节：

grep -l "공통 원칙\|_common.*import" AGENTS.md 2>/dev/null && echo "§1.공통원칙 존재" || echo "§1.공통원칙 누락"
grep -l "프론트엔드 규칙\|computed" AGENTS.md 2>/dev/null && echo "§2.프론트엔드 존재" || echo "§2.프론트엔드 누락"
grep -l "테스트\|test:run\|vue-tsc" AGENTS.md 2>/dev/null && echo "§3.테스트 존재" || echo "§3.테스트 누락"
grep -l "Bounded Autonomy\|Must Follow" AGENTS.md 2>/dev/null && echo "§4.BA 존재" || echo "§4.BA 누락"

发现缺失章节时，使用以下 references 作为来源：

章节	源文件
1. 通用原则	peach-setup-ui-proto/references/01-common.md
2. 前端规则	peach-setup-ui-proto/references/02-frontend.md
3. 测试与质量	peach-setup-ui-proto/references/03-testing.md
4. Bounded Autonomy	peach-setup-ui-proto/references/04-bounded-autonomy.md

记录缺失的章节列表。

Step 3：生成变更计划

向用户说明变更计划：

CLAUDE.md 变更：

• 要删除的重复章节（AGENTS.md 中已有的内容）
• 最终预计行数

AGENTS.md 变更：

• 缺失章节列表及要添加内容的摘要
• 确认包含全部 4 个章节
• 要从现有 AGENTS.md 中删除的过时操作章节（技能、屏幕类型、组件目录、规划师工作流）

删除 cursor rules（如果存在）：

• 要删除的文件／目录列表
• 删除原因：“基于基本指引（AGENTS.md）和技能库开展工作。不再使用 cursor rules”

Step 4：征求用户确认

征求用户对变更计划的同意。如果用户要求修改，则予以调整。

Step 5：应用变更

获得批准后应用变更：

1. 整理 CLAUDE.md

   • 移除与 AGENTS.md 重复的章节
   • 保留项目专属指引（设计系统、特殊设置等）
   • 控制在 20 行以内

2. 创建或更新 AGENTS.md

   • 组合各章节的 references，构成 4 个章节
   • 不存在 AGENTS.md → 组合 4 个 references 并创建完整文件
   • 存在 AGENTS.md → 仅从 references 中提取缺失／不一致的章节并添加／修改
   • 删除现有 AGENTS.md 中过时的操作章节
   • 将 {모듈구조} 替换为 ls -d src/modules*/ 的结果

3. 删除 cursor rules（如果存在）

   • 删除根目录下的 .cursor/rules/ 目录
   • 删除根目录下的 .cursorrules 文件

Step 6：确认完成情况

输出应用结果：

• CLAUDE.md 变更前后的行数
• AGENTS.md 新增／更新的章节列表
• 从 AGENTS.md 中删除的过时操作章节列表
• 删除的 cursor rules 文件列表

---

AGENTS.md 精简原则

新建或补充 AGENTS.md 时，应用以下原则。

核心：“只保留指南代码无法说明的内容。” 不必单独考虑未使用技能的情况。

保留（4 类）：

类别	内容
禁止事项	仅导入 _common，禁止为领域核心类型设置不必要的可选／null／undefined，禁止使用 isLoading
设计理念	Mock 模式原则、完全独立的领域、通过 Store 调用 API
约定	4 种命名方式（snake_case/kebab-case/PascalCase/camelCase）、Pinia Option API、用 computed 包装、组件使用 kebab-case
指引	指南代码路径、质量验证命令、通用组件路径（_common/components/）

删除：

• 可从指南代码推断的内容 → 替换为指南代码指引
• 可由 Linter（ESLint）检查的规则
• 代码示例 → 替换为仅含 文件路径引用 的一行
• 通用组件完整列表 → 替换为 _common/components/ 路径指引

**目标大小：**70～90 行

---

CLAUDE.md 标准模板

按以下格式整理目标项目的 CLAUDE.md。 保留项目专属指引作为独立章节。

# {프로젝트명}

{한 줄 설명}

## 규칙 참조

모든 개발 규칙은 @AGENTS.md 를 참조하라.

## 세션 시작

`git status && git branch`로 현재 상태를 확인하세요.

## 가이드 코드

코드 생성 = **가이드 코드 참조** → 도메인 분석 → Bounded Autonomy 범위 내 적응
- Frontend: `src/modules/test-data/`

核心原则

• CLAUDE.md 控制在 20 行以内
• 删除与 AGENTS.md 重复的章节（如“编码规则”“前端指引”等）
• 保留项目专属指引（设计系统、特殊环境变量等）作为独立章节

---

完成条件检查清单

基本项：

• CLAUDE.md 已整理至 20 行以内
• 已从 CLAUDE.md 中删除与 AGENTS.md 重复的内容
• AGENTS.md 由 4 个章节（通用、前端、测试、BA）构成
• AGENTS.md 位于 70～90 行范围内
• 项目专属指引已保留

附加项：

• AGENTS.md 中已注明 Mock 模式原则
• 技术栈（Vue 3/Pinia/NuxtUI v4/TailwindCSS v4）已准确反映
• references 结构正确（01、02、03、04）
• cursor rules 已删除（若之前存在）