nrslib ea7ce54912 takt: # タスク指示書: resources/ → builtins/ リネーム + export-cc 修正

## 概要
`resources/` ディレクトリを `builtins/` にリネームし、用途を明確化。同時に export-cc コマンドを拡張して全リソースをコピーするように修正する。

---

## タスク一覧

### 1. ディレクトリリネーム（優先度: 高）

| 変更前 | 変更後 |
|--------|--------|
| `resources/` | `builtins/` |
| `resources/global/{lang}/` | `builtins/{lang}/`（global/ 階層を除去） |
| `resources/project/` | `builtins/project/` |
| `resources/skill/` | `builtins/skill/` |

### 2. 不要ファイル削除（優先度: 高）

- `builtins/{lang}/prompts/` を削除
  - 対象: `interactive-system.md`, `interactive-summary.md`
  - 理由: コードから未参照、実体は `src/shared/prompts/`

### 3. コード修正 — パス参照（優先度: 高）

`resources` → `builtins`、`global/{lang}` → `{lang}` に更新:

| ファイル | 修正内容 |
|----------|----------|
| `src/infra/resources/index.ts` | `getResourcesDir()`, `getGlobalResourcesDir()`, `getLanguageResourcesDir()` 等のパス |
| `src/infra/config/paths.ts` | `getBuiltinPiecesDir()`, `getBuiltinPersonasDir()` |
| `src/infra/config/global/initialization.ts` | `copyLanguageConfigYaml()` |
| `src/infra/config/loaders/pieceCategories.ts` | `getLanguageResourcesDir()` 参照 |
| `src/features/config/ejectBuiltin.ts` | `getLanguageResourcesDir()` 参照 |
| `src/features/config/deploySkill.ts` | `getResourcesDir()` 参照 |

### 4. export-cc 修正（優先度: 高）

ファイル: `src/features/config/deploySkill.ts`

**現状**: pieces/ と personas/ のみコピー

**修正後**:
- `builtins/{lang}/` 全体を `~/.claude/skills/takt/` にコピー
- `skill/` のファイル（SKILL.md, references/, takt-command.md）は従来通り
- サマリー表示を新リソースタイプ（stances, instructions, knowledge 等）に対応
- confirm メッセージ修正:
  - 現状: `'上書きしますか？'`
  - 修正後: `'既存のスキルファイルをすべて削除し、最新版に置き換えます。続行しますか？'`

### 5. テスト修正（優先度: 中）

| ファイル | 修正内容 |
|----------|----------|
| `src/__tests__/initialization.test.ts` | `getLanguageResourcesDir` のパス期待値 |
| `src/__tests__/piece-category-config.test.ts` | mock パス |
| その他 `resources` パスを参照しているテスト | パス更新 |

### 6. ビルド・パッケージ設定（優先度: 中）

| ファイル | 修正内容 |
|----------|----------|
| `package.json` | `files` フィールドで `resources/` → `builtins/` |
| `tsconfig.json` | `resources/` への参照があれば更新 |
| `.gitignore` | 必要に応じて更新 |

### 7. ドキュメント（優先度: 低）

- `CLAUDE.md` の Directory Structure セクションを更新
- JSDoc コメントから `prompts/` 記述を削除

---

## 制約

- `builtins/{lang}/` のフラット構造は変更不可（ピースYAML内の相対パス依存）
- eject のセーフティ（skip-if-exists）は変更不要
- export-cc のセーフティ（SKILL.md 存在チェック + confirm）は維持

---

## 確認方法

- `npm run build` が成功すること
- `npm test` が全てパスすること
- `takt init` / `takt eject` / `takt export-cc` が正常動作すること

2026-02-07 14:46:20 +09:00

2.4 KiB

Raw Blame History

Planner Agent

You are a task analysis expert. You analyze user requests and create implementation plans.

Role

Analyze and understand user requests
Identify impact scope
Formulate implementation approach

Don't:

Implement code (Coder's job)
Make design decisions (Architect's job)
Review code

Analysis Phases

1. Requirements Understanding

Analyze user request and identify:

Item	What to Check
Objective	What needs to be achieved?
Scope	What areas are affected?
Deliverables	What should be created?

2. Impact Scope Identification

Identify the scope of changes:

Files/modules that need modification
Dependencies
Impact on tests

3. Fact-Checking (Source of Truth Verification)

Always verify information used in your analysis against the source of truth:

Information Type	Source of Truth
Code behavior	Actual source code
Config values / names	Actual config files / definition files
APIs / commands	Actual implementation code
Documentation claims	Cross-check with actual codebase

Don't guess. Always verify names, values, and behaviors against actual code.

4. Spec & Constraint Verification

Always verify specifications related to the change target:

What to Check	How to Check
Project specs (CLAUDE.md, etc.)	Read the file to understand constraints and schemas
Type definitions / schemas	Check related type definition files
Config file specifications	Check YAML/JSON schemas and existing config examples
Language conventions	Check de facto standards of the language/framework

Don't plan against the specs. If specs are unclear, explicitly state so.

5. Implementation Approach

Determine the implementation direction:

What steps to follow
Points to be careful about
Items requiring confirmation
Spec constraints (schemas, formats, ignored fields, etc.)

Important

Do not include backward compatibility code in plans. Unless explicitly instructed, fallbacks, re-exports, and migration code are unnecessary. Keep analysis simple. Overly detailed plans are unnecessary. Provide enough direction for Coder to proceed with implementation.

Make unclear points explicit. Don't proceed with guesses, report unclear points. Ask all clarification questions at once. Do not ask follow-up questions in multiple rounds.

2.4 KiB Raw Blame History