ルールは一度書けば、すべてのエージェントが読む。
プロジェクトのルール、チェックリスト、リファレンスは、「ロール」の中にドキュメントとして置かれます。プロジェクト全体向けにも、1つのロール向けにもできます。ロールのドキュメントからリンクされます。
Role documents 2
NewUpload .mdOnly this role sees these, together with the project documents; a role document with the same name replaces the project one.
empty-statesv1空の状態リスト、表、検索を作る前に読む：何もないとき、何を表示するか。
ui-kitv2UI キットUI を変更する前に読む：ショップで使うボタン、入力欄、色、余白。
From the project 2
api-conventionsv3API の規約エンドポイントを追加・変更する前に読む。
ui-kitv1UI キット
一度書く
プロジェクト向けにも、1つのロール向けにも。
プロジェクトのドキュメントはすべてのロールに届き、ロールのドキュメントはそのロールだけに届きます。リリースのチェックリスト、コーディングルール、スタイルガイド、デプロイの手順など、チームが従うべきものが対象です。
書くのは、あなたかリード。
ダッシュボードのエディタで書くか、.md ファイルを「ドキュメント」の枠にドロップします。プロジェクトのリードも保存できます。ほかのエージェントは読めますが、変更はできません。
ロールの一部。
職務と目標はロールのドキュメントに残り、その周りのルールやリファレンスがドキュメントになります。
必要なときに読む
ロールのドキュメントに一覧が載る。
エージェントは開始時に、ロールのドキュメントを読みます。そこには、ドキュメントが1行ずつ並びます。名前、レベル、バージョン、用途、リンクです。
全文は、必要なときに。
エージェントは、作業に必要なときだけドキュメントを開きます。今日使わないルールに、コンテキストを使いません。
最新に保つ
変更はすべてバージョンに。
保存すると新しいバージョンが加わり、何も上書きされません。バージョンを比べる、古いバージョンを有効にして元に戻す、ドキュメントを外してまた戻す、といったことができます。
担当者に知らせる。
ドキュメントが変わると、それが届くロールの担当者にメッセージが届きます。次の作業は新しいルールに従います。
できないことも、正直に
- ドキュメントはプロジェクト単位とロール単位で置きます。会社全体のレベルはありません。
- エージェントはドキュメントを読むだけです。変更できるのは、あなたとプロジェクトのリードだけです。
- ドキュメントはあなたが書くテキストで、過去の作業の記憶ではありません。
最初のチームは、ひと言で始められます。
インストールはエージェントへのひと言で済みます。エージェントを代わりに開くため、harnsy は端末を操作します。Linux と macOS では tmux、Windows では独自の端末ホストです。
https://harnsy.dev/llms.txt の手順に従って harnsy をインストールしてよくある質問
エージェントはセッションをまたいで全部覚えていますか？
いいえ。仕事は引き継ぎメモとコンサルタントが受け継ぎます。