Brain Synthesize
Turn repeated experience into reusable memory without inflating copies or inventing policy.
Resource Handoff
Invoke brain through the host's native skill loader and use the exact base directory it returns for foundation resources. Use the base directory returned for this brain-synthesize invocation for its reporter script. Do not list or search parent skill directories, read SKILL.md directly, or probe alternate config locations.
Modes
- Targeted: cheap check around newly written structured records; invoked automatically by
brain-remember and brain-build.
- Full: explicit or host-scheduled brain-wide prevalence pass.
Run the bundled read-only reporter first. Candidate scores rank review; they never override blockers.
BRAIN_SYNTHESIZE_DIR="<exact base directory returned by the brain-synthesize skill loader>"
npx tsx "$BRAIN_SYNTHESIZE_DIR/scripts/report-patterns.ts" report \
--vault-path "<vault-path>" --strict
Evidence Rules
- Count independent occurrences and lineages, not repeated wording.
- A workspace summary and a member project repeating one incident count once.
- Promoted summaries, vendored copies, and derived records are not fresh evidence.
- Legacy prose may produce report-only candidates but cannot auto-promote.
- Contradictions, ambiguous ownership, incomplete provenance, suspicious copies, or a human-authored target collision block automatic writes.
- Choose the narrowest valid scope: project, workspace, wiki, tool, then global.
Lane Gates
- Gotcha: same causal trap, complete provenance, no contradiction, and at least three verified independent occurrences from three independent leaf owners.
- Decision: explicit authority covers the target scope. Repeated implementation never creates user intent.
- Code style: direct user/org authority or a canonical config explicitly designated for the target scope. Repository-local instructions always override.
- Recurring improvement: at least three independent occurrences, common remediation, brain ownership rather than product-tracker ownership, and automatic priority no higher than medium.
Automatic Apply
When every static and semantic gate passes:
- Recall bounded source records and any existing target.
- Confirm mechanism, independence, scope, authority, novelty, and exceptions.
- Build a plan containing candidate/revision fingerprints and exact source IDs.
- Revalidate the plan against current vault hashes.
- Load
brain-remember and create/update only a synthesis-owned atomic record or stable improvement item.
- Link the corresponding root/owner router, preserve every source record, and record provenance/fingerprints.
- Rerun targeted reporting plus structural audit; the result must become promoted/no-op.
Fully automatic means no per-candidate user ceremony after explicit or lifecycle-authorized synthesis invocation. Explicit no-write instructions still win. Never overwrite unrelated human-authored records or delete/merge source evidence.
Output
Report promoted, already-present, blocked, and skipped candidates concisely. A silent no-op is normal after a targeted check.
1---2name: brain-synthesize3description: Find repeated verified mechanisms across brain owners and automatically promote only high-confidence patterns into global or narrower gotcha, decision, code-style, or recurring-improvement records. Use after eligible structured writes and for explicit/scheduled brain-wide pattern passes. Do not use for generic summarization, single-node facts, cleanup, repair, or unsupported inference.4---56# Brain Synthesize78Turn repeated experience into reusable memory without inflating copies or inventing policy.910## Resource Handoff1112Invoke `brain` through the host's native skill loader and use the exact base directory it returns for foundation resources. Use the base directory returned for this `brain-synthesize` invocation for its reporter script. Do not list or search parent skill directories, read `SKILL.md` directly, or probe alternate config locations.1314## Modes1516- **Targeted:** cheap check around newly written structured records; invoked automatically by `brain-remember` and `brain-build`.17- **Full:** explicit or host-scheduled brain-wide prevalence pass.1819Run the bundled read-only reporter first. Candidate scores rank review; they never override blockers.2021```sh22BRAIN_SYNTHESIZE_DIR="<exact base directory returned by the brain-synthesize skill loader>"23npx tsx "$BRAIN_SYNTHESIZE_DIR/scripts/report-patterns.ts" report \24 --vault-path "<vault-path>" --strict25```2627## Evidence Rules2829- Count independent occurrences and lineages, not repeated wording.30- A workspace summary and a member project repeating one incident count once.31- Promoted summaries, vendored copies, and derived records are not fresh evidence.32- Legacy prose may produce report-only candidates but cannot auto-promote.33- Contradictions, ambiguous ownership, incomplete provenance, suspicious copies, or a human-authored target collision block automatic writes.34- Choose the narrowest valid scope: project, workspace, wiki, tool, then global.3536## Lane Gates3738- **Gotcha:** same causal trap, complete provenance, no contradiction, and at least three verified independent occurrences from three independent leaf owners.39- **Decision:** explicit authority covers the target scope. Repeated implementation never creates user intent.40- **Code style:** direct user/org authority or a canonical config explicitly designated for the target scope. Repository-local instructions always override.41- **Recurring improvement:** at least three independent occurrences, common remediation, brain ownership rather than product-tracker ownership, and automatic priority no higher than medium.4243## Automatic Apply4445When every static and semantic gate passes:46471. Recall bounded source records and any existing target.482. Confirm mechanism, independence, scope, authority, novelty, and exceptions.493. Build a plan containing candidate/revision fingerprints and exact source IDs.504. Revalidate the plan against current vault hashes.515. Load `brain-remember` and create/update only a synthesis-owned atomic record or stable improvement item.526. Link the corresponding root/owner router, preserve every source record, and record provenance/fingerprints.537. Rerun targeted reporting plus structural audit; the result must become promoted/no-op.5455Fully automatic means no per-candidate user ceremony after explicit or lifecycle-authorized synthesis invocation. Explicit no-write instructions still win. Never overwrite unrelated human-authored records or delete/merge source evidence.5657## Output5859Report promoted, already-present, blocked, and skipped candidates concisely. A silent no-op is normal after a targeted check.
riggyz