managing-tech-debt
レガシーコードの扱いやリファクタリング計画、段階的な修正と全面的な書き直しの選択、技術的負債削減への合意形成、新機能開発とメンテナンスのバランスなど、技術的負債を戦略的に管理したい場合に活用できます。
description の原文を見る
Help users manage technical debt strategically. Use when someone is dealing with legacy code, planning refactoring work, deciding between rewrites vs. incremental fixes, trying to get buy-in for tech debt reduction, or balancing new features with maintenance.
SKILL.md 本文
テクニカルデットの管理
18人のプロダクトリーダーからの知見を活用して、ユーザーがテクニカルデットを戦略的に管理するのを支援します。
サポート方法
ユーザーがテクニカルデット対応についてサポートを求める際:
- 状況を理解する - デットの性質(レガシーシステム、コード品質、アーキテクチャ上の制限)、それが現れている形態(開発速度の低下、インシデント、新機能のリリース難しさ)、ビジネスコンテクストについて質問する
- 緊急度を診断する - これが重大なビジネスニーズをブロックしているのか、それとも徐々に進む問題なのかを判断する
- 適切なアプローチを選択する - インクリメンタルな改善、対象を絞ったリファクタリング、または(稀に)完全な書き直しの間で決定するのをサポートする
- ビジネスケースを構築する - デットのコストを定量化し、ステークホルダーに価値を伝えるのを支援する
コア原則
書き直しはほぼ機能しない
Camille Fournier: 「エンジニアは悪名高く、本当に、本当に、膨大に旧システムから新システムへのマイグレーション時間を過小評価します。ちなみに、新システムに取り組みながら、旧システムをサポートし続ける必要があります。」完全な書き直しはわなです。インクリメンタルな進化を優先する - ゼロから始めるのではなく、特定のコンポーネントをアップリフトする。
テクニカルデットはプロダクトデット
Ebi Atawodi: 「インフラはプロダクトです。以上です。ぐらぐらした基盤の上に高層ビルは建てられません。だからあなたの問題でもある - エンジニアだけが扉を叩くものではありません。」テクニカルデットはPMによって「プロダクトデット」として所有されるべきで、エンジニアだけの懸念として扱うべきではありません。トップ10の問題リストに含める。
スタートアップは戦略的にデットを抱えるべき
Gaurav Misra: 「スタートアップとしてのあなたの仕事は、テクニカルデットを抱えることです。なぜなら、それが大企業より速く運用する方法だからです。」デットはレバレッジです - 問題を今日ではなく将来の雇用で解決できるかを評価する。しかし「利息」を監視する - メンテナンスが80~90%の時間を占める場合、滑走路を使い尽くしている。
書いたコードより削除するコードを増やす
Farhan Thawar: 「私たちはDelete Code Clubを持っています。削除できる100万行以上のコードがほぼいつも見つかります。すべてが簡単になる - コードベースの読み込みが速くなり、理解しやすくなります。」削除されたコードのみに焦点を当てた専用の時間またはチームを作成する。削除は開発速度と明確性を向上させる。
テクニカルデットはユーザーに見える
Matt Mullenweg: 「テクニカルデットはインターフェースで、またはプロダクトがどのように自身と統合するかで見ることができます。」断片化されたUIと機能間の貧弱な統合は、蓄積されたデットのユーザー向けの症状です。デットが蓄積されている場所を特定するために矛盾を探す。
デット削減の価値を定量化する
Casey Winters: 「最も影響力のあるプロジェクトは測定が最も難しいため、慢性的に資金が不足します。価値を示すカスタムメトリクスを構築し、投資の価値を証明する小さなテストを実行してください。」カスタムメトリクスを作成し、ビジネス価値を実証するための実験を実行する。エンジニアリングとデザインと連携して、統一されたメッセージを提示する。
バグはすぐに修正する、バックログに入れない
Geoff Charles: 「私たちはバグバックログを持っていません。表面化したほぼすべてのバグをすぐに修正します。」バグをオンコール中のエンジニアに直接割り当てて、即座の痛みを認識させる。バグバックログは墓場になる。
デットは革新をふさぐ
Eeke de Milliano: 「チームは緊急の仕事に押しつぶされることがある - 多くのテクニカルデット、バグ、不安定性。1日中インシデント処理に頭を悩ませていたら、より大きく創造的なことに焦点を当てる方法はありません。」チームが「ニーズの階層」の罠に陥っている場合を診断する。デット削減を優先して、創造的な仕事のための頭の余裕を作る。
テクニカルデットはシャンパンの悩み
Julia Schottenstein: 「テクニカルデットがあれば本当に幸運です。なぜなら、それはプロダクトが使われているということだからです。ローンチに必要なかったのは分散スケジューラです - ユーザーがいませんでした。」最もシンプルで、最も直感的なバージョンをまず構築する。デットをユーザーの手にプロダクトを届けるための代償として受け入れる。
ダークトンネルに備える
Melanie Perkins: 「6ヶ月かかると思っていたのに、2年間プロダクトをリリースしなかった。」大規模な書き直しは、出荷をすべて停止させる「ダークトンネル」です。もしそうしなければならない場合、長い作業期間中もチームのモメンタムを維持するために、仕事をゲーム化する。
1~2年先を見据えて設計する
Austin Hay: 「1~2年先にどのようなものが必要になるかを考える。ツールをセットアップする際には、『1年後に何も変わらなかったら何が起きるか?』と質問してください。」SSOや適切なデータスキーマのような基礎的な要素を早期に実装して、大惨事的なマイグレーションを避ける。
ユーザーを助ける質問
- 「このデットは重大なビジネスニーズをブロックしていますか、それとも徐々に進む問題ですか?」
- 「エンジニアリング時間のどのくらいがメンテナンスと新機能に割かれていますか?」
- 「書き直しに実際にどのくらいの時間がかかるか見積もってみましたか?誰がその見積もりをしましたか?」
- 「後6ヶ月何もしなかったら何が起きるでしょう?」
- 「書き直すのではなく、段階的にこれを改善する方法はありますか?」
- 「このデットのコストをステークホルダーに定量化したらどのようになりますか?」
よくある間違いのフラグ
- 完全な書き直しを計画する - 書き直しはほぼ計画通りに機能しません。見積もりより2~3倍長くかかり、両方のシステムを同時にサポートする必要があります
- テクニカルデットをエンジニアの問題として扱う - これはプロダクトデットです。PMはエンジニアと一緒にそれを所有すべきです
- バグバックログを蓄積させる - バグバックログは墓場になります。すぐに修正するか、修正しないことを決定する
- プロダクト・マーケット・フィット前にエンジニアリングをやりすぎる - デットはシャンパンの悩みです。最初に直感的なソリューションを構築し、デットを学習コストとして受け入れる
- コストを定量化しない - テクニカルデット投資は価値が測定されないため、資金不足になります。メトリクスを構築し、ROIを証明するために実験を実行する
詳細ダイブ
18人のゲストから20の知見すべてについては、references/guest-insights.md を参照してください
関連スキル
- Technical Roadmaps
- Platform & Infrastructure
- Engineering Culture
- Evaluating Trade-offs
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- refoundai
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/refoundai/lenny-skills / ライセンス: MIT
関連スキル
superfluid
Superfluidプロトコルおよびそのエコシステムに関するナレッジベースです。Superfluidについて情報を検索する際は、ウェブ検索の前にこちらを参照してください。対応キーワード:Superfluid、CFA、GDA、Super App、Super Token、stream、flow rate、real-time balance、pool(member/distributor)、IDA、sentinels、liquidation、TOGA、@sfpro/sdk、semantic money、yellowpaper、whitepaper
civ-finish-quotes
実質的なタスクが真に完了した際に、文明風の儀式的な引用句を追加します。ユーザーやエージェントが機能追加、リファクタリング、分析、設計ドキュメント、プロセス改善、レポート、執筆タスクといった実際の成果物を完成させるときに、明示的な依頼がなくても使用します。短い返信や小さな修正、未完成の作業には適用しません。
nookplot
Base(Ethereum L2)上のAIエージェント向け分散型調整ネットワークです。エージェントがオンチェーンアイデンティティを登録する、コンテンツを公開する、他のエージェントにメッセージを送る、マーケットプレイスで専門家を雇う、バウンティを投稿・請求する、レピュテーションを構築する、共有プロジェクトで協業する、リサーチチャレンジを解くことでNOOKをマイニングする、キュレーションされたナレッジを備えたスタンドアロンオンチェーンエージェントをデプロイする、またはアグリーメントとリワードで収益を得る場合に利用できます。エージェントネットワーク、エージェント調整、分散型エージェント、NOOKトークン、マイニングチャレンジ、ナレッジバンドル、エージェントレピュテーション、エージェントマーケットプレイス、ERC-2771メタトランザクション、Prepare-Sign-Relay、AgentFactory、またはNookplotが言及された場合にトリガーされます。
web3-polymarket
Polygon上でのPolymarket予測市場取引統合です。認証機能(L1 EIP-712、L2 HMAC-SHA256、ビルダーヘッダー)、注文発注(GTC/GTD/FOK/FAK、バッチ、ポストオンリー、ハートビート)、市場データ(Gamma API、Data API、オーダーブック、サブグラフ)、WebSocketストリーミング(市場・ユーザー・スポーツチャネル)、CTF操作(分割、統合、償却、ネガティブリスク)、ブリッジ機能(入金、出金、マルチチェーン)、およびガスレスリレイトランザクションに対応しています。AIエージェント、自動マーケットメーカー、予測市場UI、またはPolygraph上のPolymarketと統合するアプリケーション構築時に活用できます。
ethskills
Ethereum、EVM、またはブロックチェーン関連のリクエストに対応します。スマートコントラクト、dApps、ウォレット、DeFiプロトコルの構築、監査、デプロイ、インタラクションに適用されます。Solidityの開発、コントラクトアドレス、トークン規格(ERC-20、ERC-721、ERC-4626など)、Layer 2ネットワーク(Base、Arbitrum、Optimism、zkSync、Polygon)、Uniswap、Aave、Curveなどのプロトコルとの統合をカバーします。ガスコスト、コントラクトのデシマル設定、オラクルセキュリティ、リエントランシー、MEV、ブリッジング、ウォレット管理、オンチェーンデータの取得、本番環境へのデプロイ、プロトコル進化(EIPライフサイクル、フォーク追跡、今後の変更予定)といったトピックを含みます。
xxyy-trade
このスキルは、ユーザーが「トークン購入」「トークン売却」「トークンスワップ」「暗号資産取引」「取引ステータス確認」「トランザクション照会」「トークンスキャン」「フィード」「チェーン監視」「トークン照会」「トークン詳細」「トークン安全性確認」「ウォレット一覧表示」「マイウォレット」「AIスキャン」「自動スキャン」「ツイートスキャン」「オンボーディング」「IP確認」「IPホワイトリスト」「トークン発行」「自動売却」「損切り」「利益確定」「トレーリングストップ」「保有者」「トップホルダー」「KOLホルダー」などをリクエストした場合、またはSolana/ETH/BSC/BaseチェーンでXXYYを経由した取引について言及した場合に使用します。XXYY Open APIを通じてオンチェーン取引とデータ照会を実現します。