その質問、もう何回目ですか。生成AIで実装スピードが上がった分、CSやQAが仕様を追いきれず、開発への問い合わせが集中していませんか。Asklessは、マージされたPRから機能仕様ドキュメントを自動生成し、誰でも読める形で保守します。
// checkout.ts - if (cart.total > 0) applyTax(); + if (cart.total > 0 && !cart.isGift) { + applyTax(); + } // #482 ギフト注文を非課税に
カート内の商品が「ギフト」指定の場合、税額計算をスキップする。
cart.isGift = true の注文実装が速くなるほど、置いていかれるのはいつもドキュメントです。
PRをマージするだけで、ドキュメントは後からついてきます。
普段通り開発を進めるだけで構いません。特別な作業は増えません。
差分の内容から、根拠のある記述だけをドキュメント化します。推測では書きません。
開発に聞かなくても、いま何がどう動くのかをドキュメントで確認できます。
| 導入前 | 導入後 |
|---|---|
| 質問が来るたびに、コードを読み直して答える | ドキュメントを見てもらえば済む |
| 仕様書は書いた瞬間から古くなっていく | PRのマージに合わせて自動更新される |
| 仕様の知識が特定の人に偏っている | チーム全員が同じ場所を参照できる |
Asklessの基盤となっているOSS版spec-bridgeは、これらの実在するプロジェクトのPR履歴に対して動作検証を行っています。詳細はGitHubのREADMEをご覧ください。
正式リリースに先立って、案内をお送りします。導入のご相談も歓迎です。