Use when multiple experiments or analyses have accumulated and their findings need to be interpreted together
You are synthesizing accumulated findings to surface patterns, contradictions, and insights that individual log entries or analyses miss on their own. The argument specifies the scope: a project name, a time range, a topic, or specific file paths.
Before writing synthesis output, run the synthesis pre-flight audit (docs/sops/synthesis-preflight-audit.md). Enumerate upstream sources, flag provisional data, and spot-check key numerical claims that will be cited. This prevents the most common synthesis failure: propagating contaminated or stale numbers from prior sessions.
Based on the scope argument:
Also check decisions/ for relevant recorded choices and docs/ for framework documents.
For the gathered material, identify:
## Synthesis: <scope>
### Material reviewed
<bulleted list of files/entries consulted>
### Cross-layer chains
<numbered findings, each tracing a connection across 2+ CI layers>
### Convergent signals
<what multiple findings agree on — with specific references>
### Contradictions
<conflicting findings and what would resolve them>
### Gaps
<what's missing — specific questions or unexamined CI layers>
### Gravity candidates
<patterns that should move downward — from manual to tool to model>
### Implications
<1-3 concrete recommendations for what to do next, referencing specific projects or actions>
Prioritize insight density over comprehensiveness. A synthesis that surfaces one genuine cross-layer insight is more valuable than one that restates what the logs already say.
Write the synthesis to projects/<project>/analysis/<scope-slug>-synthesis-YYYY-MM-DD.md. Use the project most relevant to the synthesis scope.
After saving the synthesis, convert actionable implications to tasks:
[fleet-eligible] or [requires-opus] per fleet-eligibility checklist[skill: ...] tag matching the work typeDone when: from the implication's expected outcomeWhy: referencing this synthesis file path/design or /diagnose/gravity on the candidateCross-session synthesis insights are among the highest-value outputs the system produces. Converting them to tasks ensures they are acted upon rather than rediscovered.
Follow docs/sops/commit-workflow.md. Commit message: synthesize: <scope summary>