新卒でエンジニアになった頃に学んだ、報告の書き方｜nacam403

新卒で社会人になって以来、ソフトウェアのエンジニアをかれこれ10年近くやっています。そんな私が、新卒で入った会社の最初の配属先で、上司の上司に教えられた報告の書き方について紹介します。 報告には意味を書くその人は「報告には意味を書くこと。」と常々言っていました。「ただ単にやったこと、起こったことを書いたものは"日記"。その意味を書かないとダメ。日記が許されるのは新人のうちだけ」だと。 ダメな例：「○○の設計はxx日に完了。現在は実装中。」 こういう週報を書くと、「これは日記だよ」と指摘されます。設計がxx日に完了したことが、チームやプロジェクトにとってどういう意味をもつのかが書かれていないからです。この報告は、例えば以下の様に改善できます。 改善した例：「○○の設計は、予定通りにxx日に完了。・・・」 これならば、「設計がxx日に完了 → これは予定通りである。順調である。」という意味が盛

[sep24sat]

報告書に何を書くかは、「読む人と相談して、決める」とよいです 🤨 その「相談」が「最も大切」です 🤗 相談できない時は、報告書を「何のために書かせているのか」を考えて、書くといいです 📝

[mayumayu_nimolove]

それは言葉の使い方の問題じやないかなー。予定通りかが重要ならそういう項目設ければ忘れないよね？

[komkom0428]

ナッパは悪くない。

[Palantir]

テンプレ埋めてもらった方が楽そうに見えた。難しいわね。

[hiduki001]

何が意味なのかは〜が大事。なにが必要かは相手から求めるべきで相手側がわかってないとキツい

[vbwmle]

上司の名前がついた地元の星が身内もろとも消滅したという速報を「もう少し意味が付与できるまで報告しないでおこう」とか考える部下はやっぱり怒られるんじゃねーかな

[ya--mada]

「報告を書く」ってなんだ？進捗ならチケットで良いし、文脈のないメンションなら何故メンションしたかを当然書くしなぁ…。週報とか日報はパラメータ化されていないステータス確認。この記事の考え方は納得感が無い

[retire2k]

「結論を先に書く」が一番重要なポイントだと思う。簡潔さとはそういうこと。

[yogasa]

予定に対する進捗はスケジュールに載ってれば日本語で書いてくれなくていいし、日本語にするならこれからの見通し書いて欲しいかな

[esbee]

真似してみよ『テキストエディタに報告を一文書いたあとに「それで？」と自問するように心がけていました。「○○をした。ので・・・？」と。つまりベジータの視点（報告を受ける人の視点）を想像するのです。』

[hiromi_ayase]

「それで？」とか「意味を書いて」とか抽象的な詰めをすることで簡単にマウントを取ることができる一般的なテクですね

[nelpesica]

[]

[tattyu]

issueとかPRに日記書いてる奴を見た事無くて想像して笑ってしまったw。ホウレンソウは悪い文化。

[KazuoLv1]

判断は上の人がすれば良い。本来欲しい情報を勝手に省かれる（書かれない）方が辛い

[rryu]

スケジュール調整のための進捗報告という意味では不足しているのは確かだが、本来は報告を受ける側が必要事項を明示すべきだと思う。

[morimarii]

この筆者のように「○○の設計は、予定通りにxx日に完了」が意味ある報告だと思ってる人がいて困った記憶がある。週報って個々の作業を進捗を書くドキュメントなんですか？っていうね。。。

[kagehiens]

読む人が何を知りたがっているかを分かったうえで書け、とよく言われる。読む人が暗い話は聞きたくない、と言っている場合……。／ぶっちゃけ、サマリーするべき内容が固まってないなら日記で良いよ。

[diveintounlimit]

ケースバイケースだが新人向けにはこのくらいで良いかもしれん。

[taka-p]

めも。

[yamakaz]

意味っつーか、目的や目標の類では？

[NOV1975]

これは言葉の問題なのだろうが、「予定通り順調」は事実であって意味ではない。これが意味になるのは予定が予定として共有されてないという別の問題があるからでは？

[toruhjp]

情報の構造化の練習だろう

[ducktoon]

上司の都合のいいように言質を取るために報告させられるパターンもあるので要注意

[gadie_8107]

“意味を書くには、一文書いてから「それで？」と自問する” なるほど

[wwolf]

やった事を全て列挙されても聞く方は「...で？」ってなる場面すごく多いよな。でもこれ指摘してくれる人がいないと10年選手でもやってる人いるんよな

[sippo_des]

クリアなようで難しいんだよね。 怒られないならこれでイケるはずなんだよね。やったことを怒るヤツが労働をクソにさせる。 でも理解しやすかった

[camellow]

場合によるんじゃないかなあ。それこそ同僚には「何番のプルリク〜」で済むのと同様に「○○が完了」で十分な事も多いし。場合を見極めろって話ならわかるが新人にはそれが難しかったりすると思う。

[cliphit]

週報にコピペできない形の業務日誌を5日分送りや。それは私の仕事ではありません。

[yarumato]

“当時の私は報告に事象を一文書いたあとに「それで？」と自問するように心がけていました。報告を受ける人への影響を追記するのです。事象->なので順調。…よって予定は超過しそう。…なので○○状態。”

[endok]

シンプルなのが良い。覚えとこ。