turntuptechnologies-ai README 整備（write-readme）
プロジェクトの README を、チームで実証済みの構成で作成・標準化する。リポ間のバラつきを解消し、公開しても通用する品質にする。
構成（標準セクション）
同梱の README.template.md をベースにする。順序と意図は以下。
- タイトル + 一文要約 — 何をするものか。バッジ（CI/license）があれば直下。
- 概要 / What it does — 主要機能・使いどころを箇条書き。
- 技術構成 / Stack — 言語・フレームワーク・データストア。
- クイックスタート / Quick start — clone → install → 起動 をコピペで動くコマンドで。前提条件も。
- 設定 / Configuration — 環境変数・設定キー（実値は書かず
.env.exampleを案内）。 - 構成 / Layout — 迷いやすいディレクトリの役割。
- ドキュメント / Documentation —
docs/配下への索引。 - 開発 / Development — lint/test/build コマンド、開発フローへの言及。
- ライセンス / License。
手順
- 事実を集める —
package.json/pyproject.toml等の scripts・依存、.env.example、ディレクトリ構成、CLI/エントリポイントを読み、記載の根拠を実装から取る。 - テンプレを埋める —
README.template.mdをコピーし、当てはまらないセクションは削除、必要なら足す。 - コマンドを検証する — Quick start / Development のコマンドが実際に通るか確認する（少なくとも scripts に存在するか裏取り）。
- 既存 README がある場合 — 構成をこのテンプレに寄せつつ、既にある正確な記述は活かす。全消し再生成はしない。
ルール・コツ
- 言語・見出しはリポジトリの慣習に合わせる。 public OSS は英語、社内向けは日本語、など。テンプレの
概要 / What it does形式の併記は適宜どちらかに寄せる。 - 推測で書かない。 動かないコマンド・存在しないオプションを書かない。確認できないものは実行/参照して裏を取る。
- コピペで動くことを最優先（特に Quick start）。前提（ランタイム/バージョン/外部サービス）を省かない。
- 秘密情報・固有情報を書かない（→ no-secrets ルール）。設定値は
.env.exampleを案内。 - 新規プロジェクトの初期 README は
new-project-initが用意する。本 Skill はそれを充実させる/既存を整える役。 - 書いた後の実装との追従ズレ点検は
doc-syncに任せる。
完了条件
以下を全て満たしたら完了。満たせない項目があれば、黙って省略せず理由を報告する。
- 記載した全コマンド・依存・設定キーを実装（scripts / pyproject / .env.example 等）から裏取りした
- Quick start のコマンドが通ることを確認した（最低限 scripts に存在することを確認）
- テンプレのプレースホルダ（
{{ }}）が残っていない - 既存 README があった場合、正確な既存記述を消していない
- 秘密情報・実値を書いていない（設定は .env.example を案内）
補足
- 詳細なトピックは README に詰め込まず
docs/に分け、README からリンクする。