Agent-design-language repo-review-synthesis
Synthesis reviewer for a multi-agent repository review. Use when specialist code, security, test, and docs review artifacts need to be merged into one findings-first repo review without hiding severity, disagreement, missing coverage, residual risk, or role-specific caveats, and without claiming merge approval or remediation.
git clone https://github.com/danielbaustin/agent-design-language
T=$(mktemp -d) && git clone --depth=1 https://github.com/danielbaustin/agent-design-language "$T" && mkdir -p ~/.claude/skills && cp -r "$T/adl/tools/skills/repo-review-synthesis" ~/.claude/skills/danielbaustin-agent-design-language-repo-review-synthesis && rm -rf "$T"
adl/tools/skills/repo-review-synthesis/SKILL.mdRepo Review Synthesis
Merge specialist review artifacts into one findings-first repository review.
This skill is the final assembly role for the multi-agent repo review suite. It does not replace the specialists and must not dilute their findings.
Quick Start
- Confirm the specialist artifacts and target repo/slice.
- Preserve each finding's source role, severity, file reference, and rationale.
- Deduplicate only when findings truly describe the same behavioral risk.
- Surface disagreements, missing specialist artifacts, and residual risk.
- Emit the final review packet and stop before remediation or approval claims.
Focus
Prioritize:
- severity-preserving merge of specialist findings
- dedupe without losing role context
- explicit disagreement and uncertainty
- reviewer-friendly ordering by impact
- coverage and validation summary across all roles
- residual risks and recommended follow-up issues
Do not treat synthesis as:
- a new monolithic review pass
- a vote that can erase a specialist finding
- a remediation plan that silently edits code
- merge approval
Required Inputs
At minimum, gather:
repo_roottarget.specialist_artifacts
Useful additional inputs:
target.target_pathtarget.branchtarget.diff_baseartifact_rootrequired_rolesseverity_policy
If there are no specialist artifacts, stop and report
blocked; use
repo-code-review for a monolithic review instead.
Output Expectations
Default output should include:
- findings first
- specialist coverage matrix
- dedupe and disagreement notes
- validation performed across roles
- residual risk
- recommended follow-up issues
Use the shared suite contract in
adl/tools/skills/docs/MULTI_AGENT_REPO_REVIEW_SKILL_SUITE.md when ADL expects
a structured artifact.
Stop Boundary
Stop after producing the synthesis artifact.
Do not:
- edit code, tests, docs, or configs
- hide severity, disagreement, or missing specialist coverage
- claim approval, merge readiness, or remediation completion
- run additional specialist reviews unless the operator explicitly asks