fix: inline links on first pass, rebalance rule emphasis
Live test on Ghostty after the prior commit showed a regression: first-pass /last30days synthesis stripped all inline links. Only after the user asked "weren't these links supposed to be clickable?" did the agent re-render with inline links. Agent's own root cause: "I misread LAW 1 — over-applied 'no trailing Sources: block' to mean 'no URLs anywhere'." The templates and per-citation examples were already correct. The regression was in EMPHASIS BALANCE — the anti-trailing-Sources prohibition used the loudest prose (CRITICAL OVERRIDE, MANDATORY, MUST NOT) while the pro-inline- link rule read as lighter guidance. On a fresh first read, the agent collapsed both into one prohibition and stripped every citation link. This commit rebalances emphasis and adds a forcing function: - New "TWO HARD RULES FOR LINKS" framing at the top of the output section names RULE A (inline links required on every citation) and RULE B (no trailing list of links) as a matched pair with equal rhetorical weight. Explicit: "These rules are complementary, not alternatives." - New "PRE-SYNTHESIS COMMIT" step forces the agent to identify sources, pull URLs, and commit to inline-link placement BEFORE drafting — not audit after the fact. - Existing CRITICAL OVERRIDE block now opens by pointing back to the matched-pair framing and drops the "Your citation is the Web: line. Nothing else is needed." priming sentence that biased the agent toward link-free drafts. - New BAD/ALSO-BAD/GOOD triple in the CRITICAL OVERRIDE block shows the exact regression shape (stripping inline links to "comply" with RULE B) as a distinct failure mode, not just the trailing-list failure. - PRE-PRESENT SELF-CHECK reworked: item 6 becomes "RULE B — no trailing list", item 7 becomes "RULE A — inline links present on first pass" with a positive count check that regenerates if zero inline links appear when raw data had URLs (the exact 2026-04-20 regression repro). - Release notes entry gains one line describing the first-pass guarantee. No Python changes. This is an amendment on PR #286 folding the fix into the same review. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -6,6 +6,8 @@ The AI world reinvents itself every month. This skill keeps you current.
|
||||
|
||||
Every cited source in the synthesis (X handles, subreddits, publications, YouTube channels, Polymarket markets) now renders as a blue CMD-clickable markdown link in the terminal. No raw URL strings — just clean link text you can click straight through to the source. Works in Claude Code on any terminal that supports OSC 8 hyperlinks (Ghostty, iTerm, Warp, others).
|
||||
|
||||
The skill follows two hard rules: inline links required on every citation, no trailing list of links anywhere. Both fire on first pass — no need to ask twice.
|
||||
|
||||
Credit to [@jay_k](https://x.com/jay_k) for surfacing the missing link-back in the reply thread, and to [@photomatt](https://x.com/photomatt) for confirming CMD-click works in Claude Code — that was the nudge to flip the rule.
|
||||
|
||||
## v3 is the intelligent search release
|
||||
|
||||
Reference in New Issue
Block a user