start-vibing 4.4.15 → 4.4.17

package/template/.claude/skills/research/templates/research.md.tpl

@@ -7,111 +7,81 @@ content_type_bucket: "{{BUCKET}}"            # fast | medium | slow | permanent
 freshness: "{{FRESHNESS}}"                    # fresh | aging | stale | outdated
 freshness_window_days: {{WINDOW_DAYS}}
 playbook: "{{PLAYBOOK}}"
-domain: "{{DOMAIN}}"
 sources_count: {{SOURCES_COUNT}}
 findings_count: {{FINDINGS_COUNT}}
-disagreements_count: {{DISAGREEMENTS_COUNT}}
-open_questions_count: {{OPEN_Q_COUNT}}
 confidence_summary: "{{CONFIDENCE_SUMMARY}}"  # e.g. "5 high · 3 medium · 1 low"
-concepts:
-{{CONCEPTS_YAML_LIST}}
-session_id: "{{SESSION_ID}}"
+concepts:                                     # CAP at 8 — primary search keywords only
+{{CONCEPTS_YAML_LIST_MAX_8}}
 ---
 
-# Research: {{TITLE}}
+# {{TITLE}}
 
 > Bucket: **{{BUCKET}}** · Status: **{{FRESHNESS}}** · Confidence: {{CONFIDENCE_SUMMARY}}
 > Session: `docs/research/.cache/sessions/{{SESSION_ID}}/`
 
-## Executive summary
-
-{{EXEC_SUMMARY}}
-
-## Question
-
-{{ORIGINAL_QUESTION}}
-
-## Ontology Map
+---
 
-Concepts and their relationships using the SKOS-adapted vocabulary
-(see `.claude/skills/research/references/ontology-patterns.md`).
+## TL;DR — {{TLDR_HEADLINE}}
 
-```
-{{ONTOLOGY_RELATIONS}}
-```
+{{TLDR_LEAD_PARAGRAPH_1_TO_3_SENTENCES}}
 
-## Findings
+{{#each TLDR_BULLET}}
+{{N}}. **{{VERDICT_PHRASE}}.** {{ONE_SENTENCE_RATIONALE}} ({{INLINE_CITATION}})
+{{/each}}
 
-{{#each FINDING}}
-### Finding {{ID}} — {{TITLE}}
+---
 
-{{ASSERTION}}
+## Why this matters
 
-**Confidence:** {{CONFIDENCE}}{{#if FRESHNESS_WARNING}} · _Freshness warning: {{FRESHNESS_WARNING}}_{{/if}}{{#if TRIANGULATION_WARNING}} · _Triangulation: {{TRIANGULATION_WARNING}}_{{/if}}
+{{CONTEXT_2_TO_4_PARAGRAPHS — ground the reader in the problem the research actually addresses; cite the originating constraint or pain point. Keep it engineering-blog tone. NO methodology box, NO triangulation discussion here.}}
 
-Evidence:
+---
 
-{{#each EVIDENCE}}
-> "{{QUOTE}}" [{{SOURCE_ID}}]
-> URL: {{URL}}
-> Accessed: {{ACCESSED_AT}}
-> Verify: {{VERIFY_METHOD}}
-{{/each}}
+## What we found
 
+{{#each FINDING}}
+- **{{ASSERTION_AS_VERDICT}}** — {{ONE_OR_TWO_SENTENCE_EVIDENCE_SUMMARY_WITH_INLINE_HYPERLINK}}. _[{{CONFIDENCE}} — {{TRIANGULATION_TAGS}}]_
 {{/each}}
 
-## Disagreements
-
-{{#each DISAGREEMENT}}
-### {{TOPIC}}
-
-- **Position A** ([{{SRC_A}}]): {{POSITION_A}}
-- **Position B** ([{{SRC_B}}]): {{POSITION_B}}
-- **Resolution requires:** {{RESOLUTION_HINT}}
-{{/each}}
+> Use bolded-bullet flat format. Do NOT use the heavy "### Finding N" / paragraph / blockquote / confidence-label pattern.
+> Inline citation style: embedded hyperlink in the prose — `[Anthropic Engineering](URL)` — NOT bracketed numerics. Reserve `[1]` numerics only when the user explicitly requested footnote style.
 
-## Recommendations
+{{#if DISAGREEMENTS_EXIST}}
+---
 
-### DO
+## Where the evidence disagrees
 
-{{#each RECOMMENDATION_DO}}
-- {{TEXT}} — _{{REASON}}_
+{{#each DISAGREEMENT}}
+- **{{TOPIC}}**: [{{SRC_A_LABEL}}]({{SRC_A_URL}}) says "{{POSITION_A}}". [{{SRC_B_LABEL}}]({{SRC_B_URL}}) says "{{POSITION_B}}". Resolution would require {{RESOLUTION_HINT}}.
 {{/each}}
+{{/if}}
 
-### AVOID
+---
 
-{{#each RECOMMENDATION_AVOID}}
-- {{TEXT}} — _{{REASON}}_
-{{/each}}
+## Trade-offs
 
-## Implementation Path
+{{TRADE_OFFS_2_TO_5_BULLETS — what the recommended approach gives up, NOT a separate "AVOID" list. Frame as "Choosing X means losing Y." Each bullet cites at least one source.}}
 
-{{#each STEP}}
-{{N}}. {{TEXT}}
-{{/each}}
+{{#if OPEN_QUESTIONS_EXIST}}
+---
 
-## Open Questions
+## Open questions
 
 {{#each OPEN_Q}}
 - {{TEXT}}
 {{/each}}
+{{/if}}
 
-## Dead Ends
-
-_Searched but not found / not applicable_
-
-{{#each DEAD_END}}
-- {{TEXT}}
-{{/each}}
+---
 
 ## Sources
 
-| ID | Title | Publisher | Authority (1-5) | Independence | Accessed | URL |
-|----|-------|-----------|-----------------|--------------|----------|-----|
+| ID | Title | Publisher | Authority | Independence | Accessed |
+|----|-------|-----------|-----------|--------------|----------|
 {{#each SOURCE}}
-| {{ID}} | {{TITLE}} | {{PUBLISHER}} | {{AUTHORITY_LEVEL}} | {{INDEPENDENCE}} | {{ACCESSED_AT}} | {{URL}} |
+| {{ID}} | [{{TITLE}}]({{URL}}) | {{PUBLISHER}} | {{AUTHORITY_LEVEL}}/5 | {{INDEPENDENCE}} | {{ACCESSED_AT}} |
 {{/each}}
 
 ---
 
-_Generated by the `research` skill. Pipeline: scout → query → synthesize → verify. Verify status: {{VERIFY_STATUS}}._
+_Research pipeline: scout → query → synthesize → verify. Verify status: **{{VERIFY_STATUS}}**. {{N_PASS}} pass · {{N_STALE}} stale · {{N_FAIL}} fail._