superpowers の skill (brainstorming、writing-plans、subagent-driven-development、 executing-plans) を動かすとき、それらが作る design と plan のファイルを保存する、扱うとき、 plan に ADR や設計文書を作る task を書くとき、それらを使った作業の PR を作るときに使う。
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
作業の順序は superpowers に従う。この skill は、superpowers が作る design と plan のファイルについて、 保存先、ユーザーの承認を待つ時点、plan に入れる文書の完成文を文書規約に照らす時点、コミットしないこと、 GitHub への記録の仕方を決める。
design と plan の保存先は brainstorming と writing-plans の既定に従う。リポジトリの文書規約が作業途中の 成果物の置き場所を別に定めていても、そこへ移さない。
plan に ADR や設計文書を作る task があるときは、writing-plans の既定どおり、plan にその文書の完成文を 入れる。承認後に実装する側は plan の文を写すので、文書の内容を規約に照らす場は plan を書く時点になる。 plan を書く側は、完成文を書く前に doc-conventions を読み、ユーザーにレビューを頼む前に完成文を doc-conventions で照合する。照合の観点は doc-conventions に従い、ここには書かない。
plan の task、step、全体の制約、合否の基準のどこにも、作業ブランチや worktree を作る、選ぶ、切り替える 指示を書かない。作業する checkout を指定する制約 (「primary checkout で作業する」など) と、この作業の ブランチの push、PR の作成、merge も書かない。
作業場所は plan を実行する skill が using-git-worktrees で用意し、統合は finishing-a-development-branch が 扱う。plan にも書くと同じ作業を二重に指示することになる。作業場所と統合を自分で決める無人の実行環境に plan を渡したときは、plan の指示がその契約とぶつかる。
PR の本文に必ず入れる事柄があるときは、task ではない節 (「PR に書くこと」など) に書く。
docs/superpowers/ と .superpowers/ の下のファイルはコミットしない。gitignore されていない
リポジトリでは、git add -A のような一括の stage でも含めない。
ユーザーがこの作業の一部として design と plan を GitHub に記録するよう求めたときは、次の時点で gh-ops を使ってコメントとして投稿する。書き込みに要るユーザーの明示的な指示は CLAUDE.md が定める。 この節は、その指示があるときの投稿の時点と内容だけを決める。
投稿する前に次の 2 点を済ませる。
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
シェルコマンドの実行、ファイル読み込み、URL の取得、検索、データの解析や変換を行うときに、 経路を通常のツールと context-mode の ctx_ ツールのどちらにするか判断するために使う。 context-mode が接続されている場合に適用する。ctx stats や ctx doctor といった "ctx" コマンドにも使う。
The English summary is being prepared. Showing the original description.
描く内容に合った図の種類を選んで図を書く。Mermaid の図、AWS の構成図、 マインドマップ (markmap。Mermaid ではない) を書く、直す、読み直すときに使う。
The English summary is being prepared. Showing the original description.
文書を書く、置き場所を決める、配置をレビューするときに使う。Markdown の書式、 ADR の作法、文書の層ごとの役割と正本の原則を扱う。
The English summary is being prepared. Showing the original description.
GitHub の Issue の作成、Issue へのコメント、draft PR の作成、PR へのレビューコメントの追加に使う。
The English summary is being prepared. Showing the original description.
PR のレビューコメントを解決する、または対応するときに使う。
The English summary is being prepared. Showing the original description.
コミットを頼まれたとき、plan のタスクを 1 つ終えたとき、まとまったコードの変更を 1 つ終えたときに、 次の作業に移る前に使う。
The English summary is being prepared. Showing the original description.