// 1 つの作業 (task / story / sweep / hotfix) を完了したあと、判断・詰まり・手戻りから root AGENTS.md / root CLAUDE.md / 各 skill の改善案を抽出して提案する skill。Story 完了時は Orchestra が、task / 単発作業完了時は実装 agent 自身が起動する。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | retro |
| description | 1 つの作業 (task / story / sweep / hotfix) を完了したあと、判断・詰まり・手戻りから root AGENTS.md / root CLAUDE.md / 各 skill の改善案を抽出して提案する skill。Story 完了時は Orchestra が、task / 単発作業完了時は実装 agent 自身が起動する。 |
直近の作業を振り返り、再発防止と高速化のためにルール / skill 自体を更新する提案を出す。コード変更ではなく運用の正本を改善する。
| 対象 | 改善が乗りやすい兆候 |
|---|---|
root AGENTS.md の managed block 外 | repo-local な Codex / PR review / PO / Orchestra ルール |
root CLAUDE.md の managed block 外 | repo-local な claude-code / subagent / final review ルール |
.agents/skills/.local-<name>/SKILL.md | repo-local な Codex skill の手順抜け / 落とし穴の追加 |
.claude/skills/.local-<name>/SKILL.md | repo-local な Claude Code skill の手順抜け / 落とし穴の追加 |
.github/ISSUE_TEMPLATE/*.yml | Issue 起票時に毎回手で埋める項目があるなら template 化 |
scripts/ / .launchd/jobs/ | 自動化の漏れ / 手動運用の機械化 |
vibe-coding が管理する managed block や非 dot prefix の配布 skill 自体の改善は、このリポジトリ内で直接編集せず、vibe-coding 側の後続 Issue / PR として提案する。README.md / docs / メタ説明はコメント方針に従って更新しない。
<file>: <変更案>)完了報告の末尾に追加する形を取る。提案は 0 件でも明示する (= retro したが追加なしは正しい結果)。
## Retro
### 提案
- `.agents/skills/.local-github-read/SKILL.md`: repo-local skill で review thread の Node ID と databaseId の混同が起きたので落とし穴に追記
- root `AGENTS.md`: hotfix 経路で `<trunk>` 直接 task と story 並行が混乱したので managed block 外の local rule を補強
- root `CLAUDE.md`: subagent 起動時の isolation 指定漏れがあったので managed block 外に local rule を補強
### 棄却
- root `AGENTS.md` への追加なし: 今回の論点は Claude 固有のため root `CLAUDE.md` 側で吸収
### 後続
- vibe-coding 管理の配布 rule / skill 自体を変える必要がある場合は、vibe-coding 側で後続 Issue / PR を作る
retro で出た提案は、repo-local な改善と vibe-coding 管理の配布物改善を分けて扱う。提案だけで放置しない。
AGENTS.md / root CLAUDE.md の managed block 外、または repo-local skill / script に反映する