synthesize

Iterates research, proposal, and independent critique loops into an ADR-shaped decision memo.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/harivansh-afk/loom-index-e2e --skill synthesize-harivansh-afk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: synthesize
Source: https://github.com/harivansh-afk/loom-index-e2e/tree/main/skills/synthesize
Command: npx skills add https://github.com/harivansh-afk/loom-index-e2e --skill synthesize-harivansh-afk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Open architecture and technical-decision questions often get answered with the first plausible idea, with no devil's advocate and no grounding in evidence. This Skill runs a structured research-propose-critique-refine loop that converges on a defensible recommendation instead of a confident guess. ## Core Features & Use Cases - Grounded research: Gathers external prior art via Exa web search and internal evidence from the codebase before drafting anything, with every claim cited. - Separated critic: Spawns a read-only synthesis-critic agent in its own isolated context that scores the proposal against a frozen rubric and returns severity-ranked findings with a PASS/REVISE verdict. - Bounded convergence: Stops on PASS, no progress, oscillation, or a hard cap of 3 iterations, then emits an ADR-shaped decision memo with alternatives, tradeoffs, and open questions. - Use Case: Ask "what's the right cache invalidation strategy for this service" and receive a decision memo comparing 2-3 genuine alternatives, each rejected for a specific cited reason. ## Quick Start Ask the assistant to synthesize the best architecture for your problem, for example: "Research and propose the best wire format for our SDK boundary, iterate until it converges."

Frequently Asked Questions about synthesize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a well-researched architecture recommendation from an AI?▼

Frame the question in one sentence, freeze a checklist of 3-7 binary success criteria, then ground the answer in web search and codebase evidence before drafting. A separate read-only critic scores each draft against the rubric until it passes or the iteration cap is hit.

What is a generator-critic loop for technical decisions?▼

A generator-critic loop drafts a proposal, then has an independent critic tear it apart against fixed criteria, and refines only the flagged spans. Research shows the gain curve is concave: one or two critique rounds capture nearly all the improvement.

Why should the critic be a separate agent instead of self-critique?▼

Same-model self-critique rubber-stamps because the model treats its own committed text as finished work. A separate read-only critic in an isolated context has decorrelated blind spots and cannot rationalize defects it would have committed itself.

When should I not use an iterative critique loop for a decision?▼

Skip it when best practice clearly applies, when the question is a pure fact lookup, or when evaluation needs knowledge the model lacks. On ungroundable questions the loop polishes a confident wrong answer into a more confident wrong answer.

How many critique iterations does a decision loop need?▼

Expect convergence in one to two rounds, with a hard cap of three. Iteration 0 to 1 is the big lift, round 2 catches the remainder, and round 4 or beyond regresses through over-editing, so stop and report unresolved points instead.