From 777276845ac1673b6ddc279ceb9b3a7adf3e8765 Mon Sep 17 00:00:00 2001
From: Shayan Rais <shanraisshan@gmail.com>
Date: Thu, 5 Mar 2026 16:27:19 +0500
Subject: [PATCH] added billion dollar question section

---
 !/tags/billion-dollar-questions.svg | 65 +++++++++++++++++++++++++++++
 README.md                           | 20 +++++++++
 2 files changed, 85 insertions(+)
 create mode 100644 !/tags/billion-dollar-questions.svg

diff --git a/!/tags/billion-dollar-questions.svg b/!/tags/billion-dollar-questions.svg
new file mode 100644
index 0000000..ba7fa5d
--- /dev/null
+++ b/!/tags/billion-dollar-questions.svg
@@ -0,0 +1,65 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="360" height="44" role="img" aria-label="Billion-Dollar Questions">
+  <title>Billion-Dollar Questions</title>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#b8860b"/>
+      <stop offset="30%" stop-color="#daa520"/>
+      <stop offset="50%" stop-color="#ffd700"/>
+      <stop offset="70%" stop-color="#daa520"/>
+      <stop offset="100%" stop-color="#b8860b"/>
+    </linearGradient>
+    <linearGradient id="shine" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#fff" stop-opacity="0"/>
+      <stop offset="0.35" stop-color="#fff" stop-opacity="0"/>
+      <stop offset="0.5" stop-color="#fff" stop-opacity=".45"/>
+      <stop offset="0.65" stop-color="#fff" stop-opacity="0"/>
+      <stop offset="1" stop-color="#fff" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="depth" x2="0" y2="1">
+      <stop offset="0" stop-color="#fff" stop-opacity=".15"/>
+      <stop offset="1" stop-color="#000" stop-opacity=".2"/>
+    </linearGradient>
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="1.5" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <clipPath id="r">
+      <rect width="360" height="44" rx="6" fill="#fff"/>
+    </clipPath>
+  </defs>
+  <style>
+    @keyframes shimmer {
+      0% { transform: translateX(-360px); }
+      100% { transform: translateX(360px); }
+    }
+    @keyframes pulse {
+      0%, 100% { opacity: .6; }
+      50% { opacity: 1; }
+    }
+    .sweep { animation: shimmer 3s ease-in-out infinite; }
+    .diamond { animation: pulse 2s ease-in-out infinite; }
+  </style>
+  <g clip-path="url(#r)">
+    <!-- base gold gradient -->
+    <rect width="360" height="44" fill="url(#bg)"/>
+    <!-- depth overlay -->
+    <rect width="360" height="44" fill="url(#depth)"/>
+    <!-- top highlight line -->
+    <rect width="360" height="1" fill="#fff" fill-opacity=".25"/>
+    <!-- bottom shadow line -->
+    <rect y="43" width="360" height="1" fill="#000" fill-opacity=".3"/>
+    <!-- animated shine sweep -->
+    <rect class="sweep" width="360" height="44" fill="url(#shine)"/>
+  </g>
+  <!-- diamond accents -->
+  <text class="diamond" x="16" y="29" font-size="16" fill="#fff" fill-opacity=".9" filter="url(#glow)">&#9670;</text>
+  <text class="diamond" x="336" y="29" font-size="16" fill="#fff" fill-opacity=".9" filter="url(#glow)">&#9670;</text>
+  <!-- main text with shadow -->
+  <g font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" text-anchor="middle">
+    <text x="181" y="29" font-size="19" font-weight="bold" fill="#000" fill-opacity=".3">Billion-Dollar Questions</text>
+    <text x="180" y="28" font-size="19" font-weight="bold" fill="#fff" filter="url(#glow)">Billion-Dollar Questions</text>
+  </g>
+</svg>
\ No newline at end of file
diff --git a/README.md b/README.md
index 8db5eaf..2d96c81 100644
--- a/README.md
+++ b/README.md
@@ -149,6 +149,26 @@ claude
 |[**Plan Mode**](https://code.claude.com/docs/en/common-workflows)|[Agent OS](https://github.com/buildermethods/agent-os)|
 |[**Skills / Plugins**](https://code.claude.com/docs/en/plugins)|YC AI wrapper startups ([reddit](https://reddit.com/r/ClaudeAI/comments/1r6bh4d/claude_code_skills_are_basically_yc_ai_startup/))|
 
+![Billion-Dollar Questions](!/tags/billion-dollar-questions.svg)
+**Memory & Instructions (4)**
+
+1. What exactly should you put inside your CLAUDE.md — and what should you leave out?
+2. If you already have a CLAUDE.md, is a separate constitution.md or rules.md actually needed?
+3. How often should you update your CLAUDE.md, and how do you know when it's become stale?
+4. Why does Claude still ignore CLAUDE.md instructions — even when they say MUST in all caps? ([reddit](https://reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/))
+
+**Agents, Skills & Workflows (3)**
+
+1. When should you use a command vs an agent vs a skill — and when is vanilla Claude Code just better?
+2. How often should you update your agents, commands, and workflows as models improve?
+3. Does giving your subagent a detailed persona improve quality? What does a "perfect persona/prompt" for research/QA subagent look like?
+
+**Specs & Documentation (3)**
+
+1. Should every feature in your repo have a spec as a markdown file?
+2. How often do you need to update specs so they don't become obsolete when a new feature is implemented?
+3. When implementing a new feature, how do you handle the ripple effect on specs for other features?
+
 ## REPORTS
 
 | Report | Description |