`references/sources.md`

79 lines
# Sources — where the tips come from

## Primary subject

- **@tiktok_architect** — TikTok creator (`tiktok.com/@tiktok_architect`),
  "AI Educator" genre. Posts short-form **Claude Code / vibecoding** tips and
  anti-patterns. The seed video for this skill: *"Never ask Claude code to do
  this!"* (`#claude #claudecode #techtok #chatgptprompts #vibecoding`).
- **What he posts (the signal this skill harvests):** recurring formats like
  *"Never ask Claude Code to do X"*, *"Never ever ask Claude for this"*, *"How
  to get Claude Code for free"*, *"3 prompts that…"* — short spoken tips with the
  claim in the caption + on-screen text.

## ⚠️ The feed is MIXED — filter before you spend effort

@tiktok_architect is **not** a pure Claude-Code channel. Recent uploads
interleave motorcycles (`#motorcyclesoftiktok #hondarebel`), hobbies
(`#hobbiesinyour20s`), and privacy takes with the Claude tips. **Only scout the
Claude/AI-coding videos.** `tt-list.js` sets `claude_relevant` per video by
hashtag/keyword — trust that flag and skip the rest. Never treat every post as a
tip.

## ⚠️ The "Never ask Claude for X" format is IRONIC — decode it FIRST

Verified live 2026-07-19 by transcribing 5 videos: this creator's whole format is
**reverse psychology**. *"Never ask Claude to do X"* literally means *"here's an X
you can build with Claude."* The sarcasm ("we definitely wouldn't want to break
terms of service, right?") IS the gag. **Before evaluating any tip, decode the
irony** — flip every "never/don't" to "here's how to", and judge the REAL payload.

And the real payloads trend **harmful**, not helpful: the sampled run decoded to a
FB-Marketplace→eBay arbitrage scraper (TOS), a game aimbot/ESP wall-hack site +
AdSense/SEO spam (cheat + ad fraud), a WebRTC chat client that logs peer IPs to
"bait creeps" (entrapment/privacy), and an uncensored-LLM chat bot posing as an
18-19yo for adult affiliate offers (illegal). So this is **NOT a Claude-Code
best-practices feed** — it's edgy engagement bait. Expect the safety dimension to
route most/all decoded tips to SKIP, and flag the harmful ones loudly. NEVER build
one of these payloads; the scout only surfaces + classifies them.

## ⚠️ Tips are CLAIMS, not facts — verify (after decoding the irony)

A decoded tip is still just a CLAIM. Even the rare genuinely-useful one is
engagement-optimized and frequently **outdated, model/version-stale, or just
wrong**. The rubric's first gate is **correctness** — a
tip that isn't true for *current* Claude Code is SKIP no matter how catchy.
Verify against the `claude-code-guide` subagent, the `claude-docs` / `claude-api`
skills, and official docs (docs.claude.com / docs.anthropic.com) BEFORE it is
ever proposed for MEMORY.md.

## Retrieval sources, in priority order

1. **oEmbed** (`scripts/tt-oembed.js`) — for a single dropped link (incl. a
   `/t/<short>` redirect). Returns caption + hashtags + author + a
   `claude_relevant` flag. No JS, no auth, `$0`. The reliable primitive.
2. **yt-dlp creator listing** (`scripts/tt-list.js`) — "what's new": the newest
   N videos with captions + relevance flags. `$0`. Prints an "attempting
   impersonation" WARNING even on success — that's not an error.
3. **Transcript** (`scripts/tt-transcript.sh`) — ONLY when the caption doesn't
   pin the tip's specifics. Tries yt-dlp subs (usually empty on TikTok), then
   LOCAL whisper on the audio (`$0`). Optional — most tips are identifiable from
   the caption alone.
4. **Exa / WebSearch mirrors** — when TikTok throttles or a claim needs a
   second source: search the tip's phrasing (e.g. `tiktok_architect "never ask
   claude code"`) to find reposts, article write-ups, or the same tip discussed
   on Reddit/X. Exa is metered — show/log the cost.
5. **The direct video HTML is JS-rendered** — `curl`/WebFetch on it returns only
   the "Make Your Day" shell. Never rely on it; use oEmbed/yt-dlp.

## Similar creators worth folding into a wider sweep

The skill's value is "surface Claude Code / AI-coding tips worth adopting."
@tiktok_architect is the anchor; the same signal shows up from other TikTok/
Shorts AI-coding educators. Add handles here as they prove useful (keep the
mixed-feed relevance filter on all of them). Cross-reference the tool-side
scout `gurisingh-scout` when a tip actually names an open-source repo.

Keep this file current: when a new mirror/source proves reliable, or a creator
stops being worth watching, edit it here so the next run inherits the lesson.