Skip to content

Conversation

shinpr
Copy link
Owner

@shinpr shinpr commented Jul 30, 2025

概要

ドキュメントの品質保証プロセスを自動化・強化するため、新しい document-fixer エージェントを追加し、既存の document-reviewer
と連携した多角的レビュー・自動修正システムを構築しました。

変更内容

🆕 新規追加

  • document-fixer エージェント: 複数観点のレビューを統合し、ドキュメントを自動修正する専門エージェント
    • PRD/ADR/Design Doc のタイプ別に最適化されたレビュー戦略
    • レビュー結果の統合と優先順位付け
    • 問題の自動修正まで一貫して実行

📈 機能強化

  • document-reviewer エージェント: 観点モード(mode)による多角的レビュー機能を追加
    • critical: 批判的レビュー(問題点・リスク・実装困難性)
    • deep: 深層分析レビュー(暗黙の前提・隠れた依存関係)
    • structural: 構造検証レビュー(テンプレート準拠・必須要素)
    • consistency: 整合性検証レビュー(ドキュメント間の一貫性)

📚 ドキュメント更新

  • sub-agents-guide.md: document-fixer を統合し、ドキュメント品質保証フローを改善
    • レビューから修正まで一貫したワークフロー
    • 実践的な使用例を追加

効果

  1. 品質向上: 多角的な観点からのレビューにより、見落としを防止
  2. 効率化: レビューから修正まで自動化により、手動作業を大幅削減
  3. 一貫性: ドキュメントタイプ別の標準化されたレビュー・修正プロセス

使用例

# PRDドキュメントの自動レビュー・修正
@document-fixer 対象ドキュメント: docs/prd/new-feature.md

# 特定観点でのレビューのみ実行
@document-reviewer mode=critical doc_type=ADR target=docs/adr/ADR-0001.md

shinpr and others added 2 commits July 31, 2025 00:08
- document-fixer: 動作モード概念を削除し、常に修正まで実行
- document-reviewer: 観点モードによる多角的レビュー機能
- sub-agents-guide: document-fixerを統合し、ドキュメント品質保証フローを改善

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Add documentation for the document-fixer sub-agent in both the project structure
and available sub-agents sections. This agent integrates multiple review perspectives
to automatically fix documents.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@shinpr shinpr self-assigned this Jul 30, 2025
@shinpr shinpr marked this pull request as ready for review July 30, 2025 15:14
- Remove review_only/fix mode concept entirely
- Always execute from review to fixing automatically
- Simplify input format and improve execution clarity
- Consolidate design philosophy into implementation notes

This change improves AI execution accuracy by eliminating
ambiguous operation modes and ensuring complete execution flow.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@shinpr shinpr merged commit 38b111e into main Jul 30, 2025
1 check passed
@shinpr shinpr deleted the sync/document-agents-update branch July 30, 2025 15:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant