Add branding assets and README hero

Author: wimi321

README.md

@@ -6,15 +6,21 @@
 [![GitHub stars](https://img.shields.io/github/stars/wimi321/task-bundle?style=social)](https://github.com/wimi321/task-bundle/stargazers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
+![Task Bundle hero banner](./assets/hero-banner.svg)
+
 Turn AI coding runs into portable, replayable, benchmark-ready task bundles.
 
+The missing middle layer between raw chat logs and heavyweight benchmark platforms.
+
+Package a task once, inspect it later, compare tools on the same starting point, and generate benchmark-style reports from real artifacts.
+
 Task Bundle is a TypeScript + Node.js CLI for teams building agents, evals, coding benchmarks, and reproducible AI workflows.
 
-What makes it compelling:
-- package one coding task into a clean, shareable directory
-- compare outputs across tools and models with real metadata and artifact hashes
-- generate benchmark-style reports from a directory of bundles
-- keep enough context to rerun work later without pretending replay means token-perfect recording
+Why people star it:
+- turn one AI coding run into a clean, shareable directory instead of a screenshot, transcript, or loose patch
+- compare Codex, Claude Code, Cursor, or internal agents with real metadata, hashes, and outcome fields
+- generate benchmark-style reports from a folder of bundles without building a full evaluation platform first
+- keep replay grounded in re-execution and comparison, not token-by-token theater
 
 If you've ever wanted a format between "a raw chat log" and "a full benchmark platform", this project is that missing middle layer.
 
@@ -67,6 +73,7 @@ See:
 - [docs/bundle-format.zh-CN.md](./docs/bundle-format.zh-CN.md)
 - [docs/design-decisions.md](./docs/design-decisions.md)
 - [docs/replay-contract.md](./docs/replay-contract.md)
+- [docs/branding.md](./docs/branding.md)
 
 ## Five-Minute Demo
 

README.zh-CN.md

@@ -6,15 +6,21 @@
 [![GitHub stars](https://img.shields.io/github/stars/wimi321/task-bundle?style=social)](https://github.com/wimi321/task-bundle/stargazers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
+![Task Bundle hero banner](./assets/hero-banner.svg)
+
 把 AI coding 过程，变成可分享、可重跑、可比较、可做 benchmark 的任务包。
 
+它是“原始聊天记录”和“重型 benchmark 平台”之间，那层真正好用的中间层。
+
+一次打包，之后就能 inspect、compare、validate、report，也能把不同工具放到同一起点上做更公平的对照。
+
 Task Bundle 是一个 TypeScript + Node.js CLI，适合 agent、eval、benchmark、可复现实验这类工作流。
 
-它吸引人的地方在于：
-- 能把一次 coding 任务整理成干净、稳定、可搬运的目录
-- 能在不同工具和模型之间做真实比较，不只是看聊天记录
-- 能从一组 bundle 直接生成 benchmark 风格报告
-- 能为后续 replay 保留足够上下文，但不假装逐 token 复刻才叫“可复现”
+大家愿意给它点 star，通常是因为这些点：
+- 它能把一次 AI coding 任务整理成干净、稳定、可搬运的目录，而不是散落的截图、聊天记录或 patch
+- 它能比较 Codex、Claude Code、Cursor 或内部工具的结果，而且比较依据是真实元数据、哈希和 outcome 字段
+- 它能从一组 bundle 直接生成 benchmark 风格报告，不用一开始就搭完整评测平台
+- 它对 replay 的理解更务实，强调“可重跑、可比较”，而不是追求逐 token 复刻的表演感
 
 如果你一直觉得“聊天记录太散、benchmark 平台太重”，这个项目就是中间那层缺失的基础设施。
 
@@ -67,6 +73,7 @@ task-bundle/
 - [docs/bundle-format.md](./docs/bundle-format.md)
 - [docs/design-decisions.md](./docs/design-decisions.md)
 - [docs/replay-contract.md](./docs/replay-contract.md)
+- [docs/branding.md](./docs/branding.md)
 
 ## 五分钟演示
 

assets/hero-banner.svg

@@ -0,0 +1,24 @@
+# Branding Assets
+
+Task Bundle includes repository-ready visual assets under `assets/`.
+
+The art direction is intentionally warm-editorial rather than generic SaaS gradients: a calm dark field, paper-toned bundle cards, and a benchmark signal accent that reinforces "portable tasks" plus "measurable outcomes."
+
+## Files
+
+- `assets/hero-banner.svg`
+  Embedded at the top of the README to make the repository landing page feel like a product, not just a package listing.
+- `assets/social-preview.svg`
+  Source artwork for GitHub social preview uploads.
+- `assets/social-preview.png`
+  Recommended raster export for GitHub social preview uploads. Kept in the repository for easy manual upload, but not required in the npm package.
+
+## Suggested GitHub Setup
+
+1. Open the repository settings page.
+2. Go to `General` -> `Social preview`.
+3. Upload `assets/social-preview.png`.
+
+## Local Export Tips
+
+If you want to regenerate the PNG on macOS, you can use Quick Look or another SVG-to-PNG tool. The repository artwork is intentionally kept as SVG so it stays editable and versionable, while the committed PNG keeps GitHub social preview setup friction low.

assets/social-preview.png

@@ -31,8 +31,12 @@
     "dist",
     "examples",
     "docs",
+    "assets/hero-banner.svg",
+    "assets/social-preview.svg",
     "templates",
-    "README.md"
+    "LICENSE",
+    "README.md",
+    "README.zh-CN.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",