agentleFS
shimo4228shimo4228/claude-harness/skills/rfc-writer/SKILL.md

rfc-writer

Skill4 starsChanged 34 days agoMITView on GitHub

File one entry in the public rfcs/ ledger. Use when filing a proposal or task (起票して), or when a triage proposal to file is approved. For task state words or whether a review finding gets filed, use task-stocktake.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

RFC Writer — 公開台帳への起票

rfcs/ は提案と作業項目の公開台帳。この skill はそこへ 1 エントリを起票する手順と規約を持つ。

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 分ルールの台帳版)。

  • 逆は成り立つ: 今すぐ却下できる提案でも却下理由を残す価値があるなら起票してよい — それは intent の保存(公開判断記録が rfcs/ の存在理由)
  • 起票のタイミングは seam が生まれた瞬間、入口の儀式ではない: plan → 実装で完結する 直実装は RFC 無しが既定 — 記録は commit(何を)と ADR(なぜ、判断が要るときだけ)が 担う。後追いで起票するのは足切りの前提が破れた瞬間: ① 実装がセッションを跨ぐ ことになった(in_progress + Status に経緯)② 人間の判断待ちで止まった(blocked + 3 行)③ 実装中に「やらない」と決めた(rejected / withdrawn、却下理由ごと terminal で 置く)。完了後の後追い起票はしない — それは ADR か commit log の領分
  • 別軸の既存足切りはそのまま: review 指摘は「loop 自身を壊す欠陥」+ producer 引用のみ 即時起票(task-stocktake「レビュー指摘の起票規律」)、 便乗型(「次に 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/decision-history と同じ)。ファイル名 NNNN-<kebab-slug>.md、 ID は RFC-NNNN
  3. 本文(Rust RFC 0000-template 準拠 + 独自 2 節。推奨であって強制ではない — 小さな作業項目は該当なし節を省き Summary / Motivation 中心でよい):

    ---
    state: draft 2026-08-25
    review-when: <失効条件(無ければ省略。語は ADR の 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 行の家)
    • plan(docs/plans/ の .md。過去の html plan は .html)を通った作業は ## Status に **YYYY-MM-DD plan** — [docs/plans/<file>](../docs/plans/<file>) を 1 行置く(plan から RFC へ辿れるように)。本文の最初の行には置かない(claims.py ready の要約になるため)
    • 見出しは EN、本文の言語は自由
  4. 公開規約: 公開が既定。何を名指し何を .notes/ へ逃がすかの境界は rule public-records.md が正本。rfc には機微でない理由を書いてよい。公開は撤回不能なので、迷ったら書かない側に倒す
  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 が正本。

由来対応
playbook intent.mdproblem → Motivation / proposed outcome → Summary / affected users and systems → Guide-level(users)・Reference-level explanation(systems)/ constraints → Reference-level explanation / open questions → Unresolved questions
search-first / Phase 0 の結果→ Prior art
build セッションが報告の Proposed tasks に出した提案(判断役が再現を自分で走らせて確かめ、著者が起票を決めたもの)何が壊れているか・再現手順 → Motivation / 受入条件 → Summary / producer → Reference-level explanation。Motivation の 1 行目に 由来: build 提案 (S<n>)(S<n> は提案を出した build セッションの番号 — task-triage が claim label に付ける S<n> をそのまま写す)— build 提案経由の起票数を後で数えるための印

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 を丸コピせず、規約本文は README に書かない — 複製した版は誰も刈らず drift する。単一表だけの小 repo は初設不要 — 提案性の行が生まれた時に作る。

境界

  • 終端エントリの残置(archive しない)・終端語の使い分け・棚卸しは task-stocktake
  • 採用判断が出たら判断の経緯が Rationale and alternatives を引き取る(→ skill decision-history)。 rfcs 側は state を進めて Status を更新するだけ
  • スケジュール実行の pipeline が自分で起票する無人 filing は、採番・draft 正規化を pipeline 側が 持つ — この skill は人間・対話セッションの起票手順

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.