Automatically Register Review Findings to Lightning Review
Overview
This sample demonstrates how to perform reviews of Word design documents using a workflow that follows predefined review points.
The sample reads the design document to be reviewed and the review points, then repeatedly runs agents for each combination of review point and document chapter. Extracted review findings are output to Lightning Review.
In this sample, the workflow executes the following steps in order:
- Retrieve the document to be reviewed
- Retrieve the review points
- Repeatedly run the review
- Output to Lightning Review
This allows you to observe the process of reviewing a Word document by review point while combining tool integrations and AI agents.
What this sample enables
- Integrate with Lightning Review and register extracted findings to Lightning Review
- Read a review points list file and perform reviews using those points
- Decompose a Word design document into chapters and review each chapter
- Execute comprehensive repeated reviews for each chapter × review point combination
Intended users
This sample is intended primarily for users who:
- Are considering integrating Lightning Review with AI
- Want to streamline and standardize design document reviews using AI
- Want to experience repeated execution using workflows
Included files
The sample includes the following example data.
You can run this sample as-is to verify its behavior, and then replace the input/output files with your own artifacts to try it in a scenario closer to your actual work. If you replace the files, change the targets as described in "Procedure for replacing with your own artifacts" and follow the steps in the "Procedure" section.
| Type | Content | Procedure for replacing with your own artifacts |
|---|---|---|
| Workflow definition | 章と観点ごとにWord設計書をレビューしてLRに指摘を出力.yaml | Not editable |
| Agent definition | Word設計書レビュー_LR指摘JSON生成.yaml | Not editable |
| Input: Review points file | inputData/reviewPointList.json | 1. Place your review points file in JSON format in the inputData folder. 2. Specify the path in step 4 of the Procedure. |
| Input: Word design document | inputData/APPレイヤコンポーネント設計書.docx | 1. Place your design document in Word format in the inputData folder. 2. Specify the path in step 4 of the Procedure. |
| Documentation | This README | Not editable |
Using the sample data
Prerequisites
- The structure of your review points must match the input format expected by this sample
- The Lightning Review file to which review findings will be output must be open
Input / Output
- Input: Review points list file, design document in Word format
- Output: A list of all review findings (Lightning Review format)
Procedure
- Open the Lightning Review file for outputting review results.
- In the DC Agentiqs workflow screen, click "章と観点ごとにWord設計書をレビューしてLRに指摘を出力".
- On the "章と観点ごとにWord設計書をレビューしてLRに指摘を出力" screen, click "Run".
- A dialog will be displayed. Enter the "Review points list file path" and the "Word design document file path", then click "Run".
- The findings will be output to the Lightning Review file.
Applicable components
- Workflow: 章と観点ごとにWord設計書をレビューしてLRに指摘を出力
- Agent: Word設計書レビュー_LR指摘JSON生成
Limitations
- Because this sample inputs data to the agent on a per-chapter basis, accuracy may decrease if a chapter is very large. In that case, customize the input scope to the agent (for example, use smaller sections).
- Review points must be usable in the format expected by the workflow and agent. If the structure or contents differ, changes to the workflow will be required.
Reference: Workflow execution flow
This sample decomposes the process into stages using a workflow, allowing you to verify a configuration that combines tools and AI agents to perform the review process in a sequence.
- Read the review points list file and shape it into a structure that can be looped over by point.
- Read the Word design document and shape it into a structure that can be looped over by chapter.
- For each chapter and each review point, input the data to the review agent in sequence and extract review findings
- For each chapter and each review point, register the review findings to Lightning Review