タグ検索の該当結果が少ないため、タイトル検索結果を表示しています。
よく、仕様書を書いていなくて、書いてみたいけど、具体的な仕様書がネット上に落ちてなくってこまってるって相談を受けるので 「仕様書の記載内容のイメージ」を作りました！ ※前提として「現在仕様書を書いていない、自社開発のMVP検証前後のフェーズのスタートアップ向け」に書いています。PMが仕様書、エンジニアがDesign Docを書く分担です。 ついでに、システム開発の基礎である「システム開発のV字モデルをベースにした設計書の紹介」も含めてまとめてみましたー！ 大規模開発に使われたり、古くからあるフレームワークなので、スタートアップの方だと、システム開発のV字モデルの概念やそれにあわせた成果物を知らない人が多いけど、「要件定義書」と「設計書」を全てドキュメント化するとどうなるかを理解した上で、「仕様書」として情報を削る方が、考慮漏れ防止やエンジニアがやっている設計内容の理解につながるので、全体を
日本IBM（「Wikipedia」より／Yoshi Canopus） NHKがシステム開発を委託していた日本IBMに対し、開発の遅延による契約解除に伴い計約55億円の代金の返還と損害賠償を求めて東京地裁に提訴した係争事案。NHKは、日本IBMが開発の途中で突然、NHKに対して大幅な開発方式の見直しと納期遅延を要求したと主張しているが、これに対し日本IBMは7日、以下のリリースを発表して反論したことがIT業界内で注目されている。 ＜現行システムの解析を進める中で、提案時に（編集部追記：NHKから）取得した要求仕様書では把握できない、長年の利用の中で複雑に作り込まれた構造となっていることが判明したため、当社はNHKに対し、解析の進捗状況、課題およびそれに対する対応策を随時報告し、共にその対応を検討してまいりました。こうした中で当社は、同システムを利用する業務の重要性も鑑みて、NHK指定の移行方
経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「個々人のレビュー」「要検討項目の共有および分析」「修正作業および報告作業」の順に整理し、実行するべきタスクや手順を規定するもの。システム開発や試験、保守などの場面で作るあらゆる仕様書に適用可能。 レビューの曖昧さをなくすため、「目的」「役割」などのレビューの観点10種、「執筆者確認」「同僚との机上確認」などのレビュー手法9種を定めた。JIS制定により、組織や個人のノウハウに依存することなく一定水準のレビューができるようになり、ソフトウェアなどの制作物の品質向上につながるとしている
SWET第二グループのKuniwakです。本記事では画面仕様（後述）の仕様書に対する静的検査器を開発した事例について紹介します。 伝えたいこと 画面表示と画面遷移を記述する仕様書は機械可読にできる 仕様書が機械可読であれば仕様の静的検査ができる 静的検査によって自身の担当範囲の15%の画面から計40件弱の欠陥を発見した 機械可読な仕様書にはさらなる応用が見込める おさらい：仕様とは 仕様の定義はいくつかあります。 ここでは仕様とは実装の正しい振る舞いを定める基準とします。 ある実装が正しいと判定されることを、実装が仕様を満たしたといいます。 誰による判定でも実装が仕様を満たしたかどうかの判定結果は一致すべきです。 さて実装の欠陥と同様に、仕様にも欠陥が生じえます。 本来正しいと意図した実装の振る舞いを誤っていると判断したり、その逆に誤っていると意図した実装を正しいと判断する仕様には欠陥があ
デザイナーがWebサイトのUIを実装する際にデベロッパーに渡すデザイン仕様書・指示書の作り方を紹介します。 仕様書を作成する基本ツール、指示に適したフォントやカラー、グリッドや要素間の距離を自動的に計算するツールをはじめ、レイアウトや各UIコンポーネントのデザイン仕様の記述例まで、デザインを仕様化する解説記事です。 ブレイクポイントの説明、スティッキー要素の仕様説明、相対サイズの要素の説明方法、ボタンの文字数の説明、アニメーションする要素の説明方法など、デベロッパーに分かりやすく、デザイナー自身も見直せるデザイン仕様書を作成します。 The Art of Design Spec'ing by Mahdi Farra 🍉 下記は各ポイントを意訳したものです。 ※当ブログでの翻訳記事は、元サイト様にライセンスを得て翻訳しています。 デザイン仕様書とは デザイン仕様書に使用するツール デザイン
ジャンプTOON ソフトウェアエンジニアの國師 (@ronnnnn_jp) です。 この記事では、仕様書の作成・レビューに生成 AI を活用するための実践的なアプローチを紹介します。 目次 生成 AI による開発効率の変化 LLM の特徴と制約 コンテキスト情報の整備 手順や制約の明確化 評価と効果 なぜ Notion AI か おわりに 生成 AI による開発効率の変化 2024 年 5 月にサービスを開始したジャンプTOON は、モバイルアプリケーションと Web ブラウザアプリケーションを提供しています。バックエンドも含め、ジャンプTOONの開発は大きく次の流れで進みます。PM が企画と仕様策定を行い、開発メンバー (エンジニア、デザイナ、QA など) を巻き込んで仕様をブラッシュアップします。その後、デザイナが UI デザイン、エンジニアが実装を進めます。 昨今ではコーディング A
タイトルでもうオチてる感じがしますが、API仕様書を読み込むMCPサーバーを自作したところ、開発が爆速になったので紹介します。普段Androidのアプリ開発をしている人間です。 MCPとは？ LLMに対してコンテキストを与えるためのプロトコルです。 今回はAPI仕様書を読み込むMCPを作るので、ざっくり言うとClineやClaude for Desktop、GitHub Copilot Agentなど、MCPに対応したツールがAPI仕様書に基づいてコードを書いてくれるようになります。 何が嬉しいのか？ 例えば、以下のような質問・指示ができるようになります。 決済に関連するAPIを列挙し、Markdown記法でまとめて ドメインクラスを作りたいので、User をKotlinのdata classで出力して Androidアプリの NotificationRepository.kt に書いてあ
こんにちは、Algomatic AXの大塚（@ootsuka_techs）です。 本記事では、いま話題の仕様駆動開発（Spec Driven Development; SDD）を調べ、社内で試した学びをまとめます。 今回は以下の4つのツールを使用し、それぞれの特徴や使い勝手を詳しく検証しました。 Kiro Spec Kit spec-workflow-mcp cc-sdd 比較した結果は以下の通りです。 機能比較表 機能 Kiro Spec Kit spec-workflow-mcp cc-sdd 日本語対応 △ △ ○ ◎ 承認フロー ○ ○ ◎ ○ プロジェクトガバナンス ○ ◎ ○ ○ IDE統合 ○（専用IDE） ○ ○ ○ オープンソース × ○ ○ ◎ エンタープライズ対応 ◎ ○ ○ ○ 学習コスト △ ◎ ○ ◎ カスタマイズ性 △ ○ ○ ◎ 以降は仕様駆動開発（Spec
はじめに CursorやGithub Copilot、Clineなど、コーディングに生成AIを使うのは当たり前になりました。AIにコードを書かせているとき、この仕様どおりに書いてくれないかなあ、と思う場面があります。Cursorには外部ドキュメントを読み込む機能があるので、指定しておけば、公開されているリファレンスなどをAIが読み込むことができるのですが、社内にある仕様書や開発標準などのドキュメントを参照したいケースもあるでしょう。この記事ではRunbookのMCPサーバーを使って、社内ドキュメントをAIに読み込ませる方法を紹介します。 Runbookについて Runbookはマニュアルや手順書を作成するためのWebサービスです。マニュアルを社内で共有したり、インターネットに公開したりできます。あと手順を組み合わせてワークフローのように実行できるらしいです。有料サービスですが、今回の方法で
本記事は Figma Advent Calendar 2022 16日目の投稿です。 仕様書を作るとき、あの情報はこのツールで書いたほうが楽、みたいな感じで、あっちこっちに情報が散逸することがありますよね。 かくいう私も、事業会社でデザイナーとPMの狭間みたいな仕事をしていまして、UMLだのデザインだの、複数のツールを跨いで作業をすることが多かったのですが、最近は安定してFigma＋Notionで作業をしています。 これはデザイナーなのでFigmaの使い方に慣れている、ということもあるんですが、Figmaの自由度の高さや、Notionの情報統合性の高さ（この辺は後述します）が筆者の仕事範囲と大変に相性が良く、今の所ここがベストという形に落ち着いているので、軽く紹介してみようと筆を取りました。ご興味があれば読んでください。 TL;DR（この記事のあらすじ） エンジニア・非エンジニア・社内外い
数年前にAIを離れ現在はフロントエンドをやっているのですが、半年くらい前に思い切り引き戻されました。画像生成AIにおけるmidjourneyとstable diffusionの登場です。noteのCTO深津さんが記事を出したと思ったのも束の間、急速に進化を果たしました。 絵柄の固定・ポーズの指定・マシンスペックなど、日々さまざまな問題を解決しながら新たな技を身につけています。 しかし、同等かそれ以上に話題になっているのは大規模言語モデル(Large Language Model)かもしれません。ChatGPTが話題になった思ったら、BingやPerplexity,You.comなど大規模言語モデルを交えたサービスが次々と登場しました。 活用方法もたくさん見つけられており、私は特に以下の二つの記事が好きです。 「感情回路」の記事に入力(プロンプト)でここまで変わるのかと感動したことを覚えてい
【この記事の対象者】 仕様書の書き方が分からなくて、困っているゲームプランナー ゲームプランナーの素養を身に付けたい人 ゲーム開発に興味がある人 【この記事で学べること】 仕様の考え方 仕様書の作成方法 ゲームデザインに関する基礎知識 前回の記事 前回の記事では、なぜ人によって仕様書作成の能力に差が出るのかを解説しました。今回は仕様書作成の能力を身に付けるための方法を紹介します。 はじめに仕様書が書けない人は、次のどちらかに当てはまると思います。 やりたいことがはっきりしていない やりたいことがはっきりしているが、何を書けばいいのか分からない 『2』に関しては「仕様書の書き方」を調べていけば、答えにたどり着く可能性があります。 しかし、『1』の場合は「仕様書の書き方」を調べても、答えにたどり着けません。なぜなら、「仕様書の書き方」でつまづいているのではなく、「仕様の考え方」の部分でつまづい
はじめに こんにちは！クラシルリワードでバックエンド開発をしているkorosukeです。 今回は、Claude Codeを活用してアフィリエイト仕様書の自動更新システムを構築し、運用チームの問い合わせ対応時間を25%削減した事例をご紹介します。 カスタムコマンドでgit履歴から変更を検出し、Notion MCPで仕様書を自動更新する仕組みにより、手動作業を大幅に削減することができました。 背景：複雑化するアフィリエイト仕様と問い合わせの増加 クラシルリワードでは、多数のASP（アフィリエイトサービスプロバイダー）と連携し、複雑な成果通知システムを運用しています。 仕様が複雑で把握が困難な上、仕様書がない・古い状態のものもあり、毎回コード調査が必要となり問い合わせ対応時間が膨らんでいました。 抱えていた課題 仕様が複雑化していて、そもそも仕様理解が難しい：多数のASPとの連携により、パラメー
Kiroの設計思想に近付く+超えるように、初期バージョンから大幅アップデートしています。最新情報はGithubを参照してください。（2025/8/28） Kiroの仕様駆動開発のワークフロー全体をClaude CodeのSlash Commands(7ファイル)で再現できるようにした Kiroのフォルダ構成、ドキュメント構成をトレースし全く同じ構成で出力されるように再現したため、Claude Codeで作成したプロジェクトをKiroでそのまま利用することが可能（互換性あり） KiroはSpec-Driven Development (仕様駆動開発)に沿った開発プロセスが組み込まれたAIコーディングエージェントで、本番環境でシニアソフトウェアエンジニアが行う開発プロセスが落とし込まれています。 この仕様駆動開発プロセスはなかなか理想的で、仕様書の作成方法やドキュメント構成等が今後の開発プロセ
はじめに クラウドサイン Product Engineering 部で主にフロントエンドエンジニアとして活動している山下慧（@kirehashi_3）です。 さて、この記事をご覧になっている方は、Claude Code などの AI エージェントを用いて開発していることが多いでしょう。しかし、使っている中で「AI エージェントが自分の意図とは違う仕様で開発し始めた！」「途中で寄り道を始めて収拾がつかなくなった！」といった経験をしたことも多いのではないでしょうか。 本記事ではこういった問題を解決するための手法として、まずは Kiro が提唱する仕様書駆動開発について説明します。そのうえで、この仕様書駆動開発を Claude Code で利用できるようにした claude-code-spec-workflow について紹介します。 以降は以下の環境下を前提に説明していきます：Claude Co
GitHub からリリースされたばかりの Spec Kit を試してみましたので使用感などをまとめました。 Claude Code との組み合わせを前提としています。 試してみる Spec Kitは、GitHub が公開した仕様書駆動開発ツールです。AWS の Kiro に相当するツールですが、こちらはエディタを使用せず、CLI + コーディングエージェント を組み合わせて仕様書生成からコード生成まで行うツールです。 3つのフェーズに分けて、仕様書の生成から実装計画、タスク分解までを行います。 まずはインストール Python パッケージマネジャの uv コマンドでインストール＆実行します。
AIに仕様書を読ませるとテストケースを自動生成、テストコードも書いてくれる「Autify Nexus」、Autifyが発表 テスト自動化ツールなどを提供するAutifyは、仕様書を読み込ませることで仕様に基づいたさまざまなテストケースを自動的に生成するテストデザイン機能や、テストしたい内容を自然言語で指示することで自動的にテストシナリオとテストコードを生成する機能などを備えた新サービス「Autify Nexus」の提供を発表しました。 自然言語からテストコードを生成、仕様書からテストケースの作成も 例えばテストエンジニアがAutify Nexsusに対して「このアプリケーションの入力フォームに値を入力し、OKボタンを押して申し込みを完了してください。値はランダムに生成し、メールアドレスは[email protected]を使って下さい」などと自然言語で指定すると、Autify Nexusは
皆さまこんにちは。ぐるなびで主に会員系サービスのフロントエンド開発を担当している小松です。主務はフロントエンドですが、開発部内で組織間連携分科会という活動も行っており会長も務めています。他にも肩書が増えてしまいましたが…今回はその組織間連携分科会での取り組みについてご紹介したいと思います。 この分科会は、長年、開発部の中でエンジニアとディレクター・デザイナー間などで課題となっていたコミュニケーションの認識齟齬や組織をまたいだ連携に関する課題に取り組むため発足しました。実は現存する分科会の中でも長く活動している分科会の1つです。 以下の内容は分科会メンバーの多大なる協力で執筆することができました。ありがとうございます。 コミュニケーションの課題 開発する中でそれぞれの役割ごとに異なる視点や専門知識を持つメンバーが協力し合うことは、プロダクトの成功に不可欠です。しかし、現実には以下のような課題
本稿は、2024年2月頃に書き溜めていたシリーズです。最後まで温存させるのが勿体ないので、未完成ですがそのまま公開します(公開日: 2025/9/21)。そのため、内容の重複や記述方針の不一致があるかもしれませんが、ご理解ください。 CSSの仕様を理解するために、1日ごとにテーマを決めて説明する企画1日目です。今日のテーマは「仕様書」です。 仕様書 CSSはWebの標準化団体であるW3Cによって標準化され、各ブラウザベンダによって実装されている規格です。 標準化して挙動を仕様書として書き起こすことによって、Webブラウザ間の相互運用性が高まり、Web開発者も互換性の高い記述を心掛けてCSSを書くことができるようになります。 とはいえ、仕様書と実装の関係は必ずしも一方向的ではありません。「仕様書に記載される → 実装される」というシンプルな順番であるとは限らないのです。実装されたものにあわせ
三菱電機が組み込みソフトウエア開発への生成AI（人工知能）活用を進めている。ソフトウエア開発に関連する過去数十年分のドキュメントの要約文を生成AIにより作成。これを検索用のインデックスとして使うことで、エンジニアの作業工数を最大40%削減できると見込む。 2024年6月20日に開催されたアマゾン ウェブ サービス ジャパン（AWSジャパン）の年次イベント「AWS Summit Japan」で、PoC（概念実証）の成果として明らかにした。今後は実用上必要最小の機能を備えたサービスであるMVP（Minimum Viable Product）として、従業員向けのアプリケーションを開発する予定だ。 三菱電機の組み込みソフトの開発部門では、製品開発部門から改修依頼を受けると、改修対象のソフトウエアの仕様書を検索して改修内容に関連する記述を確認。それを基にソフトウエアのソースコードを確認し、ソースコー
AI事業本部 DX本部の黒崎(@kuro_m88)です。 社外(取引先など)向けに作成する仕様書を自動生成する取り組みを試しているので、アイデアを紹介します。今回はSnowflakeで構築されているデータ分析基盤のテーブル定義の仕様書を例に紹介していきます。ツールはGoを使って開発しました。 仕様書の運用コストを減らしたい DX本部でのプロジェクトは、開発環境を社内向けに別途用意することが大半なので、取引先に許可を取らないと何かを試すことができないということは今のところほとんどありません。 そのため、実際の開発フローとしては詳細な仕様書を書き起こしてから実装することはあまりなく、大まかな方針を決めてから軽く実装してみて、うまくいきそうであればそれを仕様としてまとめつつ実装することが多いです。 データベースのテーブル定義であれば、それらの定義はGitHub上で管理されており、リリース時に自動
鶴田道孝 @mTsuruta 個人開発だと 自分でプログラムするから「仕様書」いらないと思うじゃん？ いるんだな、これが。 「オレは何を作ろうとしてたんだ！？」 って、後になってから。 2025-11-26 11:29:00 鶴田道孝 @mTsuruta この現象、プログラム部分よりデータ構造とかデータの特殊処理とかの方が多い。 複数のクラスやメソッドが連合して動作する箇所。 ゲームだと、後付けでデータ構造がかなり修正されたりするんだ。 そして修正した動機が失われても、その残骸が残ったりする。 そういう時に。 2025-11-26 23:32:07 鶴田道孝 @mTsuruta じゃあ、仕様書を書けばいいかと言えば。 キチンとメンテしない仕様書は、沼。 「オレは何をしようとしてたんだー！あ、仕様書見よう」 仕様書を読む。 「オレは何がしたかったんだー！」 迷宮は、その深みをいっそう増す。
ヤマダ @yamada_sier やはり議事録…議事録は全てを解決する 冗談はさておき、現行ベンダの富士通がこれまで色々な無理難題を全部うまいこと飲み込んでやってきたんやろなと想像。 NHKに提訴された日本IBMの反論が生々しい…仕様書に記載ない仕様が満載 biz-journal.jp/company/post_3… @biz_journalより 2025-02-17 09:13:30 リンク ビジネスジャーナル/Business Journal | ポジティブ視点の考察で企業活動を応援 企業とともに歩む「共創型メディア」 NHKに提訴された日本IBMの反論が生々しい…仕様書に記載ない仕様が満載 NHKがシステム開発を委託していた日本IBMに対し、開発の遅延による契約解除に伴い損害賠償などを求めて提訴。日本IBMはリリースを発表して反論。その内容が事実ならNHKはベンダーに対して内容的に不
３行まとめ 仕様書を渡すとリスク分析からテストケース生成までやってくれるよ ステップ単位で人が軌道修正して精度をあげて（維持して）いるよ 指摘内容や成果物からナレッジを抽出してPRを出すので賢くなる仕組みだよ ３行まとめ はじめに つくったもの ポイント① 仕様書の理解から始める ポイント② 人間が軌道修正する ポイント③ 使うほど賢くなるように 「ドメイン知識」と「テスト技術」に分けた理由 実際どうなの？ テストケースのフォーマット 課題：プロンプトやナレッジの管理・改善 おわりに はじめに こんにちは、クオリティアーキテクトグループでQAエンジニアをしている星野です。 この記事はLIFULL Advent Calendar 2025の記事になります。 QA活動でLLM、活用してますか？ 今回はテスト分析からテスト実装（テストケースの作成）までを効率化するためにつくったAIエージェントの
使用済み核燃料の保管方法を巡る調査の一般競争入札で、原子力規制庁は２９日、職員が仕様書案の作成を三菱重工に依頼する内規違反があったと明らかにした。入札では同社の案がほぼそのまま仕様書となり、入札予定価格は同社が示した見積額とほぼ同額だった。同社が１者応札で落札した。
はじめに コミューンでQAをしています金丸です。 最近QA界隈でAIを用いたソフトウェア開発が注目を集めています。 www.kzsuzuki.com 多くはChatGPTを用いたものですがちょうど先月にNotion AIがリリースされたので今回Notion AIがソフトウェア開発のテスト部分に対して有用に使うことができるかについて記事を書いていきたいと思います。 結論から言うと、実用としての運用は未だ難しいがQAの補佐的な位置付けとしては十分な働きをしてくれることがわかりました。 はじめに NotionAIとは 機能仕様から同値分割・境界値分析・フローチャートを自動で作成 機能仕様の修正もNotionAIにやっていただいた 終わりに NotionAIとは NotionAIは、Notion Labs, Inc.によって開発された人工知能モデルです。個人や仕事に関するタスクの作成、整理、管理を
どうも、佐々木と申します。今回は「Claude Code × serenaでKiro風仕様書駆動開発をやるためのカスタムコンテキスト」という事で、久々に記事を書こうかなと思います！ (AIに読み込まれる前提なので、必要な情報としっかりしたソースを情報過多なレベルで書いてます。NotebookLMだのに入れ込んで煮るなり焼くなり好きにしてください) もうすでにserenaの導入方法に関しては色々な記事がありますね、私も使い方勉強中です。 なかなか激熱なMCPサーバーなので、Kiro的な感じで盛り上がるのかな～とか思ってます。 久々に記事を書くのと、時間もなく下調べも結構いい加減なので、備忘録的な感じだと思ってみてください。間違いもガンガン指摘してくれると嬉しいです。 今回別の方のserenaの記事を見て使ってみましたが、initial_instructionsが出ないだの色々問題おきて、ちょ
Kiro、便利ですねー！ AWS（というかAmazonなのかな？）が本気出してきたなーという感じで、「仕様書駆動開発」を謳っており、まずは設計文書を作成し、タスクを整理してから、実装を始める、といったより実際の開発工程に近いフローでLLMに開発させることができます。 何よりロゴが可愛すぎる。 さっそく利用者がたくさんおり、いろんな記事が出ていますが、最初にこんな記事を目にしました。 Claude Codeとの棲み分けなどについても記載されており、大変ありがたなーと思って読ませていただいたんですが、「デメリット」の項目に記載されていたところがやっぱり気になりました。 どうせ、いづれ利用可能になるわけですが、2025/07現在ではClaude Sonnet 3.7 or 4.0しか利用できず、Opus 4.0は利用できません。 なので、仕様書などを作成させても、結局はClaude Codeで実
この記事では、Claude CodeのSkill(Agent Skill)やCIを活用して、コードベースから外部連携の仕様書を自動生成・更新する仕組みを構築した取り組みを紹介します。 はじめに こんにちは！ヘンリーで電子カルテ開発チームでエンジニアをしているわくわく(@wakwak3125 / @wakwakjp) です。 最近社内でのAI活用が進んでいており、 https://dev.henry.jp/entry/claude-code-orchestrator のような便利なSkillのおかげで開発自体の速度がぐんぐん上がっています。 一方で、まだまだ人の手で行われている部分が多いのも事実です。今回はその人力で行われていて、抜け漏れのチェックが非常にめんどくさい「仕様書」と呼ばれるもののメンテナンスを Claude Code, Skill, GitHub Actions を使い半自動化
HTML HTMLの仕様策定には複雑な歴史があります。詳細は他の解説記事に譲りますが、簡単に述べるとW3CとWHATWGのダブルスタンダード状態が長い間続いていました。2022年現在はWHATWGによってLiving Standardとしてまとめられた仕様が実質的な標準となっています。Living Standardという名前が示す通り、バージョンはなくエディターによって随時更新されています。 CSS CSSの仕様はW3Cが策定しています。現在は、CSSとして1つの標準仕様があるわけではなく、数多くのモジュールに分かれて標準仕様の策定が進められています。草案、勧告候補などを経て勧告に至るプロセスと、Levelという概念で整理されたバージョン管理が特徴です。年に1度、SnapShotとしてその時点での標準化の概況が公開されています。 JavaScript JavaScriptは主にWebブラウ
メルペイでプロダクトマネージャをしてます、さとじゅんです。 メルペイでto B向けプロダクトの開発をしてます。なので、主にto B向けプロダクトについての話になります。 たまに思うこと突然ですがPMは新しい機能を作る時は仕様書を書くことが多いですよね。 PRD（プロダクト要求仕様書）とかですね。 「Why」とか「What」とか「How」とか書きますよね。 それでリリースして運用していくと思うのですが、運用中にいろんな課題をこなしていくうちにひとつの事に気づきます。 「もう少しビジネスとシステムとオペレーションがひとつのつながりで理解できる資料が欲しいな」と。 to C向けのプロダクトに比べ、to B向けのプロダクトにはセールスやオペレーションのチームなど1つのプロダクトに関わる人が多くなる特徴があると思います。 PLGという考え方もあると思いますが、だいたいのto B向けプロダクトがto
はじめに 仕様書駆動開発（Spec-Driven Development） は、コードを書く前に仕様を明確にし、AIと人間が「何を作るか」を合意してから実装に入るアプローチです。 仕様書駆動開発のメリット 1. 作る前に認識のズレがわかる どのツールもspec（仕様）系ファイルとtasks（タスク）系ファイルを生成します。実装に入る前にこれらをレビューすることで、「思ってたのと違う」を防げます。 ツール spec（仕様）系ファイル tasks（タスク）系ファイル
API Spec を書くとそれ通りのリクエストしか受け付けないようにバリデーションしてくれて、なおかつバリデーションされた値には Spec で期待した通りの型が付いて欲しいですよね。 これを TypeScript で実現しようとすると色々と壁があります。特に API Spec と TypeScript の型を揃えるのが難しいです。 この手の課題は NestJS であればクラスフィールドとデコレータを使って解決できるのですが、制約の強い FW であるため会社の事情で採用が難しかったりもします。そこで fastify を使って同様のことを達成できるか模索してみましょう。 (※ OGP は https://www.pakutaso.com/photo/75600.html です。型、バリデータ、API Spec 三銃士感があって選びました) API 仕様書はどうあるべきか まず、フロントエンドエ
世は大インディーゲーム時代。 SteamやSwitch、それともPS5、XBOXなどに溢れんばかりにリリースされるインディーゲームに注目しているゲーマーは多いことだろう。そんなインディーゲームについて「職人的な個人、少人数の有志が個性的なゲームを作る、自由なゲーム」というイメージを抱いているのではないだろうか。 それは一面の真実だが、これは別の真実……表に出づらいインディゲームの世界をテーマとした連載である。 本連載で語られるのは、SEモバイル・アンド・オンライン株式会社（SEM&O社）の事例。同社はゲーム開発支援（SES）業務・受託開発、そしていくつかの運営、ダウンロードゲームを手がけているが、2023年に新卒中心のチームで新規にSteam向け自社ゲーム開発を行っていた。 ところが、企業がインディーゲーム開発に乗り出そうとすると個人・少数集団の開発とは異なる問題に直面する。ゲーム開発チー
「ソフトウェア設計仕様書（SDD）」の作成方法、仕様書に含めるべき内容とは：優れたソフトウェア設計仕様書を作成するためのヒント ソフトウェアの設計書は、DevOpsの時代になっても、ソフトウェア開発ライフサイクル（SDLC）の重要な構成要素として位置付けられることは変わらない。ソフトウェア設計書が重要な理由、作成方法を整理する。 ソフトウェアの設計仕様書は、DevOpsの時代になっても、ソフトウェア開発ライフサイクル（SDLC）の重要な構成要素として位置付けられることは変わらない。ソフトウェアプロジェクトに着手する前に、開発チームはソフトウェアの設計仕様を考える必要がある。 ソフトウェア設計仕様書（SDD：Software Design Document）は、プロジェクトのロードマップとしての役割を果たし、プロジェクトの達成目標や目標への到達方法をチームが総合的に判断するのに役立つ。 設計
ジェネラティブエージェンツの西見です。 Claude Codeなどのコーディングエージェントを活用するためには、的確な指示だけでなく、エージェントが生成したコードの誤りを自律的に検知・修正する仕組みが重要となります。誤り検知には自動テストやLinterが有効ですが、本記事では、仕様書とコードの「意味的な整合性」を検証するツール「Semcheck」に着目し、その性能を複数のLLMで比較評価します。 Semcheckとは Semcheckは、LLMを利用して、仕様書（Markdown形式）とソースコード間の意味的な整合性を検証するGo言語製のツールです。構文やスタイルを対象とする従来の静的解析ツールとは異なり、「仕様書で定義された要求事項がコードに正しく実装されているか」という観点から検証を行う点に特徴があります。 OpenAI、Anthropic、Gemini、Ollamaなど複数のLLMプ
仕様書を浸透させるために何が必要か？ 品質の作り込みをしていきたい・仕様を把握するコストが高いので仕様書を書くことを会社全体で浸透させたいと思っていて、そのために書く・読むの負担軽減が重要だと考えて以下をやることにした。 仕様書の項目を減らす 仕様書フォーマットの統一 仕様書の命名規則を決める 統一されたフォーマットに沿ったテンプレートの作成 管理方法の明示化・単純化 仕様書作成・更新・廃止プロセスの明示化 仕様書の具体例の作成 仕様書を書くときに迷いそうなときに参照するガイドの作成または作成の依頼 実は一回シンプルなフォーマットを決めたのだが、自分の進め方が悪くそれが全く浸透しなかった。その反省を踏まえて上記を考えた。 仕様書の話は、このあたりの話に関係する。 仕様書は必要か？ - パルカワ2 チームが品質を作り込むために必要なこととは - パルカワ2 ちなみに仕様書は、Notionで記
カケハシの AI 在庫管理でソフトウェアエンジニアをしている鳥海 (@toripeeeeee) です。こちらの記事は 生成AI研究会 での取り組み記事になります。 カケハシでは、エンジニア個々のコーディング支援に留まらず、AI技術を活用して開発プロセス全体の生産性と品質を向上させることを組織的な目標としています。そこで今回は、こちらの記事で紹介した Slack のワークフローに Devin を用いて開発プロセスにAIを載せることで、リリース前の外部仕様書のチェックをAIにサポートしてもらう取り組みにトライしましたので、ご紹介したいと思います。 なぜ外部仕様書のレビューが重要なのか そもそも外部仕様書って何？ ここで「外部仕様書」と呼んでいるのは、開発するシステムが外部からどのように見えるか、どのように動作するかを定義し、まとめています。具体的には、以下のような情報が含まれています。 機能の
のぶᴺᵒᵇᵘ @nobunobuxxxx @woody_1227 19歳以下や21歳以上は吸えないという意味じゃない。 もし年齢が下がる可能性があるなら20歳以上じゃないと吸えないとなるけど、20歳以降は上り坂しかないから20歳じゃないとでOK！ 2023-06-24 14:41:31
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
