rfc-writer · diff

git:20260902.9b5c240 to git:20260919.f95d231

0 added, 1 removed. Audit A to A.

---
name: rfc-writer
description: "公開 rfcs/ 台帳へ 1 エントリを起票する手順と規約の唯一の正本(足切り → 採番 → 様式 → 公開規約 → spawn 接続 → index 行)。Use when the user says 「これ起票して」「RFC にしておいて」「提案を台帳に載せて」, when harness-boundary の Defer や task-triage の起票提案が承認されたとき, or /rfc-writer. 各 repo の rfcs/README.md は薄いポインタ + index のみで、規約本文はここ以外に書かない。NOT for — 状態語彙の定義と台帳の棚卸し(→ task-stocktake が正本)、起票するかの足切り判定のうち review 指摘の loop-breaking + producer 規律(→ task-stocktake「レビュー指摘の起票規律」)、open タスクの判定・dispatch・検収(→ task-triage)、決定の記録(→ adr-writer。rfcs は提案・未決、ADR は決定)、単一表 .notes/TASKS.md への 1 行起票(→ rule task-tracking の形のまま)。"
user-invocable: true
origin: shimo4228
---
# RFC Writer — 公開台帳への起票
rfcs/ は**提案と作業項目の公開台帳**(判断は ADR-0049/0050)。この skill が規約の
唯一の正本で、各 repo の `rfcs/README.md` には規約を書かない — 複製した版は誰も
刈らず drift する。
## 0. 足切り — 起票しないことを先に判定する
> Do not create an RFC for work that can be safely completed in the current
> session without preserving intent or state.
台帳は seam(セッション境界・判断待ち・条件待ち)へ intent と state を運ぶ器。
運ぶものが無い起票は純コスト(GTD の 2 分ルールの台帳版、2026-08-25 著者規約)。
- **逆は成り立つ**: 今すぐ却下できる提案でも却下理由を残す価値があるなら起票してよい —
それは intent の保存(公開判断記録が rfcs/ の存在理由)
- **起票のタイミングは seam が生まれた瞬間、入口の儀式ではない**: plan → 実装で完結する
直実装は RFC 無しが既定 — 記録は commit(何を)と ADR(なぜ、判断が要るときだけ)が
担う。**後追いで起票するのは足切りの前提が破れた瞬間**: ① 実装がセッションを跨ぐ
ことになった(in_progress + Status に経緯)② 人間の判断待ちで止まった(blocked +
3 行)③ 実装中に「やらない」と決めた(rejected / withdrawn、却下理由ごと terminal で
置く)。完了後の後追い起票はしない — それは ADR か commit log の領分
- 別軸の既存足切りはそのまま: review 指摘は「loop 自身を壊す欠陥」+ producer 引用のみ
即時起票(task-stocktake「レビュー指摘の起票規律」、ADR-0055 で再絞り込み)、
便乗型(「次に X を触る時に」)は台帳でなくコード側の注記
## 1. 起票手順
1. **state**: 提案は `draft`、採用済みの作業項目は `accepted`。語彙 9 語の定義・
使い分け・`blocked` の 3 行は skill: `task-stocktake` が正本(ここに複製しない)
2. **採番**: `rfcs/` の `[0-9][0-9][0-9][0-9]-*.md` の最大番号 +1 を 4 桁 zero-pad。
欠番は再利用しない(docs/adr と同じ)。ファイル名 `NNNN-<kebab-slug>.md`、
ID は `RFC-NNNN`
3. **本文**(Rust RFC 0000-template 準拠 + 独自 2 節。推奨であって強制ではない —
小さな作業項目は該当なし節を省き Summary / Motivation 中心でよい):
```markdown
---
state: draft 2026-08-25
review-when: <失効条件(無ければ省略。語は ADR-0044 と同じ review-when)>
---
## Summary
## Motivation
## Guide-level explanation
## Reference-level explanation
## Drawbacks
## Rationale and alternatives
## Prior art
## Unresolved questions
## Future possibilities
## Status
## Next action
```
- **機械契約は 1 つ**: 本文の最初の非見出し行(= Summary の 1 行目)が
`claims.py ready` の 90 字要約になる。frontmatter で機械が読むのは `state:` のみ
- `## Status` = state 語 + 現在地の要約 + 日付(IETF「Status of This Memo」型。
state 遷移のたびに更新)。`## Next action` = 何があれば動くか(blocked の 3 行の家)
- 見出しは EN、本文の言語は自由
4. **公開規約**: 公開が既定 — 本文は公開可能な書き方をし、機微(内部事情・非公開 repo
のパス等)はリンク先へ逃がす。公開は撤回不能なので、迷ったら書かない側に倒す
5. **接続**: `python3 ~/.claude/scripts/claims.py spawn RFC-NNNN --origin <origin>`
(review 由来は `--producer PATH:LINE` 必須)。着手時は `claim`
6. **index**: `rfcs/README.md` の表に 1 行 — `| [NNNN](<NNNN-slug>.md) | <title> |` の形
(角括弧に番号、丸括弧にファイル名、右列にタイトル)。
**state 列は持たない**(frontmatter が唯一の正本 — 二重記録は drift する)
## 2. 標準語彙との対応(翻訳の正本)
対応表は起票時の翻訳なので本 skill が正本(ADR-0048 の日付つき注記が指す先)。
| 由来 | 対応 |
|---|---|
| playbook intent.md | problem → Motivation / proposed outcome → Summary / affected users and systems → Guide-level(users)・Reference-level explanation(systems)/ constraints → Reference-level explanation / open questions → Unresolved questions |
- | Build-or-not(implementation-chain) | ①既存流用の検討 → Rationale and alternatives / ③誰が消費するか → Motivation / ④失効条件 → frontmatter `review-when:` |
| search-first / Phase 0 の結果 | → Prior art(AKC Research phase の受け皿) |
## 3. repo に rfcs/ が無いとき(初設)
`rfcs/README.md` を作る — 内容は **what-this-is 2〜3 行 + 本 skill(公開版:
`https://github.com/shimo4228/claude-harness/blob/main/skills/rfc-writer/SKILL.md`)への
ポインタ + 状態の正本が frontmatter である旨 1 行 + index 表**だけ。既存 repo の
README を丸コピしない(規約本文の複製を作らない)。単一表だけの小 repo は初設不要 —
提案性の行が生まれた時に作る(RFC-0001 の規則)。
## 境界
- 終端エントリの残置(archive しない)・終端語の使い分け・棚卸しは task-stocktake
- 採用判断が出たら ADR が Rationale and alternatives を引き取る(→ adr-writer)。
rfcs 側は state を進めて Status を更新するだけ
- 無人 filing(CA weekly-pipeline 等)は pipeline 側が採番・draft 正規化を実装済み —
この skill は人間・対話セッションの起票手順