mcpField
B
brain-to-docs

brain-to-docs

github.com/davidondrejドキュメント4.2k217 回インストール今日更新
リポジトリ

brain-to-docs について

brain-to-docsは、ユーザーの判断、好み、プロジェクトのビジョンを簡潔なMarkdown文書にまとめるスキルです。既存文書を先に確認し、回答のたびにREADMEを更新するか、ADRとして決定事項を記録します。

主な機能

  1. 01READMEとADRを先に確認
  2. 02既定で多様な質問を5つ提示
  3. 03回答ごとに文書を更新
  4. 04ビジョンと決定事項を分けて記録
  5. 05定められた構成で番号付きADRを作成

活用シーン

  1. 01プロジェクトREADMEに製品ビジョンを記録
  2. 02ADRでプロジェクトの決定事項を記録
  3. 03継続中の議論を更新可能な文書に整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davidondrej/skills --skill brain-to-docs

インストール後、Claude Code で/brain-to-docsを入力して読み込まれたか確認します。

詳細

brain-to-docs

目的は、プロジェクトのために明確で簡潔な Markdown ドキュメントとして保存し、ユーザーの好み、判断、知識、ビジョン、嗜好、決定をできる限り多くテキストに抽出することです。README にはビジョンを、docs/adr/ には決定を記載します。

進め方

  1. 毎回、まずドキュメントを確認します。 何をするにも先に docs/adr/(および README.md)を読みます。他のエージェントや人々が、常に ADR を追加・編集しているためです。
  2. プレーンテキストで、異なる質問を5つ尋ねます(質問用 UI は使いません)。ユーザーが別の数を求めない限り、デフォルトは5つです。幅広く創造的な視点から、さまざまな種類の質問をします。同じ種類ばかりにはしません(例:「技術スタック」や「プロダクト」、「収益化」についてだけ尋ねることは避けます)。例外として、ユーザーが特定の分野に絞るよう求めた場合は、それに従います。ユーザーは、最も役立つと感じた質問に答えます。
  3. 回答のたびに必ずドキュメントを更新します。 例外はありません。内容に応じて README.md を更新するか、新しい ADR を作成します。
  4. ユーザーが「終了です」などと言うまで繰り返します。

ルール

  • この「brain to docs」プロセス中のすべての回答と返答は、非常に簡潔にします。すべての文を短くし、すべてを平易な英語で記述します。
  • ADR は、NNNN-slug.md 形式の短いファイル名にし、Status、Context、Decision、Consequences を記載します。
  • README に記載するのはビジョンのみです。決定は ADR に記載します。
  • ユーザーから求められた場合、または重大な誤りをしている場合を除き、ユーザーの考えに異議を唱えないでください。

コメント