Imported from yasuhito/pions (
AGENTS.md). Install upstream withnpx skills add yasuhito/pions. Copyright stays with the author.
エージェント向け指示
エージェント用スキル
Issue管理
Issueと仕様は、yasuhito/pionsのGitHub Issuesで管理する。Issueの作成、変更、実装に着手する前に、docs/agents/issue-tracker.mdを読む。
トリアージラベル
新しいIssueをトリアージするときは、docs/agents/triage-labels.mdに定義された標準の役割とラベルの対応を使用する。
ドメイン文書
Pionsの調査、設計、仕様策定、実装に着手する前に、CONTEXT.mdとdocs/adr/にある関連文書を読む。詳細はdocs/agents/domain.mdに従う。
ドッグフーディング
今後のPionsの実装、調査、レビューでは、サブエージェントへ委譲できる作業にPionsのpions_delegateを使用する。未実装の自動化を理由に別経路へ切り替えず、不足する運用はその都度手動で補う。成功ペインの自動閉鎖が実装されるまでは、委譲完了後にPions所有の成功ペインを確認して手動で閉じる。失敗、キャンセル、状態不明のペインは調査用に保持する。
互換性
設計と実装は常に最新版だけを対象とする。過去の形式や振る舞いとの互換性を保つ分岐、移行処理、非推奨経路は削除し、現行形式へ一本化する。互換性が仕様として明示された場合だけ例外とする。
テスト
各テストケースは、1つの振る舞いを1つのアサーションで検証する。複数のアサーションが必要な場合は、観測対象ごとに適切な名前のテストケースへ分割する。
文書作成
README.mdは英語で作成・更新する。それ以外の人向け文書は日本語で作成・更新する。ADR、調査記録、GitHub Issue、Markdown文書、HTMLレポートもこれに含む。
日本語文では、一般語を自然な日本語または定着したカタカナ語で書く。正確さに必要なコード識別子、パッケージ名、コマンド、プロトコルリテラルだけをバッククォートで残す。
