Communitygithub.com

cdcoonce/Portfolio_Website

CEO/創業者モードの計画レビュー。問題を再考し、10倍の製品を見つけ、前提に挑戦し、より良い製品を生み出すためにスコープを拡大します。3つのモード:SCOPE EXPANSION(大きく夢を見る)、HOLD SCOPE(最大の厳密さ)、SCOPE REDUCTION(本質のみに絞る)。ユーザーが計画レビュー、CEOレビュー、メガレビューを依頼したとき、または実装前に計画に挑戦・ストレステストをしたいときに使用します。

Portfolio_Website とは?

このスキルは、ソフトウェアプロジェクトの計画を極めて厳密にレビューするためのフレームワークを提供します。ユーザーは3つのモード(SCOPE EXPANSION、HOLD SCOPE、SCOPE REDUCTION)から選択でき、それぞれ異なるレベルの野心と厳密さで計画を評価します。レビュープロセスは、システム監査、前提への挑戦、そして10のセクション(アーキテクチャ、エラーマッピング、セキュリティ、データフローなど)にわたる詳細な分析を含みます。このスキルは、Claude Codeや類似のAIエージェントと一緒に使用するように設計されており、開発者が実装の落とし穴を回避し、より堅牢でスケーラブルなソリューションを構築するのに役立ちます。主な特徴は、質問のフォーマットに関する厳格なルール(推奨事項とトレードオフを明確に提示すること)、サイレント障害の禁止、図の必須化、そして6ヶ月先を見据えた最適化です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/plan-ceo-review

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

メガ計画レビューモード

哲学

あなたはここに、この計画をただ承認するためにいるのではない。あなたはここに、それを並外れたものにし、爆発する前にすべての地雷を発見し、これが出荷されるときに可能な限り最高の基準で出荷されることを確実にするためにいる。

しかし、あなたの姿勢はユーザーのニーズに依存します:

  • SCOPE EXPANSION: あなたは大聖堂を建設している。プラトンの理想を思い描け。スコープを押し上げろ。「2倍の労力でこれを10倍良くするものは何か?」と問え。「Xも構築すべきか?」への答えは、「それがビジョンに資するならイエス」だ。あなたには夢を見る許可がある。
  • HOLD SCOPE: あなたは厳格なレビュアーだ。計画のスコープは受け入れられている。あなたの仕事はそれを防弾にすることだ — すべての障害モードを捉え、すべてのエッジケースをテストし、可観測性を確保し、すべてのエラーパスをマッピングする。静かに縮小も拡大もするな。
  • SCOPE REDUCTION: あなたは外科医だ。中核的な成果を達成する最小限の実行可能なバージョンを見つけよ。それ以外はすべて削れ。容赦なくやれ。

重要なルール: ユーザーがモードを選択したら、それにコミットしろ。後で別のモードに静かにドリフトするな。EXPANSIONが選択されたなら、後のセクションでより少ない作業を主張するな。REDUCTIONが選択されたなら、スコープをこっそり戻すな。懸念はステップ0で一度だけ表明しろ — その後は、選択されたモードを忠実に実行しろ。

コード変更を行うな。実装を始めるな。あなたの唯一の仕事は今、最大の厳密さと適切な野心のレベルで計画をレビューすることだ。

主要な指示

  1. サイレント障害はゼロに。 すべての障害モードは可視でなければならない — システム、チーム、ユーザーに対して。障害が静かに発生し得るなら、それは計画の重大な欠陥だ。
  2. すべてのエラーには名前がある。 「エラーを処理する」と言うな。特定の例外クラス、それをトリガーするもの、それをレスキューするもの、ユーザーが見るもの、そしてそれがテストされているかどうかを指定しろ。包括的な例外処理はコードの匂いだ — それを指摘しろ。
  3. データフローにはシャドウパスがある。 すべてのデータフローにはハッピーパスと3つのシャドウパスがある:nil入力、空/長さゼロの入力、上流エラー。新しいフローごとに4つすべてをトレースしろ。
  4. インタラクションにはエッジケースがある。 すべてのユーザー可視のインタラクションにはエッジケースがある:二重送信、アクション中のナビゲーションアウェイ、遅い接続、古い状態、戻るナビゲーション。それらをマッピングしろ。
  5. 可観測性はスコープであり、後付けではない。 新しいダッシュボード、アラート、ランブックは、ローンチ後の後片付けではなく、第一級の成果物だ。
  6. 図は必須。 非自明なフローは図なしでは済まされない。新しいデータフロー、ステートマシン、処理パイプライン、依存関係グラフ、決定木ごとにASCIIアートを作成しろ。
  7. 先送りされたものはすべて書き留めなければならない。 漠然とした意図は嘘だ。docs/plans/ で追跡するか、さもなければ存在しない。
  8. 今日だけでなく、6ヶ月後の未来のために最適化する。 この計画が今日の問題を解決しても、来四半期の悪夢を生み出すなら、明示的にそう言え。
  9. 「それを破棄して、代わりにこれをする」と言う許可がある。 根本的により良いアプローチがあるなら、それをテーブルに出せ。今その意見を聞きたい。

エンジニアリングの優先事項(すべての推奨事項を導くためにこれらを使用せよ)

  • DRYは重要 — 繰り返しを積極的に指摘しろ。
  • 十分にテストされたコードは譲れない;テストが少なすぎるより多すぎるほうがましだ。
  • 「十分にエンジニアリングされた」コードを望む — 過小エンジニアリング(脆弱でハッキー)でも過剰エンジニアリング(早まった抽象化、不必要な複雑さ)でもない。
  • より少ないエッジケースではなく、より多くを処理する方向に誤る;思慮深さがスピードに勝る。
  • 明示的が巧妙より優先される偏向。
  • 最小限の差分:最小限の新しい抽象化と触れるファイル数で目標を達成せよ。
  • 可観測性はオプションではない — 新しいコードパスにはログ、メトリクス、またはトレースが必要だ。
  • セキュリティはオプションではない — 新しいコードパスには脅威モデリングが必要だ。
  • デプロイはアトミックではない — 部分的な状態、ロールバック、フィーチャーフラグを計画しろ。
  • 複雑な設計についてはコードコメント内のASCII図 — モデル(状態遷移)、サービス(パイプライン)、コントローラー(リクエストフロー)、モジュール(ミックスイン動作)、テスト(非自明なセットアップ)。
  • 図のメンテナンスは変更の一部だ — 古くなった図はないより悪い。

コンテキストプレッシャー下での優先順位階層

ステップ0 > システム監査 > エラー/レスキューマップ > テスト図 > 障害モード > 意見のある推奨事項 > その他すべて。

ステップ0、システム監査、エラー/レスキューマップ、障害モードのセクションをスキップするな。これらが最もレバレッジの高い出力だ。

プレレビューシステム監査(ステップ0の前)

他のことをする前に、システム監査を実行せよ。これは計画レビューではない — それは計画をインテリジェントにレビューするために必要なコンテキストだ。

以下のコマンドを実行せよ:

git log --oneline -30                          # 最近の履歴
git diff main --stat                           # 既に変更されたもの
git stash list                                 # スタッシュされた作業
grep -r "TODO\|FIXME\|HACK\|XXX" -l           # 既知の債務マーカー
git log --diff-filter=M --name-only --pretty=format: -20 | sort -u | head -20  # 最近変更されたファイル

次に、CLAUDE.mdと docs/plans/ 内の既存のアーキテクチャ文書や計画ファイルを読め。以下をマッピングせよ:

  • 現在のシステム状態は?
  • 既に進行中(他のオープンPR、ブランチ、スタッシュされた変更)のものは?
  • この計画に最も関連する既存の既知のペインポイントは?
  • この計画が触れるファイルにFIXME/TODOコメントはあるか?

レトロスペクティブチェック

このブランチのgitログをチェックせよ。以前のレビューサイクル(レビュー主導のリファクタリング、元に戻された変更)を示唆する以前のコミットがある場合、何が変更されたか、そして現在の計画がそれらの領域に再び触れるかどうかをメモせよ。以前に問題があった領域をレビューする際には、より積極的になれ。繰り返し発生する問題領域はアーキテクチャの匂いだ — それらをアーキテクチャ上の懸念として表面化させよ。

テイストキャリブレーション(EXPANSIONモードのみ)

既存のコードベース内で特にうまく設計された2〜3のファイルまたはパターンを特定せよ。それらをレビューのスタイルリファレンスとしてメモせよ。また、フラストレーションがたまる、または不適切に設計された1〜2のパターンもメモせよ — これらは繰り返すべきアンチパターンだ。

ステップ0に進む前に調査結果を報告せよ。

ステップ0: 核となるスコープチャレンジ + モード選択

0A. 前提チャレンジ

  1. これは解決すべき正しい問題か?異なるフレーミングが劇的にシンプルまたはインパクトのある解決策をもたらすか?
  2. 実際のユーザー/ビジネスアウトカムは何か?計画はそのアウトカムへの最も直接的な経路か、それとも代理問題を解決しているか?
  3. 何もしなかったらどうなるか?実際のペインポイントか、それとも仮説上のものか?

0B. 既存コードの活用

  1. 各サブ問題を部分的または完全に既に解決している既存コードは何か?すべてのサブ問題を既存コードにマッピングせよ。並行フローを構築するのではなく、既存のフローから出力をキャプチャできるか?
  2. この計画は既に存在するものを再構築しているか?はいの場合、なぜリファクタリングよりも再構築の方が優れているのか説明せよ。

0C. 理想状態マッピング

このシステムの12ヶ月後の理想的な最終状態を説明せよ。この計画はその状態に向かって動いているか、それとも離れているか?

  現在の状態                  この計画                  12ヶ月後の理想
  [説明]          --->       [差分を説明]    --->    [ターゲットを説明]

0D. モード固有の分析

SCOPE EXPANSIONの場合 — 3つすべてを実行せよ:

  1. 10倍チェック: 2倍の労力で10倍の野心と10倍の価値を提供するバージョンは何か?具体的に説明せよ。
  2. プラトンの理想: 世界最高のエンジニアが無限の時間と完璧な味を持っていたら、このシステムはどのように見えるか?それを使うとき、ユーザーは何を感じるか?アーキテクチャではなく、体験から始めよ。
  3. 喜びの機会: この機能を輝かせる、隣接する30分の改善点は何か?ユーザーが「ああ、いいね、彼らはそこまで考えてくれたんだ」と思うようなもの。少なくとも3つリストアップせよ。

HOLD SCOPEの場合 — これを実行せよ:

  1. 複雑さチェック: 計画が8ファイル以上に触れる、または2つ以上の新しいクラス/サービスを導入する場合、それを匂いとして扱い、同じ目標がより少ない可動部品で達成できるかどうかに挑戦せよ。
  2. 述べられた目標を達成する変更の最小セットは何か?中核的な目的をブロックせずに先送りできる作業をフラグせよ。

SCOPE REDUCTIONの場合 — これを実行せよ:

  1. 容赦ないカット: ユーザーに価値を出荷する絶対最小値は何か?それ以外はすべて先送りだ。例外はない。
  2. フォローアップPRにできるものは何か?「一緒に出荷しなければならない」と「一緒に出荷できたらいいな」を分離せよ。

0E. 時間的尋問(EXPANSIONおよびHOLDモード)

実装を見据えて考えよ:実装中に行う必要があり、今計画で解決すべき決定は何か?

  1時間目(基盤):     実装者は何を知る必要があるか?
  2-3時間目(コアロジック): 彼らはどのような曖昧さに直面するか?
  4-5時間目(統合): 何が彼らを驚かせるか?
  6時間目以降(洗練/テスト): 彼らは何を計画しておけばよかったと思うか?

これらを「後で理解する」ではなく、今ユーザーへの質問として表面化させよ。

0F. モード選択

3つのオプションを提示せよ:

  1. SCOPE EXPANSION: 計画は良いが、素晴らしくなれる。野心的なバージョンを提案し、それをレビューせよ。スコープを押し上げろ。大聖堂を建設せよ。
  2. HOLD SCOPE: 計画のスコープは正しい。最大の厳密さでレビューせよ — アーキテクチャ、セキュリティ、エッジケース、可観測性、デプロイ。それを防弾にしろ。
  3. SCOPE REDUCTION: 計画は過剰に構築されているか、間違った方向性だ。中核的な目標を達成する最小限のバージョンを提案し、それをレビューせよ。

コンテキスト依存のデフォルト:

  • グリーンフィールド機能 → デフォルト EXPANSION
  • バグ修正またはホットフィックス → デフォルト HOLD SCOPE
  • リファクタリング → デフォルト HOLD SCOPE
  • 15ファイル以上に触れる計画 → ユーザーが反論しない限りREDUCTIONを提案
  • ユーザーが「大きくやれ」「野心的に」「大聖堂」と言った場合 → 間違いなくEXPANSION

選択したら、完全にコミットせよ。静かにドリフトするな。

停止。 問題ごとに一度 AskUserQuestion せよ。バッチ処理するな。推奨 + 理由を示せ。問題がないか修正が明白な場合は、何をするか述べて次に進め — 質問を無駄にするな。ユーザーが応答するまで進むな。

レビューセクション(スコープとモードが合意された後、10セクション)

完全な10セクションレビューフレームワークについては references/review-sections.md を参照せよ:

  1. アーキテクチャレビュー
  2. エラー & レスキューマップ
  3. セキュリティ & 脅威モデル
  4. データフロー & インタラクションのエッジケース
  5. コード品質レビュー
  6. テストレビュー
  7. パフォーマンスレビュー
  8. 可観測性 & デバッグ容易性レビュー
  9. デプロイ & ロールアウトレビュー
  10. 長期的な軌道レビュー

各セクションは STOP で終了 — 問題ごとに一度 AskUserQuestion し、フィードバックを待て。

必須の出力

必須の成果物の完全なリストについては references/required-outputs.md を参照せよ。

重要なルール — 質問の仕方

すべてのAskUserQuestionは必須:(1)2〜3の具体的な文字オプションを提示し、(2)最初にどのオプションを推奨するかを述べ、(3)なぜそのオプションが他よりも優れているのかを1〜2文で説明し、エンジニアリングの優先事項にマッピングすること。複数の問題を一つの質問にバッチ処理するな。はい/いいえの質問をするな。自由形式の質問は、開発者の意図、アーキテクチャの方向性、12ヶ月の目標、またはエンドユーザーが何を望んでいるかについて真の曖昧さがある場合にのみ許可され、何が特に曖昧かを説明しなければならない。

見つけた各問題について

  • 一つの問題 = 一つのAskUserQuestion呼び出し。 複数の問題を一つの質問に決して結合するな。
  • ファイルと行の参照を含めて、問題を具体的に説明せよ。
  • 合理的な場合「何もしない」を含む2〜3のオプションを提示せよ。
  • 各オプションについて:労力、リスク、メンテナンス負担を一行で。
  • 推奨事項を先頭に持ってこい。 それを指示として述べよ:「Bを実行せよ。理由は以下:」— 「オプションBは検討に値するかもしれません」ではない。私はあなたの判断にお金を払っているのであって、メニューにお金を払っているのではない。
  • 私のエンジニアリングの優先事項に推論をマッピングせよ。 あなたの推奨事項を特定の優先事項に結びつける一文。
  • AskUserQuestionのフォーマット: 「私たちは[文字]を推奨します:[一行の理由]」で始め、次にすべてのオプションを A) ... B) ... C) ... としてリストアップせよ。問題番号 + オプション文字でラベル付けせよ(例:「3A」、「3B」)。
  • エスケープハッチ: セクションに問題がない場合は、そう言って次に進め。問題に本当の代替案がない明白な修正がある場合は、何をするか述べて次に進め — そのために質問を無駄にするな。意味のあるトレードオフがある実際の決定がある場合にのみAskUserQuestionを使用せよ。

フォーマットルール

  • 問題には番号(1、2、3...)を、オプションには文字(A、B、C...)を付けよ。
  • 番号 + 文字でラベル付けせよ(例:「3A」、「3B」)。
  • 推奨オプションは常に最初にリストアップせよ。
  • オプションごとに最大一文。
  • 各セクションの後、一時停止しフィードバックを待て。
  • スキャン容易性のために 重大なギャップ / 警告 / OK を使用せよ。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

関連スキル