feat(onboarding): browser-first README + starter_questions for 8 masters

Shift the README narrative so that non-developer users — the 99% of the
actual audience — find the browser entry point first and the CLI install
second. The old structure buried fojin.app/chat at line 48 under a wall
of developer badges.

Changes:

- README.md / README_EN.md: new "立即体验 / Try It Now" hero section
  right after the title block, with a big call-to-action linking to
  fojin.app/chat, a "which master should I ask" recommendation table,
  and an explicit redirect for CLI users to the developer section.
- Rename "快速开始 / Quick Start" → "开发者安装 / Developer Installation"
  with a clear "if you just want to try it, use the browser instead"
  callout at the top.
- Update TOC anchors in both languages to match.

- prebuilt/<master>/meta.json × 8: new `starter_questions` field with
  4 Q&A entries per master. Each entry has `q` (the question) and `why`
  (why this question is suited for this specific master's voice and
  source corpus). Intended consumer: fojin.app/chat can fetch the raw
  meta.json on master selection and render these as cold-start prompts
  — solving the empty-input-box problem for first-time users.

Rationale: the biggest onboarding gap for non-CLI users is "I don't
know what to ask this master." A curated 4-question starter per master
provides both a safe entry point and a teaching signal about what this
particular master is actually good at answering.

Validated: scripts/validate.py --strict passes (9/9 masters).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
xianren
2026-04-11 10:46:32 +08:00
parent 6b0ce62b20
commit 7e2070318d
10 changed files with 220 additions and 28 deletions
+34 -10
View File
@@ -28,9 +28,10 @@
</p>
<p align="center">
<a href="#try-it-now-browser-first">Browser</a> ·
<a href="#seriousness-statement">Statement</a> ·
<a href="#features">Features</a> ·
<a href="#quick-start">Install</a> ·
<a href="#developer-installation">Install</a> ·
<a href="#pre-built-masters">Masters</a> ·
<a href="#relationship-to-fojin">FoJin</a> ·
<a href="README.md">中文</a>
@@ -38,6 +39,34 @@
---
## Try It Now (Browser-First)
> **Most users don't need to install anything.** Buddhist students, researchers, and curious readers can use every master directly in a web browser.
### 👉 [Open fojin.app/chat](https://fojin.app/chat)
On the AI Q&A page, open the **"法师模式"** (Master Mode) dropdown in the bottom-left and pick one of the 8 pre-built masters to start chatting.
- No install, no signup
- `/compare-masters` multi-master comparison works the same way
- Live citation retrieval backed by FoJin's 503 sources and 678K+ semantic embeddings
- Every answer carries a CBETA source ID
**Not sure which master to ask?** Start here:
| Your situation | Suggested master |
|---|---|
| "My mind is scattered, I can't sit still" | `/xuyun` `/zhiyi` (huatou / śamatha-vipaśyanā) |
| "I can't follow the logic of the sutras" | `/xuanzang` (Yogācāra precision) |
| "I've studied for years but feel stuck" | `/yinguang` (plain, sincere nianfo) |
| "I want to understand emptiness" | `/kumarajiva` `/huineng` (Madhyamaka / direct pointing) |
| "I want a systematic view of Huayan / Tiantai" | `/fazang` `/zhiyi` (classification and metaphysics) |
| "I'm torn between Chan and Pure Land" | `/ouyi` (cross-tradition synthesis) |
> Developers and Claude Code / Cursor users should skip to [Developer Installation](#developer-installation) to use the masters as terminal AgentSkills.
---
> **v0.3 Update**: Full architecture rebuild — CBETA provenance in frontmatter, offline source passages (`sources/`), automated fidelity tests (`fidelity.jsonl`), one-command NPX installer, and offline toolchain (`cite.py` / `query.py`).
>
> **Post-v0.3 iterations**: `/create-master` pipeline now enforces a two-stage independent review (doctrinal accuracy → voice consistency), HARD-GATE rules (no CBETA citation → no write), multi-platform plugin support across Claude Code / Cursor / Codex / OpenCode / Gemini CLI, a session-start hook that auto-injects the master list, plus pressure tests and CI validation for all 8 prebuilt masters.
@@ -54,14 +83,6 @@ This project is built out of respect for Buddhist traditions. All content is gen
---
## Online Demo
No installation required — try all pre-built masters directly in your browser:
**[fojin.app/chat](https://fojin.app/chat)** — Open the AI Q&A page, select a master from the "法师模式" dropdown (bottom-left), and start chatting.
---
## Features
- **8 pre-built Chinese Buddhist masters**: across Yogacara, Madhyamaka, Chan, Tiantai, Huayan, Pure Land, and cross-tradition — ready to use out of the box
@@ -79,7 +100,10 @@ No installation required — try all pre-built masters directly in your browser:
---
## Quick Start
## Developer Installation
> 👤 **Just want to try it?** Use [fojin.app/chat](https://fojin.app/chat) in your browser and skip this section entirely.
> 🛠️ **This section is for**: Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI users who want to invoke `/xuanzang`, `/huineng`, etc. directly as terminal AgentSkills.
### Installation