ship-create 1.7.0 → 1.7.1

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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ship-create",
3
- "version": "1.7.0",
3
+ "version": "1.7.1",
4
4
  "description": "Scaffold a new project the SHIP Method way — Structure, Human Flow, Instruction, Publish. No git clone, no API key, just one command.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -19,9 +19,30 @@ 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
  Apply the chosen theme 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
 
@@ -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.**
@@ -67,6 +89,7 @@ Run through `docs/QA_CHECKLIST.md` silently. Report only what's missing or broke
67
89
  |---|---|
68
90
  | Vision, audience, MVP | `docs/PROJECT.md` |
69
91
  | User flow, screens | `docs/HUMAN_FLOW.md` |
92
+ | Visual flow diagram (Mermaid) | `docs/FLOW.md` |
70
93
  | Functional spec | `docs/AI_BUILD_SPEC.md` |
71
94
  | Stack choices | `docs/tech-stack/STACK_DECISION_MATRIX.md` |
72
95
  | UI guidance | invoke `ui-ux-pro-max` skill |