ship-create 1.7.0 → 1.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -19,11 +19,32 @@ Read `docs/PROJECT.md` and `docs/HUMAN_FLOW.md`. Extract:
|
|
|
19
19
|
- UI language from Section 9 — switch language now, use it for everything after this
|
|
20
20
|
- Auto-select the best theme from `theme-guide.md` for this product type — do not ask, just pick
|
|
21
21
|
|
|
22
|
-
### Step 2 — Build docs
|
|
22
|
+
### Step 2 — Build docs + flow diagram
|
|
23
23
|
Write `docs/AI_BUILD_SPEC.md` immediately — functional requirements for the 2–3 core MVP features + data model. Keep it tight, 1 page max.
|
|
24
24
|
|
|
25
|
+
Then generate `docs/FLOW.md` — a Mermaid flowchart of the full user journey from `HUMAN_FLOW.md`. Include every screen, decision point, happy path, and key error/empty states. Format:
|
|
26
|
+
|
|
27
|
+
```markdown
|
|
28
|
+
# User Flow
|
|
29
|
+
|
|
30
|
+
> แก้ได้โดยตรงในไฟล์นี้ — เปิด Preview ใน VS Code (Cmd+Shift+P → "Mermaid Preview") หรือวางใน https://mermaid.live
|
|
31
|
+
|
|
32
|
+
```mermaid
|
|
33
|
+
flowchart TD
|
|
34
|
+
...
|
|
35
|
+
```
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Rules for the diagram:
|
|
39
|
+
- Use `([text])` for entry/exit points (stadium shape)
|
|
40
|
+
- Use `[text]` for screens/pages
|
|
41
|
+
- Use `{text}` for decision points
|
|
42
|
+
- Use `-->|label|` for conditional paths
|
|
43
|
+
- Show the happy path left-to-right or top-to-bottom
|
|
44
|
+
- Keep node labels short (3–5 words max)
|
|
45
|
+
|
|
25
46
|
### Step 3 — Build prototype
|
|
26
|
-
|
|
47
|
+
Generate a fresh theme from scratch based on the product type — **never reuse the default colors already in `app/globals.css`**. Overwrite the entire `:root` and `.dark` blocks with new values derived from `theme-guide.md` and the product context. Apply to `app/globals.css` and `app/layout.tsx`. Replace `app/page.tsx` with the real home screen based on `HUMAN_FLOW.md`. Build the first 1–2 screens that matter most for this product type. Record the theme choice in `docs/DESIGN_SYSTEM.md`.
|
|
27
48
|
|
|
28
49
|
### Step 4 — Run
|
|
29
50
|
Run `npm run dev` (or `pnpm dev` if pnpm is available). Confirm the app compiles and is accessible at localhost:3000.
|
|
@@ -32,6 +53,7 @@ Run `npm run dev` (or `pnpm dev` if pnpm is available). Confirm the app compiles
|
|
|
32
53
|
Tell the user (in the correct language):
|
|
33
54
|
- What was built and why (2–3 sentences max)
|
|
34
55
|
- Which theme was chosen and why (1 sentence)
|
|
56
|
+
- Where to see the flow diagram: `docs/FLOW.md` (เปิด Preview ใน VS Code หรือ https://mermaid.live)
|
|
35
57
|
- "เปิด localhost:3000 ดูได้เลย — ชอบทิศทางนี้ไหม?" (Thai) or "Open localhost:3000 — does this feel right?" (English)
|
|
36
58
|
|
|
37
59
|
**That's Phase 1. Wait for the user's answer before doing anything else.**
|
|
@@ -56,6 +78,7 @@ Run through `docs/QA_CHECKLIST.md` silently. Report only what's missing or broke
|
|
|
56
78
|
- **No task list, ever.** Build directly — tasks are invisible internal steps, not output.
|
|
57
79
|
- **No questions before the prototype exists.** The only interaction before Step 5 is code being written.
|
|
58
80
|
- **Theme is chosen by the agent, not the user** — pick the best fit from `theme-guide.md` and explain briefly after.
|
|
81
|
+
- **Never reuse starter kit colors.** Always overwrite `app/globals.css` `:root` and `.dark` completely. The default palette in the template is a placeholder — treat it as if it does not exist.
|
|
59
82
|
- **Run the app before showing results.** Never say "done" without confirming it compiles.
|
|
60
83
|
- **One question at a time.** Never give a list of options or ask multiple things at once.
|
|
61
84
|
|
|
@@ -67,6 +90,7 @@ Run through `docs/QA_CHECKLIST.md` silently. Report only what's missing or broke
|
|
|
67
90
|
|---|---|
|
|
68
91
|
| Vision, audience, MVP | `docs/PROJECT.md` |
|
|
69
92
|
| User flow, screens | `docs/HUMAN_FLOW.md` |
|
|
93
|
+
| Visual flow diagram (Mermaid) | `docs/FLOW.md` |
|
|
70
94
|
| Functional spec | `docs/AI_BUILD_SPEC.md` |
|
|
71
95
|
| Stack choices | `docs/tech-stack/STACK_DECISION_MATRIX.md` |
|
|
72
96
|
| UI guidance | invoke `ui-ux-pro-max` skill |
|