re0-plan について
re0-planは、paperthinリポジトリの開発サイクルを準備するエージェントスキルです。軽量・完全の経路に応じて初期ファイルをすぐに作成し、計画を証拠ゲート、手順、関連スキルにつなげます。
主な機能
- 01サイクルを軽量または完全に分類
- 02フォルダー作成と同時に初期ファイルを記述
- 03完全計画に論旨、範囲、品質ゲートを設定
- 04サイクル固有の手順と証拠ゲートを定義
- 05AGENTS.mdとREADMEの文書上の役割を整合
活用シーン
- 01小規模な修正の短い記録を用意
- 02設計判断を伴うサイクルを計画
- 03セッション中断後に作業を再開
- 04リリース対象の文書変更を計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lilmgenius/ paperthin --skill re0-planインストール後、Claude Code で/re0-planを入力して読み込まれたか確認します。
詳細
.re0/iteration/<version>-<workname>/ を開き、re0-loop のサイクルが一行でも実行される前に、同じ作業の中でファイルを書き込みます。
目標
書かれた論点、ゲート一覧、ステップ計画がないサイクルは、最初に持ち出された枠組みへと流されてしまいます。また、何も入っていないフォルダーを開いても、再開したセッションには何も伝わりません。re0-plan は両方の問題を一度に解消します。サイクルでどの重み付けになっても、フォルダーは作成された時点から空ではありません。このスキルは、paperthin パッケージ一式がインストール済みであることを前提とし、兄弟スキルを直接指定します。フォルダーを閉じる re0-release と連携し、このスキルが用意した内容を最初からやり直すのではなく拡張する re0-memo とも連携します。これは汎用的な計画手法ではありません。書き込む形式は、このリポジトリ独自の規約です。
ワークフロー
- サイクルの重み付けを分類します。実質的な設計の余地がない修正や強化作業は軽量です。議論する価値のある方向性があるサイクルはフルです。
.re0/iteration/<version>-<workname>/を作成し、同じ手順の中で最初のファイルを書き込みます。重み付けに応じて、ファイルを選びます。- 軽量 →
RETRO.local.md:タスクと、軽量である理由を記した段落を1つ書きます。最後にre0-memoがこの同じファイルを拡張します。新しいファイルを作成することはありません。ここで終了します。 - フル →
DESIGN.local.md:論点、スコープ、品質ゲートを記載します。これはre0-loopの FRAME ターンが求める内容と同じで、セッションが中断されても単独で内容を維持できるだけの情報を含みます。変更が出荷可能な領域に関わる場合、ゲートには必ず AGENTS.md/README の反映確認ゲートを含めます(「ルール」を参照)。readchkで読み取りを確認し、modelchkでティアを見積もります。方向性について本当に判断が分かれる場合に限り、macrothinkまたは別の判断スキルを利用します。
- 軽量 →
- (フルのみ)
WORKFLOW.local.mdを作成します。このビルド固有の手順を、re0-loopのターン順に沿って番号付きで記載します。re0-loopの汎用的なステージを言い換えただけのものにはしません。 - (フルのみ)
EVIDENCE.local.mdを作成します。DESIGN.local.mdのゲートを、これから埋めるべき証明項目として列挙します。記載するのは基準であり、結果ではありません。 - 参照資料は
REF-<topic>.local.mdとしてフラットに保ちます。ファイルが2、3個を超えて増えてから、refs/サブフォルダーに移します。 re0-loopに引き継ぎます。ここではre0-workを呼び出しません。最初からの再開はre0-loop自身がサイクル途中で呼び出すもので、必要に応じてnbaが提示します。セットアップ手順ではありません。
ルール
- フォルダーは作成時に空ではありません。 簡易パスでもフルパスでも、フォルダーの作成と同時に実際の内容を書き込むため、どの時点でセッションが中断しても、そこから再開できます。
- 意図的にポータブルではありません。 他の paperthin スキルを直接参照し、パッケージ全体がインストールされていることを前提とします。このフォルダーにある他のすべてのスキルが従う、自己完結型のデフォルトとは正反対です。これは
re0-releaseおよびre0-memoと組み合わせるためだけのもので、単独で持ち運ぶものではありません。 - 水増しはしません。 簡易版に
DESIGN/WORKFLOW/EVIDENCEは付けず、RETRO.local.mdの初期記述は1段落にとどめます。これはタスクのメモであり、WORKFLOW.local.mdを装ったものではありません。判断スキルやre0-workを「念のため」無理に追加することもありません。 - フォルダーの
<version>は暫定的です。re0-releaseと同じマイナー/パッチの判定基準を適用してください。大きさではなく種類で判断します。つまり、成果物のそれ以前の仕様と比べて、この変更は修正(パッチ)なのか、それともユーザーが新たに必要とする機能(マイナー)なのか、ということです。また、サイクルで発生した未解決の分岐があれば、それに応じて変更してください。サイクルで正当化されていない確定的なバージョン更新を、決して事前に決めないでください。スキルを追加する可能性のある分岐がある場合、その分岐が解決するまでは更新を未決定にします。 - ドキュメントは
re0-releaseのリリース時と同様に整合させます。 サイクルでの変更がリリース対象の範囲に及ぶ場合、品質ゲートには必ず AGENTS.md/README の反映ゲートを含め、AGENTS.md のドキュメントの役割分担に従って、各反映先を割り当ててください。内部の仕組み/ルール/構造 → AGENTS.md(LLM と人間向け。指示として注入されます)、ユーザー向けのカタログ/利用体験 → README(人間向けのみ。注入されることはありません)。エージェントへの指示に関する仕組みを README に記載してはならず、ユーザー向けの変更で README への反映を省略してもいけません。これは、re0-releaseのリリース時の README 手順を補完する計画段階の対応です。 - negatives-as-corpus — このスキルや、このスキルが開始するサイクルで生成されたものは削除しません。うまくいかなかったサイクルは、破棄するのではなく
re0-releaseで退役させます。 EVIDENCE.local.mdの各ゲートは、DESIGN.local.mdの該当行に必ず紐付けてください。DESIGNが求めていない証拠の提示を新たに求めてはいけません。
検証
完了前に、以下を確認してください。
- どちらのパスでも、フォルダーは存在した時点から実際の内容を含んでおり、空のディレクトリがないこと。
- フルパスの場合:
DESIGN.local.mdに主旨、範囲、ゲートが記されていること。WORKFLOW.local.mdの手順がこのサイクルに固有であること。EVIDENCE.local.mdのすべてのゲートがDESIGN.local.mdに紐付いていること。 - 簡易パスの場合:
RETRO.local.mdの初期記述に、タスクと理由が1段落で記されていること。 - 根拠がない限り、参考資料がフラットな構成のままであり、
refs/サブフォルダーを追加していないこと。 - どのパスを選んだか、その理由とともに報告すること。
コメント
Markdown 対応