← 2026-09-23 の一覧へ戻るホーム
/src に Markdown

2026/09/22 7:47

/src に Markdown

RSS: https://news.ycombinator.com/rss

元のHacker News記事へ ↗
要約▶

日本語翻訳:

要約：本文は、人間による編集されたマークダウンを単なるドキュメントではなく、主要なソースコードとして扱うことを提案している。仕様を実装と並行して 

/src/md
ディレクトリに保存することで、意図とコードの近接性を確保し、書かれた仕様が一時的なプロンプトや生成された出力ではなく「真実」として機能させようとする。LLM はマークダウンをネイティブとして読み書きするため、プルリクエスト内で専門的なツールを使わずに直接変更を見直すことができる。Linear や Jira、ウィキ、Slack といったツールはプロセス指向または高レベルのデータを処理するが、コアなシステム挙動は 
/src/md
に存在させることで論理の透明性を保ち、不透明でマシン専用のアーティファクトを避ける必要がある。提案された構造には 
README.md
、
OVERVIEW.md
および機能、データ、API、インフラストラクチャ用のオプションサブディレクトリが含まれる。このディレクトリのマークダウンは人間によって作成・管理され、エージェントがここでほとんどのコンテンツを生成すべきではない。テストは別個に（例：
/test
）保持され、マークダウン仕様に由来し、その正しさを確認する。
/src/md
の責任ある管理には「複雑性予算」を導入してドキュメントを清潔で適切にファクタリングし維持することが必要であり、マークダウンの制約とそこから導かれるコードとの同期は、システム整合性を維持するための重要なスキルとなる。

本文

マークダウンは新たなソースコード：エージェント型コーディング時代の新しい「真実」の在り方

カーソン・グロス 氏による提言では、マークダウンは単なるドキュメントではなく、ソフトウェアのソースコードそのものへと進化しているとされています。特に「エージェント型コーディング」（LLM を活用した自動コード生成）が普及する中で、以下の転換点が強調されています。

  • マインドセットの転換: 開発プロセスにおいて、一時的なプロンプトセッションからではなく、永続化するマークダウンファイルからコードとテストを生成すべきです。
  • 保存の原則: LLM が生成したコードはコンパイル後のマシンコードのように扱い捨ててよいという見解ではなく、生成元のマークダウンを 
    /src
    ディレクトリにチェックイン    し、それがシステム唯一の真実（Source of Truth）となることが重要です。

以下に、その考え方や具体的な構成案を整理します。

背景：エージェント型コーディングとコンパイラとの比較

コンパイラとの類似性と相違

  • コンパイラのワークフロー:
    • オリジナルのソースコードが常に保存される。
    • コンパイル後のマシンコードは生成元を参照せずとも動作する。
  • LLM（エージェント）の現状:
    • 開発者がプロンプトを与え、LLM が直接コードを生成する。
    • 問題点: 多くの場合、プロンプト履歴が捨てられ、生成されたコードだけが真実（Ground Truth）になる。しかし、そのコード自体には意図や設計の文脈が含まれていない。

現在の課題

  • プロンプトセッションは一時データであり、システムの本質を捉えきれていない。
  • 機能の「真実」が Linear や Slack スレッドなどの外部ドキュメントに散らばっている。

結論として: マークダウンファイルを生成されたコードと共に 

/src
に保存し、それらを正式なソースとして扱う必要がある。

マークダウンをソースコードとして扱うメリット

マークダウンは伝統的なソースコードと同様の優れた特性を備えています。

技術的・実践的利点

  • 人間と AI の両者で扱える:
    • プレーンテキストであるため、差分表示（Diff）、検索（Grep）、レビューが可能。
    • LLM はこれをネイティブに読んだり書いたりできる。
    • 人間も特別なツールなしに編集・閲覧可能。

すでに機能している役割

  • AGENTS.md
    （エージェント指示書）
  • SPEC.md
    （仕様書）
  • PLAN.md
    （実装プラン）
  • TASK.md
    （タスク定義）

これらは既に事実上のソースコードとして機能しており、標準化された保存場所へ移行すべきです。

具体的な導入案：
/src/md
ディレクトリの設定

ハートリー・ブロディ氏の提案にある 

.scratch/
や 
/tmp/
といった一時的な置き場ではなく、既存のソースコード隣接に永続化する 
/src/md
 を作成し、低レベルな設計決定事項を格納します。

キャプチャすべき内容（アーキテクチャレベル）

  • アーキテクチャ上の意思決定。
  • ソースコードレベルでの実装選択の理由。
  • データモデルの構造や意図。

これらは従来の高層な設計ドキュメントよりも低レベルですが、完全な仕様書ではない中間的な位置づけを持ちます。

「近接性の原則（Locality）」の利点

  • 意図の共有: コードモジュール自体にその意図を説明するマークダウンが含まれるようになる。
  • コンテキストの集中: 論理の「なぜ」が外部ツール（Notion, Confluence, Jira など）に散らばるのを防ぐ。
  • エージェントの自律性: エージェントが外部を調べて文脈を取得する必要が減る。

注: より高レベルな設計やプロセスフローについては Linear やウィキなどを併用できますが、システムの静的動作に関する真実の源泉は 

/src/md
に集約するべきです。

ソースコード、マークダウン、テストの関係性再定義

従来の「コードのみ」か「ドキュメント＋コード」とかの二分法ではなく、以下の役割分担を提案します。

推奨される役割分担

  1. 仕様の代わり（Spec）
    • 場所: 
      /src/md
    • 内容: システムが何を行うべきか、なぜそうするかという意図と設計決定事項。
  2. 検証の自動化
    • 場所: 
      /test
      (または適宜)
    • 内容: 
      /src/md
      に記述された仕様に基づいて作成され、正しさを確認するテストコード。

プロンプトからの脱却

  • ❌ 非推奨: プロンプトから直接コードとテストを生成する（文脈が失われるため）。
  • ✅ 推奨: 開発者が 
    /src/md
    に意図を書き込む → そこからエージェントへコードとテストを導き出す。

/src/md
の運用規約と構造案

複雑性予算の管理

  • ソースコード同様、マークダウンも「複雑性予算」が適用されます。
  • ドキュメントはクリーンでファクタリングされ、適切な抽象化レベルを維持するよう厳格に管理する必要があります。
  • 開発者は生成されたコードに対して変更を加えたら、その意図をマークダウンにも反映（同期）させるスキルが必要となります。

エージェント生成の制限

  • /src/md
    の大部分は、人間によって作成・管理されるべきです。
  • 完全な自動化は避け、人間の判断による意図の記録を重視します。

提案されたディレクトリ構造

以下の構造案で、モジュールの異なる側面（機能、データ、API、インフラ）を軸に分けて記述することを推奨します。

src/
  md/
    README.md          # すべての md ファイルの目次、エージェントのエントリポイント
    TODO.md            # 未実装項目の一覧
    OVERVIEW.md        # モジュール技術概要
    
    features/          # 機能固有のドキュメント群（オプション）
      FEATURE_1.md
      ...
    
    data/              # データモデルの説明（オプション）
      DATAMODEL_1.md
    
    api/               # API の仕様説明（オプション）
      API_1.md
    
    infrastructure/    # 使用インフラストラクチャの説明（オプション）
      INFRASTRUCTURE_1.md

結論：意図こそが真の価値

LLM の進化によりコード生成のコストは低下していますが、残る価値あるものは「意図」です。

  • 何を行うのか
  • なぜそれをするのか
  • 何をすべきでないのか

これらは一時的なプロンプトや散在するスレッドで失われがちですが、

/src/md
としてキャプチャすることで、人間もエージェントも容易に参照できるようになります。

マークダウンはソースコードへと変化しており、これからもそのように扱うべきです。（もちろん、LLM が完璧なコンパイラではないという点は踏まえて運用してください。）

同じ日のほかのニュース

一覧に戻る →

2026/09/23 1:29

Claude Opus 5.5

## Japanese Translation: Anthropic は、新しい Claude 5.5 ファミリーにおける初モデルである Claude Opus 5.5 を導入しました。このモデルは、エリート「Fable」モデルと同等の性能を維持しつつ、大幅なコスト削減（一般的なタスクでは最大 40% のコスト低減、特定のコーディングタスクでは出力速度向上に伴い約 51% のコスト削減）を提供します。このリリースは、Anthropic が「フロンティアを調整する」という戦略的転換を示すものであり、外部評価機関である Frontier Design と METR による検証也得到了確認です。性能向上により、企業は数週間かかっていた大規模なコード移行を数日（例：68 万行のコード移行が 1 日以内に完了）で実行可能にされ、約 40 の複雑な Web ページの読み込み時間を改善できます。 安全性とセキュリティは最優先事項であり、Opus 5.5 はアライメントスコアの向上、プロンプトインジェクションに対する耐性、そして不可逆的な動作が起きる可能性の低減を示しています。サイバーセキュリティ対策として、Fable 5.1 と同等の safeguards が導入されており、多くのタスクは高レベルのセキュリティを持つ Opus 4.8 ルートされ、Cyber Verification Program を通じてアクセス範囲を拡大しています。生命科学のような専門分野も、Life Sciences Verification Program により高度な生物学安全プロトコルを利用できます。価格設定は Opus 5 のレートから引き下げられ、100 万トークンあたり $4/$20 と変更されました。これにより、アジェンティックコーディングタスクにおけるハイエンド性能が、以前のコストのわずか几分额で利用可能となりました。さらに、すべてのプランの購読ユーザーには、5 時間の使用制限増およびレートリミットのリセット特典が提供されます。最後に、ディストイテーション攻撃を緩和するため、2026 年 8 月 31 日以降に新規作成された API アカウントでは「保存された思考」機能が有効化され、トップティアモデルと同等の堅牢なサイバーセキュリティ対策が確保されています。結局のところ、このリリースはエリート AI 能力を民主化し、コスト削減の大幅増、セキュリティの強化、および事業拡大準備のある企業にとっての運用柔軟性の向上をもたらします。

2026/09/23 2:46

「我々はFBIをハッキングした」：ハッカーたちは、彼らがFBIのすべての職員に関するデータを入手していると主張している。

## Japanese Translation: ShinyHunters というハッキンググループは、複数の FBI 関連サービスの侵入に成功し、全ての現在在职員および申請者に関する包括的なデータを盗んだと主張している。同グループの代表者は 404 Media にこの事案を確認した上で、「盗まれた情報には、氏名、自宅住所、電話番号、エージェント配偶者に関するデータなどといった個人情報も含まれている」と述べている。今回の漏洩は深刻なものであり、ShinyHunters は国家安全保障や対諜報活動への危害を目的としてデータを悪用することが知られているため、もしこのデータが悪意ある行為者に入手されると、FBI の職員が物理的な安全に直ちに脅かされ、国外の諜報機関が Am りカンの運用手法を理解するために今回の侵入を悪用する可能性もある。また、同グループのネットワーク内に存在する犯罪者は、過去に盗まれた記録を利用して法執行官を物理的に特定・追跡し、威嚇しており、エージェントとその配偶者に対して深刻な脅威となっている。専門家らは、FBI の職員や内部関係者に対し、直ちに Signal（ID: joseph.404）または電子メール（joseph@404media.co）を通じて 404 Media に連絡するよう要請している。今回の侵入の具体的な範囲に関する詳細な技術情報は、404 Media プラットフォームの有料会員（あるいは同プラットフォームの無料会員）のみが閲覧できるまま制限されている。

2026/09/22 22:52

OpenAI の GPT–6「Astra」が、2005 年以来解決されなかったエニグマの暗号文を解読した

## Japanese Translation: 2026 年 9 月 15 日、GPT–6 Astra は、1941 年 7 月 10 日に送信されたドイツ軍エニigma暗号の文 MVUEH を成功裡に復号化し、2005 年以来続く謎を解決した。カーター・レファーは、AI にクリプトセルラーリサーチウェブページの未解読メッセージを分析させるよう指示を与えたところ、AI は MVUEH（Nr. 172）を選択して対象とした。AI は独自に開発された Python および C++ ソフトウェアを使用してエニigmaの設定をシミュレートし、以前に解決済みの文 Nr. 173 (SIPVX) との関係性を特定するとともに、平文のパターン「ROSENOW ROSENOW」を crib（推測文）として利用した。最も重要なのは、AI が暗号文における微妙な転記エラーを検出した点であり、その中には第 72 の文字で発生した異常なローターの回転など、以前の人間による試みを阻害しかねる要因が含まれていた。従来の同様のメッセージに対する失敗が鍵の未考慮や差異などに起因していたのに対し、Astra はこの独特なローター構成および不具合を 2 日以内に克服し、人間研究者が数ヶ月かかる結果を得た。復号化の後、研究者たちは連邦アーカイフ（特に巻 RS 3–3/20a および RS 3–3/63b）から関連するアーカイブログを発見し、残りの無線電文の全巻について分析を完全に自動化した。フロデ・ヴァイエルユッドのような専門家らは、以前は数ヶ月かかっていたタスクが数日で完了したことは事実であるが、AI は専門家の暗号解析官にとって強力なパートナーでありながら、絶え間ない人間の介入を必要としないとして指摘した。9 月 19 日のアップデートでは、この成果を「非常に驚くべきこと」と形容し、ヴァイエルユッドは同様の画期的成果に感銘を受けていることを表明した。