プレーンテキストでAIエージェントの「思考」を設計する

Hacker Newsに「Show HN」として投稿されたこのプロジェクトは、AnthropicのClaude Code（AIコーディングアシスタント）に対して、プレーンテキストベースの**認知アーキテクチャ（Cognitive Architecture）**を定義するアプローチを提案している。92ポイントを獲得し、26件のコメントが集まるなど、AIエージェント開発コミュニティで注目を集めた。

認知アーキテクチャとは

「認知アーキテクチャ」とは、AIエージェントがどのように情報を処理し、判断し、行動するかの構造的な枠組みを指す。従来のソフトウェアアーキテクチャとは異なり、LLM（大規模言語モデル）ベースのエージェントでは、この「思考の構造」をいかに設計するかが性能と信頼性を大きく左右する。

このプロジェクトでは、その構造をコードではなくプレーンテキストで記述することを試みている。具体的には、Markdown形式のファイル群によってエージェントの役割、判断基準、作業フロー、記憶の持ち方などを定義する。

プレーンテキストアプローチの利点

このアプローチには以下のような特徴がある：

  • 可読性の高さ: 専門的なプログラミング知識がなくても構造を把握・編集できる
  • バージョン管理との親和性: Gitで差分管理が容易で、変更履歴が明確になる
  • LLMとの相性: モデル自身がテキストを直接読み込んで自己参照できる
  • 移植性: 特定のフレームワークやSDKに依存しない

CLAUDE.mdとの関連

日本のClaude Codeユーザーにとって馴染み深いCLAUDE.mdファイルも、広義にはこうした「テキストによるエージェント制御」の一形態と言える。プロジェクトルートに置かれた指示ファイルがClaudeの動作を規定するという発想は、このアーキテクチャと根底でつながっている。

今回のプロジェクトはそれをより体系化し、メモリ管理・タスク分解・自己修正ループといった認知的な要素を明示的にテキスト構造として表現している点が新しい。

AIエージェント設計の新潮流

LLMベースのエージェント開発では、LangChainやAutoGenのような複雑なフレームワークを使わずに、シンプルなテキストファイルとclaude -p（パイプモード）の組み合わせだけで高度な自律エージェントを構築する動きが広まっている。

このプロジェクトはその流れを体現しており、**「複雑なコードよりも、よく設計されたテキスト構造がエージェントを賢くする」**という考え方を具体的な実装例として示している。

ClaudeをはじめとするLLMをプロダクションで活用する開発者にとって、プレーンテキストによる認知アーキテクチャ設計は、保守性と拡張性を両立する実践的な選択肢として検討に値するだろう。

元記事: Show HN: A plain-text cognitive architecture for Claude Code