ステアリングファイルって何？

コーディングエージェントを活用したソフトウェア開発について学んでいます。私の場合、1年以上前から実践してきているものの、独学・我流が中心となっています。そのため、今回は書籍を利用して、知識の一般化を目指しています。

ステアリングファイルって何？

ある書籍を読んでいる中で出てきた疑問です。

スペック駆動開発や仕様駆動開発の中では、アーキテクチャやプロジェクト制約を記述する永続的なドキュメントと、作業計画や検討情報を記述する一時的なドキュメントがあります。その中にどんなドキュメントを踏まえるか、何を仕様と捉えるか、は様々あると思いますが、永続的なドキュメントと一時的なドキュメントの２種類を用意するのはよく見かけます。

ある書籍の中では、後者の一時的なドキュメントをステアリングファイルと読んでいました。ただ、私の認識では、永続的なドキュメントの方をステアリングファイルと認識していました。また、書籍の中で、永続ドキュメントをステアリングということがあるとも記述されていました。

少々混乱したので、インターネット上にある他の情報も調べてみました。

私の調べる限り、最も権威的な文書は、AWSが開発するKiroに見えます。

kiro.dev

Steering - CLI - Docs - Kiro

https://kiro.dev/docs/cli/steering/

Guide Kiro's AI with project-specific context through markdown documents that define your standards, architecture, and conventions

ここでは永続的なドキュメントを指しているようです。

実務的には、「ステアリングファイル」という名称が出てきた際、それがどういう性質のファイルを指しているかはその場で確認する方が無難でしょう。話者によって指している内容が違う可能性があります。

本日は以上です。