この記事について新卒未経験でエンジニアになり、CRE（Customer Reliability Engineering）として、お客様からの問い合わせを調べて答える仕事をしています。「メールが届かない」「画面が崩れる」「この件数を出してほしい」といった依頼を、コードと本番データベースとログを見て、原因まで詰めて返す役割です。調べた結果は、社内の担当者に報告書として渡し、そこからお客様への回答になります。調査には AI を使っていて、この記事の話はそこにも関係します。「メールが届かない」という調査で、あるとき私は報告書に「バウンス記録はありません」と書きました。お客様に送ったメール...

こんにちは、TOKIUMの花房です。Claude CodeとCodexを併用していると、少しずつ仕様の差を埋めるために、変な工夫を強いられます。私の環境でも、Claude Code用のrulesに書いた手順をCodexへどう渡すかが問題になっていました。そこで、今回は潔くClaude Codeのrulesを全廃し、共通の指示はAGENTS.mdとAgent Skillsだけへ置くことにしました。ちょうど、XでShopifyのCEOが、Claude CodeがAGENTS.mdと.agents/skillsを読むようになるまで、Shopifyでの使用禁止を考えていると投稿していました...

はじめに仕事とは問題解決です。読者の多くは、システムやプロダクトを作り、それによって何らかの問題を解決することで対価を得る仕事をしているはずです。問題解決の現場でよく起きるのが、「あと1年と1億円くれればできますが」みたいな話ですよね。当然、リソースの獲得という課題は解くべきものです。足りないまま「なんとか頑張って」で押し切るのは、くふうではなく無茶振りです。ただ、リソースの見積もりに入る前に、一つ挟んでほしい問いがあります。最初に思いついたやり方でToDoを積み上げているだけではないか、という問いです。今回は、都営浅草線のホームドアを題材にします。都営地下鉄の他の3線と...

どこまでAIに任せていいのかAIで開発を自動化した、という話をよく見かけるようになりました。有名な例では、OpenAIはCodexを使い、5か月で約100万行のコード、約1,500件のプルリクエストという驚異的なペースで新規プロダクトを開発しました。人間によるレビューは必須ではなく、エージェントが自分の変更をマージするところまで任せています。https://openai.com/index/harness-engineering/また、Vercelが2026年6月に公開したイベントレポートでは、Shopifyは低リスクなプルリクエストの60〜70%を自動でレビューし、開発者が...

!想定読者RailsやLaravel、DjangoのようなActive Record型のORMでモデルの肥大化を経験した人RepositoryやDDDの考え方を取り入れるべきか試行錯誤している人Data Mapper型の構成を検討している人この記事で紹介することモデルの責務を分割する判断と、モデルを保存形式から独立させる判断を分ける基準Active Recordのまま責務を分けた事例と、Data Mapperで分離した事例で何を得たか次の改修でActive Recordを使い続けるか分離するかを決めるときに確認する事項Active Recordのモデルを使って...

!この記事は何の話か（3 行まとめ）AI（Claude Code）が失敗するたびに教訓を1ファイル1パターンで記録する運用を数ヶ月続けたら228件たまったので、全件を分類集計しました教訓の大半は「Yする前にXせよ」「XはYではない」の2つの構文に収束しており、規律系の失敗の根本原因は3つ（代理シグナルの過信・否定の早撃ち・浦島太郎現象）しかありませんでしたdb:prepare が exit 0 なのに作成テーブル0件、復元不能バックアップ、敵対検証エージェントの指摘が全部偽陽性、といった実例と、再発防止策（行動ルール→Hookによる機械強制→本番経路の定期実走）をどう積んでい...

!この記事は何の話か（3行まとめ）Claude Codeを複数窓同時に走らせると、タスクの二重着手・成果の取りこぼし・設定ファイルの上書き事故が起きます。それを防ぐために1年弱かけて作った自作機構Foremanの「内部機構編」です（成り立ちと定量効果は前作）起点セッション（orchestrator＝幹）が自分で新しいClaude Codeセッション（worker＝葉）を起動して命令を出し、追記専用の台帳（ledger）だけを介してタスクを配り・回収します。ロックは使わず、advisory（緩い自己申告）で衝突を検知します実際にハマった事故（workerの完了申告と成果物の実在が...

Lenny's PodcastにAnthropicのLabsチームのプロダクト責任者、Dianne Pennさんが出た回に、印象的な言い回しがありました。彼女のチームには「evalは新しいPRDだ」という合言葉がある、というのです。https://www.lennysnewsletter.com/p/anthropics-first-technical-pm-onユーザーフィードバックから失敗のパターンを突き止め、それを再現する評価セット（eval）を書く。それがPRDに代わって、ユーザー価値を定義する成果物になっている、という話です。たとえば初期のClaudeは、JSONを頼まれ...

こんにちは、TOKIUMでエンジニアをしているFatherScorpionです。最近はオンラインゲームのランクマッチに熱を入れています。今回は「業務ループ」という考え方のご紹介と、自分の仕事と日常に当てはめてみた話をします。 業務ループとは？改めてですが、業務ループとは何でしょうか？自分がこの単語を初めて耳にしたのは、弊社CTOの西平さんが「AI DevEX 2026」で登壇されるのをお手伝いした時です。以下のリンクにスライドが公開されています。https://speakerdeck.com/nishihira/aigadang-tariqian-nozu-zhi-de-en...

こんにちは。TOKIUMでエンジニアをしている伊藤です。私たちのチームでは、請求書をAIで読み取り、品名・数量・金額などを明細情報としてデータ化する機能を開発しています。今回は、その機能で利用しているGeminiのバージョンアップ検証中に起きた問題について紹介します。!※ 執筆時点（2026年9月）の情報です。モデルの挙動や仕様は今後変更される可能性があります。 ある日、日本語の品名だけが空欄になったGemini 2.5 Flashの廃止アナウンス[1]を受け、新バージョンへの移行検証を行っていたときのことです。ある請求書のテスト結果を見ていて、奇妙な異変に気づきました。...

AI に任せた調査の初動が、「顧客が手入力した」と自信満々に断定しました。しかし実データ（別テーブルの申請時刻）と突き合わせると、真因は正反対 —— 「システムの自動補完」でした。55ミリ秒差・同一トランザクションが、その初手を覆したのです。AI に調査を任せる人は増えています。でも、返ってきた結論を、本当に確かめているでしょうか。私は入社して数ヶ月、コードもろくに書けません。それでも —— いや "だからこそ"、ベテランしか解けなかった CRE 調査 —— 顧客の「このデータはなぜこうなっているのか」に、DB・ログから答える仕事 —— を、AI に任せられる "仕組み" にしました...

TOKIUM でエンジニアをしている shinonomelon です。Raycast は macOS のランチャーアプリです。アプリの起動や検索だけでなく、クリップボード履歴、スニペット、ウィンドウ操作まで、キーボードから手を離さずに済ませられます。Raycast そのものの導入と設定については、同じ Publication の「手作業を削るための Raycast 設定集」に詳しくまとまっています。まだ使っていない方や、設定を見直したい方は、ぜひ参考にしてください。https://zenn.dev/tokium_dev/articles/21d7e178362377Mac の...

はじめにはじめまして、株式会社TOKIUMの齋藤です。今年新卒で入社した、配属2ヶ月弱の駆け出しエンジニアです。日々の開発では Claude Code をフルに使っています。特に迷うのは、実装方針の提案と工数の見積もりです。自信満々な文体で、きれいに構造化された回答が返ってくる。根拠を問い詰めることもありますが、正直、多くはそのまま信じて進めてきました。毎回は疑いきれないからです。ただ、信じた前提が外れていれば、そこから先に進めた時間はそのまま手戻りになる。それが怖い。実際、自信のある断定の文体は、裏を取ったことを保証してくれません。追及して初めて「推測でした」と返ってくることも...

ただ音楽を聴いていた日常のデータに、Spotifyの「Wrapped」は「振り返る面白さ」を与えてくれました。特別な記録をしなくてもいつの間にかログが溜まり、自分だけの1年が見えてくる体験です。あの手軽さのまま、音楽だけでなく「本の抜き書き」も「Podcast」も「紙面のスナップ」も、日常のあらゆるインプットがまとめて振り返れたらどうだろう。——そんな好奇心で作ったのが「Scraps」です。名前は文字通り「スクラップ」。Web記事も、Podcastも、紙の本の一節も、思ったときにiPhoneからポイポイ投げておくだけ。AIのサマリと共に「ひとつながりのログ」になって手元に溜まってい...

はじめに：エンジニアになった経緯はじめまして！株式会社TOKIUMでエンジニアをしている、えしらと申します。この春入社し、未経験からエンジニアになりました。人生初めてのテックブログは、小学生の頃からずっと好きな初音ミク[1]をテーマに書いてみることにしました。特に初音ミクの創作文化とライブが好きで、絵を描いたり、グッズを自作したり、DJしたり、ライブを見るために津々浦々を旅したり、いろいろなことをして生きています。毎年夏に開催されるマジカルミライ[2]には、高一で初めて参加した「マジカルミライ2019」で心をつかまれてから、ずっと通っています。マジカルミライでは、毎年プロ...

はじめにTOKIUM でエンジニアをしているちっちです。26卒として入社し、現在は2ヶ月の研修を経て開発に取り組んでいます。突然ですが、今お使いのCLAUDE.mdは何行ありますか？以前、中身を整理した方も気づくと膨れ上がっていませんか？かくいう自分も研修を終えて数週間後、ふとCLAUDE.mdを開いてみると378行ありました。しかも、そこに書いてあることを自分でも半分くらい覚えていません。書き足すたびに便利にしているつもりが、実際にやっていたのは自分でも把握できていないものを Claude に毎回読ませることでした。 整理しても、静かに崩れていく公式ドキュメントには...

どうも、TOKIUMで新卒エンジニアとして働いているマーガリンです。この記事では、新卒エンジニアとして働く中で、日々感じていることを書いてみます。おそらく経験のあるエンジニアの方ならできていることだと思います。あくまで一人の新卒エンジニアとしての個人的な所感なので、「そういう考え方もあるんだな」くらいの気持ちで読んでもらえれば幸いです。 「昨日実装した内容、どう動いてるか説明できますか？」いきなりですが、昨日実装した内容について、こんな質問をされたらどうでしょうか。「その実装、どう動いているんですか？」みなさんは、自信を持って答えられるでしょうか。僕自身、正直、自信...

はじめに：Claudeの口癖は「落ち着いてください。」こんにちは、TOKIUMの中谷です。今年の4月に、開発完全未経験のまま新卒で入社しました。2ヶ月の開発研修を経て、いまはチームに配属されて1ヶ月の新人エンジニアです。研修のチーム開発は、思いきり試して、思いきり失敗できる場所でした。Claude Code（以下 Claude）をフル稼働させてどんどんPRを出し、バグが出たら直して、また学ぶ。壊しても困らない環境だったからこそ、慎重という言葉とは無縁でした。それが配属された途端、一変しました。その先に本物のお客様がいるプロダクトのコードを触るとなると、ものすごく軽微なバグ修正の...

はじめにTOKIUMに新卒エンジニアとして入社した「なる」です。7月からオペレーションシステム開発部に配属されました。私のチームでは、お客様に代わって請求書などの書類を取得し、アップロードするまでのシステムを開発しています。5月に開発研修が始まり、2ヶ月間で個人開発とチーム開発を経験しました。それでもまだまだ知識も技術も追いつかず、配属された今もキャッチアップに必死な毎日です。そんな私が本配属後に最初に取り組んだのは、自分から提案して開発したSlack botでした。本記事では、開発を始めたばかりの視点から、そのbotをどう提案し、どのように改善して育ててきたのかをまとめていき...

!この記事は何の話か（3行まとめ）膨大なインプットに溺れる新卒未経験エンジニアの私血迷ってダサいデザインのHTMLを生成させることにした流し読みできず一言一句読むようになり、思いの外、インプットが進んだ人に読んでもらうには、どんな形であれ資料に魂を込める必要がある。こんにちは。株式会社TOKIUM 26卒未経験エンジニアのタケノコご飯です。今回は、配属後に自分用のインプット資料を作っていて直面した困難と、乗り越え方、そして学んだことを記事にしてみました。新卒エンジニア、未経験の方はもちろん、資料作りをするすべての方に読んでいただきたいです🌷※本人は至って真面目です...