Imported from ryosuke-horie/taskpaper (
AGENTS.md). Install upstream withnpx skills add ryosuke-horie/taskpaper. Copyright stays with the author.
Repository Guidelines
プロジェクト構成とモジュール
- ルート:
agent.md（企画・目的・要求仕様の起点）、tasks.txt（唯一のタスクリスト）、生成物dashboard.md/agenda.md、README.md（運用概要）。 docs/: 運用手順（ops.md）、エージェント用プロンプト（prompts.md）、タスク形式と検証ルール（rules.md）。scripts/:validate.mjs、build-dashboard.mjs、build-agenda.mjsを想定（現段階では未導入）。
ビルド・テスト・開発コマンド
- 生成（推奨）:
docs/prompts.mdのプロンプトを用い、Codex にdashboard.md/agenda.mdの生成を依頼。 make dashboard/make agenda: Makefile がある場合の短縮形。無い場合は上記プロンプトを使用。- 反映:
make apply（存在する場合）。無い場合は会議メモをもとにプロンプト経由でtasks.txtを更新。 - 検証: 当面は「バリデーションレポート」プロンプトを使用。将来的に
scripts/validate.mjsとmake validateに移行。
コーディング規約・命名
- Markdown: ATX見出し（
#）、簡潔なセクション、約100桁で改行。ファイル名は小文字kebab-case（例:ops.md）。 - タスク形式:
P0:,P1:,P2:,Backlog:配下に1行1タスク。必須タグは@due(YYYY-MM-DD)と@kind(<kind>)。任意:@status(ready|doing|blocked|done),@src(...),@owner(...)。@kindは ルートのkinds.txtの集合から選ぶ。 - 運用:
P0は最大5件。完了は削除せず@status(done)を付けてP2末尾へ移動。
テスト方針
- 直近:
docs/prompts.mdの「バリデーションレポート」でtasks.txtを検証。違反例:@due/@kind欠落、日付形式不正、セクション外のタスク行。 - 将来: 自動検証は
scripts/validate.mjs→make validate→ CI に統合（@kindは ルートのkinds.txtに厳密一致）。 - ルール変更時は
docs/rules.mdを更新し、例も追加。ワークフロー変更はdocs/ops.mdを更新。
コミット・PRガイドライン
- Conventional Commits を採用:
feat:,fix:,docs:,chore:（scope任意）。例:feat: agenda に blocked セクションを追加。 - PR: 目的の明確な説明、関連Issueのリンク、
tasks.txt/生成物のBefore-Afterを添付。make validateを通し、CI生成物があればArtifactsを添付。
エージェント向け指示
docs/prompts.mdに厳密に従う。新規ファイル/タグを勝手に増やさない。見出しとタグ表記を厳格に保持し、変更は最小・原子的・可逆にする。- 余計な提案をしないこと。言われた指示に従うこと。
コーデックス限定ルール
- 最終回答は必ず日本語で記述する（要約や結果も含む）。
- 1回のやり取りにつきコミットは1回のみ。変更は原子的にまとめ、追従修正は次回のやり取りで行う（コミットメッセージは Conventional Commits に従う）。