プロジェクトドキュメント整備（docs/ ディレクトリ）

[ktmage]

Description

プロジェクト全体のドキュメントが不足しているため、リポジトリ内に docs/ ディレクトリを設け、体系的にドキュメントを整備する。

現在、外部仕様書・内部仕様書は .ktmage/project/ 配下に非公開で管理されているが、これらを docs/ に統合して公開する。既存ファイルの単純移行ではなく、各機能を改めて確認した上で新規作成する。

対象ドキュメントと docs/ 構成

docs/
  README.md                           # ドキュメント索引
  architecture/
    overview.md                       # 全体アーキテクチャ（軽めに。今後大きく変わる前提）
  design/
    component-guide.md                # Atomic Design 方針・コンポーネント責務
  testing/
    strategy.md                       # テスト戦略・テストの書き方・命名規則
  operations/
    release.md                        # リリース手順
  specs/
    external/                         # 外部仕様書（機能要件）— 新規作成
      index.md
    internal/                         # 内部仕様書（技術設計）— 新規作成
      index.md

タスク一覧

#	タスク	概要
1	docs/ ディレクトリ作成・索引整備	docs/README.md でドキュメント全体の索引を作成
2	アーキテクチャ概要の新規作成	Extension Host / Webview の2層構成、責務分担を軽く記述。今後大きく変わる前提で簡潔に
3	コンポーネント設計ガイドの新規作成	Atomic Design の方針と各層（atoms/molecules/organisms）の責務を記述
4	テスト戦略ガイドの新規作成	テスト種別（シナリオ/コンポーネント/フック/ユーティリティ）の使い分け、命名規則、書き方の指針
5	リリース手順の移行	.ktmage/project/release-procedure.md を docs/operations/release.md に移行
6	外部仕様書の新規作成	各機能を改めて確認し、docs/specs/external/ に新規作成（既存の .ktmage/project/external-spec/ からの単純移行ではない）
7	内部仕様書の新規作成	各機能を改めて確認し、docs/specs/internal/ に新規作成（既存の .ktmage/project/internal-spec/ からの単純移行ではない）
8	.ktmage/ のスキル・設定更新	仕様書の参照先パスを docs/specs/ に変更（config.yml, manage-external-spec, manage-internal-spec）
9	README.md のドキュメントセクション更新	docs/ へのリンクを追加

注意事項

• ドキュメントの言語は日本語
• アーキテクチャ概要は今後大きく変更される可能性があるため、軽めの記述に留める
• 外部仕様書・内部仕様書は既存ファイルの移行ではなく、機能を改めて確認した上で新規作成する
• .ktmage/project/ 内のタスク定義書・議事録など Issue 単位の作業記録はそのまま残す

Motivation

• プロジェクトの設計思想やテスト方針がコードを読まないとわからない状態になっている
• 外部仕様書・内部仕様書が .ktmage/project/ に非公開で置かれており、コントリビューターからは見えない
• アーキテクチャ、コンポーネント設計、テスト戦略、リリース手順など、開発に必要な情報が散在している
• 体系的なドキュメントを整備することで、メンテナー自身の参照用としても、コントリビューターのオンボーディングとしても機能させたい

Proposed Solution

リポジトリルートに docs/ ディレクトリを作成し、上記の構成でドキュメントを整備する。タスク一覧の順序で段階的に作成していく。

[ktmage]

色々やっています。

[ktmage]

コードベースの整備と一緒にやる。