Evaluate every new dependency, pattern, API, or architectural decision against these 8 criteria.
| Criterion | Question | Red Flag |
|---|---|---|
| Benefit | What concrete problem does it solve? Measurable impact? | "Might need it later", "because it's best practice" |
| Necessity | What happens if we don't? Is there a simpler alternative? | Adding something new when existing solution is sufficient |
| { | |
| "$schema": "Instinct JSON Schema — Claude Code Learning Pipeline", | |
| "description": "Schema for mature-instincts.json and global-instincts.json files used by the learning pipeline.", | |
| "raw_capture_record": { | |
| "description": "Written by passive-learner.py (PostToolUse hook) to instincts.jsonl", | |
| "example": { | |
| "ts": "2026-04-07T10:15:00Z", | |
| "project": "my-project", | |
| "pattern": "missing-import", |
| #!/usr/bin/env python3 | |
| """Coffee Analysis CLI — Analyze AI mistake patterns from coffee-log.jsonl. | |
| Usage: | |
| python3 coffee-analyze.py # 7-day summary | |
| python3 coffee-analyze.py --days 30 # 30-day lookback | |
| python3 coffee-analyze.py --format json # JSON output | |
| Data source: ~/.claude/coffee-log.jsonl (produced by coffee-tracker.sh hook) | |
| Debt file: ~/.claude/coffee-debt (cumulative bean count) |
| /** | |
| * Market Bridge - Custom Pixel Example (Lax Sandbox) | |
| * | |
| * Reads market cookie written by storefront and enriches pixel events. | |
| * Debug logs use "Market Pixel" prefix in browser console. | |
| * | |
| * Note: Shopify's native visitorConsentCollected event is NOT available | |
| * in the pixel sandbox. Consent is read from init.customerPrivacy | |
| * (fixed for page lifetime). However, some third-party CMP apps | |
| * (UniConsent, CookieBot, etc.) can emit their own consent events |
| {% comment %} | |
| Market Bridge - Storefront Example (Theme App Extension / App Embed Block) | |
| Full working example with debug logging. | |
| Includes: Liquid serialization + storageHelper + market bridge + consent handler. | |
| Debug logs use "Market Bridge" prefix in browser console. | |
| @see https://ceaksan.com/tr/shopify-markets-cookie-bridge-consent-aware-veri-koprusu | |
| @license MIT |
| /** | |
| * Shopify Market Bridge - Consent-Gated Market Cookie Writer | |
| * | |
| * Writes Shopify Markets localization data (country, language, currency, | |
| * market handle) to a cookie via storageHelper. This data is not available | |
| * in the pixel sandbox init event, so the cookie acts as a bridge between | |
| * the storefront (Theme App Extension) and Custom Pixel. | |
| * | |
| * Requires: | |
| * 1. storageHelper (see companion gist) |
| /** | |
| * storageHelper - Cookie + localStorage Dual-Write Utility | |
| * | |
| * Conversion Linker pattern: cookie + localStorage parallel write. | |
| * Cookie is sent to server with every HTTP request and works cross-subdomain | |
| * (via domain attribute), but Safari ITP caps client-side cookies to 7 days. | |
| * localStorage has no ITP expiry limit (except inactivity purge). | |
| * If cookie expires, data is read from localStorage as fallback. | |
| * localStorage doesn't work cross-subdomain but is sufficient as | |
| * an ITP-resilient backup within the same origin. |
| (function () { | |
| var cartPath = "/sepet"; | |
| var orderPath = "/siparis-sonuc"; | |
| var currentPath = window.location.pathname; | |
| if (currentPath.indexOf(cartPath) > -1) { | |
| sessionStorage.setItem("cartVisited", "true"); | |
| } else { | |
| var wasInCart = sessionStorage.getItem("cartVisited"); |
| (function (root) { | |
| 'use strict'; | |
| var DEFAULTS = { | |
| contentSelector: '.main-content', | |
| thresholds: [25, 50, 75, 100], | |
| dwellThreshold: 2000, | |
| skipThreshold: 600, | |
| velocityThreshold: 2.5, | |
| skipVelocityRatio: 3, |