リニアウォークスルー
AIエージェントがコードベースを構造的に解説する手法で、既存コードの理解や新規開発時の説明に有用。
キーポイント
AIエージェントによるコードウォークスルーは、既存コードの理解や学習を支援する新しいエンジニアリングパターンである
Showboatツールを使用することで、AIエージェントがコード解説ドキュメントを正確に生成できる
ビーブコーディング（直感的なプロンプトによるコーディング）で作成したコードでも、後からAIによる詳細な解説が可能
このパターンはAI時代の学習方法として、スキル習得の速度低下を防ぐ可能性がある
影響分析・編集コメントを表示
影響分析
この記事は、AIエージェントがコード理解と学習支援のための構造化されたウォークスルーを生成できる新しいエンジニアリングパターンを紹介している。これは開発者の生産性向上と学習効率化に寄与し、AI時代の新しい開発ワークフロー形成の一例となる。
編集コメント
AIが単にコードを書くだけでなく、既存コードの解説者としても機能するという視点が興味深い。開発者の学習プロセス自体を変革する可能性を秘めたパターン。
リニア・ウォークスルー - エージェンティック・エンジニアリング・パターン - Simon Willison's Weblog Simon Willison’s Weblog
ガイド > エージェンティック・エンジニアリング・パターン
リニア・ウォークスルー
時には、コーディング・エージェントにコードベースの構造化されたウォークスルーを提供してもらうと便利なことがあります。
それは、あなたが理解を深める必要がある既存のコードかもしれませんし、詳細を忘れてしまった自分自身のコードかもしれません。あるいは、全体を「バイブ・コーディング」で作ってしまい、それが実際にどのように動作するのかを理解する必要があるのかもしれません。
適切なエージェント・ハーネスを備えたフロンティア・モデルは、コードの動作を理解するのに役立つ詳細なウォークスルーを構築することができます。
ShowboatとPresentを使った例
私は最近、Claude CodeとOpus 4.6を使って、Mac上でSwiftUIスライドプレゼンテーションアプリをバイブ・コーディングしました。
私は2025年11月から2026年2月までの間のフロンティア・モデルの進歩について話す予定で、講演には少なくとも一つの仕掛け（STAR瞬間 – Something They'll Always Remember）を含めるのが好きです。この場合、プレゼンテーションの最後に、スライド機構そのものがバイブ・コーディングで何ができるかの一例であることを明かす、という仕掛けにしようと決めました。
私はコードをGitHubに公開し、その後、それが実際にどのように動作するのか何も知らないことに気づきました – 私はコードが何を書いているかに全く注意を払わずに、プロンプトだけで全てを存在させてしまったのです（部分的なトランスクリプトはこちら）。
そこで、私はウェブ用のClaude Codeの新しいインスタンスを起動し、自分のリポジトリを指定して、次のようにプロンプトしました：
ソースを読み、次に、すべてが詳細にどのように動作するかを説明するコードのリニア・ウォークスルーを計画してください
次に「uvx showboat –help」を実行してshowboatについて学んでください – showboatを使用してリポジトリ内にwalkthrough.mdファイルを作成し、そこでウォークスルーを構築してください。解説にはshowboat noteを、話しているコードのスニペットを含めるにはshowboat execに加えてsedやgrep、catなど必要なものを使用してください
Showboatは、コーディング・エージェントが自分の作業を説明する文書を書くのを助けるために私が作ったツールです。showboat --helpの出力はこちらで確認でき、これはモデルがツールを使うために必要なすべてを把握できるように設計されています。
showboat note
「話しているコードのスニペットを含めるにはsedやgrep、catなど必要なものを使用してください」と指示することで、Claude Codeが手動でコードスニペットを文書にコピーすることを防ぎました。なぜなら、それでは幻覚や間違いのリスクが生じる可能性があるからです。
これは非常にうまくいきました。Claude CodeがShowboatで作成した文書がこちらです。この文書は6つの.swiftファイルすべてについて説明しています。
私はこの文書を読むだけで、SwiftUIアプリがどのように構造化されているかについて多くを学び、Swift言語自体に関する確かな詳細もいくつか吸収しました。
もしLLMが新しいスキルを学ぶ速度を低下させるのではないかと心配しているなら、このようなパターンを採用することを強くお勧めします。約40分でバイブ・コーディングされたおもちゃのプロジェクトでさえ、新しいエコシステムを探検し、いくつかの興味深い新しいトリックを拾う機会となり得るのです。
これはガイド「エージェンティック・エンジニアリング・パターン」の1章です。
このガイドの章
コードを書くことは今では安価だ
テストとQA レッド/グリーンTDD
まずテストを実行する
リニア・ウォークスルー
前へ: まずテストを実行する
原文を表示
Linear walkthroughs - Agentic Engineering Patterns - Simon Willison's Weblog Simon Willison’s Weblog
Guides > Agentic Engineering Patterns
Linear walkthroughs
Sometimes it's useful to have a coding agent give you a structured walkthrough of a codebase.
Maybe it's existing code you need to get up to speed on, maybe it's your own code that you've forgotten the details of, or maybe you vibe coded the whole thing and need to understand how it actually works.
Frontier models with the right agent harness can construct a detailed walkthrough to help you understand how code works.
An example using Showboat and Present
I recently vibe coded a SwiftUI slide presentation app on my Mac using Claude Code and Opus 4.6.
I was speaking about the advances in frontier models between November 2025 and February 2026, and I like to include at least one gimmick in my talks (a STAR moment - Something They'll Always Remember). In this case I decided the gimmick would be revealing at the end of the presentation that the slide mechanism itself was an example of what vibe coding could do.
I released the code to GitHub and then realized I didn't know anything about how it actually worked - I had prompted the whole thing into existence (partial transcript here without paying any attention to the code it was writing.
So I fired up a new instance of Claude Code for web, pointed it at my repo and prompted:
Read the source and then plan a linear walkthrough of the code that explains how it all works in detail
Then run “uvx showboat –help” to learn showboat - use showboat to create a walkthrough.md file in the repo and build the walkthrough in there, using showboat note for commentary and showboat exec plus sed or grep or cat or whatever you need to include snippets of code you are talking about
Showboat is a tool I built to help coding agents write documents that demonstrate their work. You can see the showboat --help output here, which is designed to give the model everything it needs to know in order to use the tool.
The showboat note
By telling it to use "sed or grep or cat or whatever you need to include snippets of code you are talking about" I ensured that Claude Code would not manually copy snippets of code into the document, since that could introduce a risk of hallucinations or mistakes.
This worked extremely well. Here's the document Claude Code created with Showboat, which talks through all six .swift
I learned a great deal about how SwiftUI apps are structured and absorbed some solid details about the Swift language itself just from reading this document.
If you are concerned that LLMs might reduce the speed at which you learn new skills I strongly recommend adopting patterns like this one. Even a ~40 minute vibe coded toy project can become an opportunity to explore new ecosystems and pick up some interesting new tricks.
This is a chapter from the guide Agentic Engineering Patterns.
Chapters in this guide
Writing code is cheap now
Testing and QA Red/green TDD
First run the tests
Linear walkthroughs
Previous: First run the tests
関連記事
今日のまとめ
AI日報で今日の重要ニュースをまとめ読み