お知らせ この記事は約11分で読めます

コーディング指示書の書き方|コーダーが確認する項目と伝え方

コーディングを外注するとき、デザインデータと一緒に渡すのが「コーディング指示書」です。指示書があるかどうかで、確認のやりとりの回数も、納品後の修正の量も大きく変わります。この記事では、日々さまざまな会社からコーディングを受けているツクリコードの現場の視点で、指示書に書いておきたい項目と、伝わる書き方を整理します。

コーディング指示書とは?デザインカンプだけでは足りないのはなぜ?

コーディング指示書とは、デザインデータだけでは伝わらない動き・仕様・判断基準をコーダーに渡すための資料です。デザイナーの頭の中にある「当たり前」は、カンプの画像には残りません。

左のカンプからは見た目と配置しか分からず、ホバー・画面幅・長い文字・フォントや色・公開方法は右の指示書で伝えることを比べた図

ツクリコードに届く依頼のうち、指示書が付いてくるのは約3割です。デザインデータの中にメモ程度の指示が入っているケースもあります。制作の体制が整っている会社からの依頼には基本的に指示書があり、制作の細かい部分を社内で詰めきれない場合は、指示書がないことが多くなります。

カンプだけでは判断できず、コーダーが確認することになる代表的な部分は次のとおりです。

  • ボタンやリンクにマウスを乗せたとき(ホバー時)の変化
  • 画面の幅が広がったり縮んだりしたときの見え方
  • テキストが長くなったときの扱い(改行するか、途中で省略するか)
  • 使っているフォントとカラー、共通パーツ(コンポーネント)の範囲
  • 完成後の公開方法(FTPでアップするか、WordPressに組み込むか)

また、デザインデータそのものの「ズレ」も確認が必要になるポイントです。余白がすべて40pxなのに一部だけ38pxになっている、フォントサイズに小数点が入っている、行の高さ(line-height)が上下の余白を考えずに作られていて指定どおりにすると高さがずれる、といったデータです。デザインどおりに再現はできますが、「本当にこのまま反映していいのか」が分からないため、確認作業が発生します。指示書があれば、こうした判断を先に済ませられ、確認の往復と修正が減り、納期とコストのブレを抑えられます。

指示書がないまま依頼すると、現場ではどんなトラブルが起きる?

最も起きやすいのは、機能面や公開まわりの仕様が後から追加・変更になることです。見た目の部分はデザインデータから読み取れますが、「どこを編集できるようにするか」「どこに公開するか」はデータに表れないためです。

ツクリコードでは指示書がなくても着手前にしっかり説明して決めてから進めるため、大きな修正になることはあまりありません。それでも過去には、「ここはコードに直接書いてよい」という話で作ったものが、納品後に「実は管理画面から編集できる方がよかった」となったケースがありました。

よくあるズレ起きる理由
管理画面から編集したい箇所が後から増える更新する人・更新する箇所が決まっていない
既存サイトに追加したLPのヘッダーをどうするか決まっていない全ページ共通のヘッダーを持つサイトに入れる前提が共有されていない
アニメーションがイメージと違う「ふわっと」などの言葉が人によって違う動きを指す
修正が何度も行き来する「もうちょっと」「少し」が数値になっていない

特に多いのが、既存サイトにLPを追加するケースです。どこに入れるのか、今のサイトに影響は出るのかといった公開時の表示まわりは伝え漏れが多いため、ツクリコードではこちらから確認しています。急ぎの案件では、一つの認識違いがそのまま納期の遅れにつながります。

コーディング指示書には最低限何を書けばいい?

指示書には「どう作るか」だけでなく、「どうやって納品・公開するか」まで書いておくことが大切です。コーディングの最終ゴールは納品なので、実装から納品までの流れが見えていれば、コーダーは迷わず作業できます。

基本情報

項目書いておく内容
案件の種類新規ページか、既存サイトの改修・追加か
公開方法FTPでアップするか、WordPressに組み込むか、サーバー情報
入れる場所既存サイトのどこに入れるか、共通ヘッダーなど既存部分への影響
フォント・カラー使うフォント名、サイト全体で使う色
フォーム何を使うか、送信先のメールアドレス
納期日付と時刻、初稿の期限か納品の期限か

デザインの共通ルール

どこがコンポーネントか、ホバー時の動きは何か、といった要件が書いてあると作業がとても進めやすくなります。さらに「38pxなど半端な数値は40pxにそろえてよい」「余白は4の倍数にそろえてよい」のように判断基準まで書いてある指示書は、実際に受け取ってとても分かりやすかったものです。

WordPressの場合

カスタム投稿(通常の投稿とは別に作る記事の種類)とカスタムフィールド(記事やページに追加する入力欄)が必要かどうかを書きます。カスタム投稿は、お知らせやちょっとしたコラムが付いたLPで頼まれることが多い機能です。カスタムフィールドは、数字や毎週変わる情報など、決まった部分だけを管理画面から書き換えたいときに使われ、「ここの数字を入れ替えたい」という依頼が最も多くなっています。誰がどの部分を更新するのかを書いておくと、後からの追加を防げます。

動き・アニメーションはどう書けば伝わる?

動きは、きっかけ・方向・速さ・範囲を書き、参考サイトのURLを添えると伝わります。言葉のニュアンスと実際のアニメーションは、思った以上にずれやすいからです。

動きの指示は1きっかけ・2方向・3速さ・4範囲の4つを番号つきの箱で示し、その下に参考サイトのURLを添えることを強調した図
あいまいな書き方確認が必要になる点
下からゆっくり出るどんなフェードか、速さはどれくらいか
文字が下から出る文章全体がまとめて出るか、一文字ずつ出るか
くるっと回る裏表が回転するか、90度か、一回転か

ツクリコードでは、実際にその動きを使っているサイトを見せたり、その部分だけ簡単に作って見せたりして、「このイメージで合っていますか」と確認してから作ることが多くあります。指示書の段階で参考URLや画面録画があれば、この確認を短くできます。

こだわりがない部分は「おまかせ」と書いておくのも有効です。たとえばツクリコードでは、ホバーの指定がない場合は「薄くする(opacity)」で実装し、あとで確認してもらっています。

スマホ版のデザインがない場合、指示書には何を書けばいい?

スマホ版のデザインがない場合は、並べ方の方針と、崩したくない部分だけを書いておけば十分です。基本は、PCで横に並んでいる要素を縦に積む形になります。ただし内容によってはスライダーや横スクロールの方が見やすいため、ツクリコードではこれまでの実績をもとに判断して組んでいます。

「SPはおまかせ」で依頼される場合でも、次の点は指示書に書いておくか、着手前に確認しておくとスムーズです。

  • 横並びの要素を縦に並べてよいか
  • 記事一覧など縦に長くなる部分を、横スライダーにしたいか
  • 画像とテキストの順番を入れ替えたい箇所があるか
  • ハンバーガーメニューのデザインがあるか、おまかせでよいか
  • ファーストビューの画像を縦長の画面用に用意できるか

実際は「よしなにお願いします」と言われることがかなり多く、何か所か確認したうえで一度作って見てもらい、気になる部分を修正する流れが一般的です。デザインにない部分は、どの画面幅でも不自然な改行やズレが出ないよう、画面幅に合わせて伸び縮みするレイアウト(リキッドレイアウト)で実装します。記事タイトルなど長くなりやすいテキストは途中を「…」で省略するなど、WordPressで編集されることを前提にしています。

なお、ツクリコードのセクション料金にはPC・スマホのレスポンシブ対応が含まれており、スマホ版のデザインがなくても金額は変わりません。

指示書はどんなツール・形式で作るとやりとりがスムーズ?

指示書は、Figmaなどのデザインツール内のコメントか、スプレッドシートで作るのがスムーズです。実際にツクリコードが受け取る指示書も、この2つが圧倒的に多く、たまに文書ファイルで届く程度です。

形式向いている内容
デザインツールのコメントカラー、フォント、ホバー、コンポーネントなど、デザインの該当箇所と結びつく指示
スプレッドシートページ一覧、ディレクトリ構成、要件、修正の管理
文書ファイル案件の前提や全体方針の説明

素材の差し替えや修正が出たときは、スプレッドシートの修正指示管理表で、対象ページ・URL・内容・状況(依頼中・作業中・作業済み)を一覧にしてもらえると最も分かりやすくなります。ほかにも、「画像を差し替えました」と書いて該当箇所のFigmaのリンクを添える、Gyazoのように画面を囲んだスクリーンショットをURLで共有できるツールで「ここです」と示す、といった方法も有効です。どの部分の話か一目で分かり、最新版がどれか迷わない状態を作ることがポイントです。

急ぎの案件でも、指示書は最低限どこまで用意すべき?

急ぎの案件では、デザインデータ・テキストや画像の素材・納期・公開環境の4つがあれば着手できます。細部が決まっていない部分は「未定」「後から差し替え」と明記しておけば、作業を止めずに進められます。

急ぎの案件で着手に必要なデザインデータ・素材・納期・公開環境の4つをチェック印つきの箱で並べ、決まっていない所は未定と書くことを示した図

ツクリコードは緊急案件を専門に受けており、当日着手にも対応しています。依頼が来たらすぐにデザインと要件を確認し、データを見てすぐ判断できるものはそのまま作業に入ります。判断が難しいものは緊急で打ち合わせをして調整します。急ぎの案件は足りない素材や情報があることが多いため、メッセージのやりとりより打ち合わせの方が早く、話しながら作業も進められます。

行き違いが最も起きやすいのは、あいまいな表現を残したまま進めることです。

  • 「今日中」は、今日の何時までか
  • 期限は初稿の話か、納品の話か
  • 「もうちょっと縮めたい」「少し小さく」は、何pxか、どこに合わせたいのか

数値などで目標をはっきりさせておけば、修正の行き来に時間とコストがかかることを防げます。なお、緊急案件でも追加料金はかかりません。契約は基本的に契約書を交わし、特急案件では正式な手続きを着手と並行して進めることもあります。

コーディングを外注するとき、指示書と一緒に確認しておくことは?

指示書と一緒に、見積もりの単位と料金に含まれる範囲、そして公開時の段取りを確認しておきましょう。見積もりはページ単位の会社もあればセクション単位の会社もあるため、どこまでが料金に含まれるかを先にそろえておくことが大切です。

ツクリコードの料金は1セクション5,000円からで、カスタム投稿・カスタムフィールドはそれぞれ15,000円です。

あわせて確認しておきたい項目は次のとおりです。

  • 修正対応の範囲と、修正の伝え方
  • 初稿を出すタイミング
  • 納品形式と、公開作業を誰が行うか
  • サーバー情報、既存サイトのリニューアルならディレクトリの変更による影響
  • お問い合わせフォームの送信先と、管理画面で編集できる範囲

公開時のトラブルは非常に多く、消してはいけないものを消してしまったという話もあります。こうした裏側の部分は、納品前ではなく最初に決めておくべき内容です。

ツクリコードでは納品前に、デザインと重ねて差分を見るツールでの確認、画面幅やブラウザごとの表示確認、リンク切れやセマンティックHTMLなどSEOに関わる部分の確認を、自社のチェックリストで行っています。お問い合わせフォームは、Gmailなどセキュリティの強いメールサービスにも届くか、スパム対策の仕組みが無料で使える範囲の条件変更に合っているか、そのスクリプトをフォームのページだけで読み込んでいるかまで確認します。品質チェックシートに沿った目視確認に加え、ルールを定めたうえでAIも活用し、人の目では気づきにくいミスも拾っています。AIに任せきりにはせず、最終的には自分たちでも確認しています。

まとめ:指示書は誰のために、どこまで書けばいい?

コーディング指示書は、きれいであればあるほど、依頼する側にもコーダーにも良い結果をもたらします。何十件と続けて依頼をいただいている会社とは、「これでお願いします」「では初稿はこの日に出します」程度のやりとりで、ほとんど確認なしにサイトが完成する状態になっています。指示書は完璧でなくてもかまいません。判断が分かれる部分を先に言葉にしておくことが大切です。

  • 指示書はデザインデータに残らない動き・仕様・判断基準を伝える資料
  • 見た目だけでなく、公開方法・既存サイトへの影響・編集できる範囲まで書く
  • アニメーションは参考URLを添え、「もうちょっと」は数値で伝える
  • スマホ版は並べ方の方針と崩したくない部分だけ指定すれば十分
  • 形式はデザインツールのコメントかスプレッドシートが進めやすい
  • 急ぎの場合は、決まっていない部分を「未定」と明記して先に着手する

ツクリコードの代表は現役のコーダーで、個人として500件以上を納品してきました。さまざまな会社の指示書を見てきた経験から、指示書がない場合や作り方が分からない場合も「こういう形で進められます」とご提案できます。指示書づくりから相談したい方はお問い合わせから、費用の目安は料金ページからご確認ください。

この記事を書いた人

串本 拓馬株式会社ツクリコ 代表取締役

  • 納品実績500件以上
  • 現役のコーダー
  • 新聞・テレビ・ラジオ出演

代表自ら現場でコーディングを担当し、これまでに手がけた納品実績は500件以上。公開直前の緊急案件を中心に、制作会社やデザイナーの外注パートナーとしてサイト制作を支えている。大手電力会社で社会インフラを支える仕事に携わったのち、2021年にWeb事業を開始し、2024年に株式会社ツクリコを設立。産経新聞やMBSラジオなど、メディアへの掲載・出演も多数。

運営会社・代表メッセージを見る

Contact

急ぎの案件こそ、今すぐご相談ください

24時間365日受付・即日着手・緊急料金なし。
もちろん通常納期のご依頼や、お見積りだけのご相談も歓迎です。

お電話でのご相談:06-6125-5676

料金シミュレーション 今すぐ相談