feat: add documenter role workflow - #110
Merged
Merged
Conversation
Document the required research, outlining, drafting, whole-document review, and reconstruction steps for documentation work.\n\nValidation: checked YAML frontmatter and git diff --check.
Add the role-documenter delegation entry and role-documenter-playbook workflow, connect existing Codex and Claude documenter agents, and document the new skills and dependency.\n\nValidation: JSON and YAML validation, git diff --check, and make deploy-dry-run with temporary Go caches.
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
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.
Documenter role と文書化ワークフローの追加
Summary
技術文書の作成・更新を、調査から構成、作成、文書全体のレビュー、再構築まで一貫して進められるようにします。
既存の
documenteragent を、他の role と同じ「委譲入口 → agent 定義 → playbook」の構成へ接続します。主な変更点:
documentingskill に必須の5段階ワークフローを追加role-documenterとrole-documenter-playbookを追加documenteragent を新しい playbook へ接続やったこと
role-docを参照していた Codex / Claude agent 定義を修正動作確認
git diff --checkGOMODCACHE=/tmp/gomodcache GOCACHE=/tmp/gocache GOTOOLCHAIN=local make deploy-dry-runレビュー & 動作確認 チェックリスト
role-documenterが適切に選択されることdocumenterがrole-documenter-playbookを参照すること推奨テスト計画:
role-documenter/evals/evals.jsonの positive / negative ケースを実モデルで評価するrole-documenter-playbook/evals/evals.jsonの文書作成・再構築ケースを実モデルで評価するその他気になることや相談ごと
リポジトリ内に skill routing eval の実行 runner がないため、追加した eval の実モデル検証は未実施です。PR 前レビューでは Medium として指摘され、High 指摘はありませんでした。