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によるラッピング、ケバブケースのコンポーネント
ポインター	ガイドコードのパス、品質検証コマンド、共通コンポーネントのパス（_common/components/）

削除する項目：

• ガイドコードから推測できる内容 → ガイドコードへのポインターに置き換え
• リンター（ESLint）で検出できるルール
• コード例 → ファイルパスの参照1行に置き換え
• 共通コンポーネントの全一覧 → _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行の範囲に収まっている
• プロジェクト固有の指針が保持されている

追加：

• Mockモードの原則がAGENTS.mdに明記されている
• 技術スタック（Vue 3/Pinia/NuxtUI v4/TailwindCSS v4）が正確に反映されている
• referencesの構成が正しい（01、02、03、04）
• cursor rulesが削除されている（存在していた場合）