chore(dev): FT report scaffold + candidates backlog + PR templates#427
Merged
Conversation
ergonomic 第 2 弾。boilerplate を更に畳む。
### tools/ft-report-new.sh
- usage: tools/ft-report-new.sh <FT-N> <topic-kebab>
- docs/templates/field-trial-report.md を docs/field-trials/YYYY-MM-field-trial-N.md
にコピーし、{N} / {topic} / 日付 を埋める
- 既存ファイルへの overwrite を refuse (in-progress notes 保護)
- 動機: 今日 5 FT 走らせて毎回 fresh で書いた、毎回同じ shape
### docs/field-trials/candidates.md
- 提案 backlog の durable 化
- session 間で「次の trial 候補」を user に提示する際の primary source
- カテゴリ: real-app surface / observability / structural / meta / quality
- archive trail (Recently picked-up) で最近の流れも確認可能
### .github/PULL_REQUEST_TEMPLATE/
5 つの type 別 template:
- feat.md (新機能 / framework code 変更)
- docs.md (docs-only)
- trial-report.md (FT report 起票時、F-N 含む)
- chore.md (maintenance / tooling)
- followup.md (F-N follow-up small PR)
GitHub web UI の dropdown でも選べるし、AI agent (私) が PR 本文を書く際の
canonical 構造として使える。"Summary / Test plan / Closes #N" を毎回手書き
していた負担を排除。
### AGENTS.md / tools/README.md
- AGENTS.md "Read First" に candidates.md / PR templates / tools/README.md
の cross-link 追加
- tools/README.md の table に ft-report-new.sh を追加
### Verification
- tools/ft-report-new.sh 99 dryrun-test → 生成確認 → revert
- tools/ft-report-new.sh で既存 FT17 ファイルへの上書きが exit 2 で refuse
- composer ci 全 step green (test 142/142 + test:http 24/24 + Phan + format)
Closes #427. (Issue 未作成、本 PR で兼ねる)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ergonomic 第 2 弾。session 間継続性を上げる 3 件。
tools/ft-report-new.sh
`docs/templates/field-trial-report.md` を `docs/field-trials/YYYY-MM-field-trial-N.md` にコピーし、`{N}` / `{topic}` / 日付 を埋める。既存ファイルは refuse。毎 FT で fresh から書いていた boilerplate を畳む。
docs/field-trials/candidates.md
trial 候補の durable backlog。session 間で「次の trial を提案」する際の primary source。私 (AI agent) が freehand で再構成する必要が無くなる。カテゴリ別 + archive trail 付き。
.github/PULL_REQUEST_TEMPLATE/
5 type:
GitHub web UI dropdown + AI agent の PR 本文 canonical 構造 兼用。
AGENTS.md / tools/README.md
新 surface への cross-link 追加。
Test plan
Closes #427. (Issue 未作成、本 PR で兼ねる)