# Issue管理ワークフロー (Issue Management Workflow)

このリポジトリにおける Issue の管理および同期に関する運用ルールです。

## 1. 外部トラッカーとの同期

本プロジェクトでは、上流の Issue トラッカー (GitHub 互換 API) とローカルの Markdown ファイルを同期させて開発を進めます。

- **同期方向**: 原則として上流の Issue トラッカーが正（Source of Truth）です。
- **自動同期**: `node tools/scripts/sync_issues.mjs` を実行して、リモートの最新状態を `docs/issues/` に反映、またはローカルの新規 Issue をリモートに作成します。
- **Git追跡除外**: `docs/issues/` は `.gitignore` により Git 追跡から除外されています。

## 2. 記述規約

- **日英併記の義務化**:
  - すべての Issue は**日本語と英語を併記**しなければなりません。
  - 片方の言語だけで記述されている場合は、不足している言語の翻訳を補完してください。

## 3. クローズとクリーンアップ

- **手動クローズ**:
  - トラッカー API の制約により、スクリプトからの自動クローズは行いません。
  - 作業完了後、ローカル Markdown の `state` を `closed` にして同期スクリプトを実行すると、手動クローズ用のURLが表示されます。
- **ローカルの自動削除**:
  - 上流トラッカー側で `closed` になった Issue は、同期スクリプト実行時にローカルの Markdown ファイルが自動的に削除されます。
