@topy-ai/maggie 0.6.2 → 0.6.4

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.
Files changed (3) hide show
  1. package/README.md +37 -2
  2. package/README.zh-TW.md +42 -0
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # @topy-ai/maggie
2
2
 
3
+ **Language:** English · [繁體中文](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/README.zh-TW.md)
4
+
3
5
  [![npm version](https://img.shields.io/npm/v/@topy-ai/maggie)](https://www.npmjs.com/package/@topy-ai/maggie)
4
6
  [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/LICENSE)
5
7
 
@@ -48,6 +50,26 @@ Maggie keeps the existing project foundation and asks for decisions before
48
50
  shared routes, analytics, or publishing boundaries change. The current
49
51
  package ships 18 installable skills and a local-first MaggieDash foundation.
50
52
 
53
+ For a genuinely empty project, create the host framework first, then bootstrap
54
+ Maggie in this order:
55
+
56
+ ```bash
57
+ python3 tools/clis/maggie.py analyze . --json --save
58
+ python3 tools/clis/maggie.py bootstrap interview .
59
+ python3 tools/clis/maggie_dash.py init --project . --confirm
60
+ python3 tools/clis/maggie_dash.py migrate --project . --confirm
61
+ ```
62
+
63
+ The normal daily loop is:
64
+
65
+ ```text
66
+ doctor → memory context → inspect/plan → confirm → implement → test
67
+ → visual/SEO review → deploy staging → canary → publish with approval
68
+ ```
69
+
70
+ Use `maggie memory record-error` for a repaired, reusable pitfall. Feedback is
71
+ redacted and explicit; it is never promoted to active memory automatically.
72
+
51
73
  ## Command surface
52
74
 
53
75
  The CLI provides the installer plus durable workflow commands:
@@ -135,8 +157,8 @@ only and never stores response bodies, cookies, or credentials.
135
157
  Recommended upgrade sequence for the current release:
136
158
 
137
159
  ```bash
138
- npx @topy-ai/maggie@0.6.2 update --project . --force
139
- npx @topy-ai/maggie@0.6.2 cleanup --project .
160
+ npx @topy-ai/maggie@0.6.4 update --project . --force
161
+ npx @topy-ai/maggie@0.6.4 cleanup --project .
140
162
  ```
141
163
 
142
164
  ## MaggieDash lifecycle
@@ -216,6 +238,19 @@ It provides a safe `pending` query and an explicit `mark` command for recording
216
238
  resolved, non-actionable, deferred, or recheck-needed outcomes without
217
239
  rewriting the original report.
218
240
 
241
+ ## Visual workflow guides
242
+
243
+ The repository includes editable Mermaid diagrams for the main user journeys:
244
+
245
+ - [Onboarding journey](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/docs/diagrams/onboarding-journey.mmd)
246
+ - [Daily development loop](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/docs/diagrams/daily-development-loop.mmd)
247
+ - [Feedback data flow](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/docs/diagrams/feedback-dfd.mmd)
248
+ - [Release and deployment flow](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/docs/diagrams/release-deployment-flow.mmd)
249
+ - [Skill map](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/docs/diagrams/skill-map.mmd)
250
+
251
+ They are source-controlled, render directly in GitHub, and can be exported to
252
+ SVG/PNG or an editable Excalidraw scene for presentations and workshops.
253
+
219
254
  ## URL → marketplace template
220
255
 
221
256
  Turn an authorized homepage into a reusable marketplace package with a URL and
package/README.zh-TW.md ADDED
@@ -0,0 +1,42 @@
1
+ # @topy-ai/maggie（繁體中文）
2
+
3
+ [English README](README.md) · [完整繁體中文 README](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/README.zh-TW.md)
4
+
5
+ `@topy-ai/maggie` 提供 18 個可安裝的 AI website workflow skills，支援
6
+ Codex、Claude Code 與相容的 coding agents。
7
+
8
+ ## 安裝
9
+
10
+ ```bash
11
+ npx @topy-ai/maggie@0.6.4 init --agent all
12
+ npx @topy-ai/maggie doctor --project .
13
+ ```
14
+
15
+ 常用流程：
16
+
17
+ ```bash
18
+ python3 tools/clis/maggie.py analyze . --json --save
19
+ python3 tools/clis/maggie.py bootstrap interview .
20
+ maggie memory context --project . --skill <skill-name>
21
+ maggie doctor --project . --require-bootstrap --strict
22
+ ```
23
+
24
+ 主要 skills 包括 clone、design、template、Blog、SEO/GEO、localization、
25
+ deployment、memory、feedback 和 MaggieDash。內容先 draft/review，外部寫入、
26
+ publish 與 production deployment 需要明確確認。
27
+
28
+ 新版 release gates：
29
+
30
+ ```bash
31
+ maggie design icon-inventory --project . --source-dir src \
32
+ --runtime public/assets/icons.css --output docs/icon-inventory.json
33
+
34
+ maggie deployment canary --project . \
35
+ --asset https://example.com/assets/app.js=<sha256> \
36
+ --render-report .maggie/rendered-canary.json \
37
+ --output docs/deployment-canary.json
38
+ ```
39
+
40
+ 完整中文說明、18 個 skills 清單和 roadmap：
41
+ [繁體中文 README](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/README.zh-TW.md)
42
+ · [Roadmap](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/ROADMAP.md)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topy-ai/maggie",
3
- "version": "0.6.2",
3
+ "version": "0.6.4",
4
4
  "description": "Install and manage Maggie Skills for AI coding agents",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -8,6 +8,7 @@
8
8
  "maggie": "bin/maggie.js"
9
9
  },
10
10
  "files": [
11
+ "README.zh-TW.md",
11
12
  "bin",
12
13
  "references",
13
14
  "bundled-skills",