@leejungkiin/awkit 1.0.0

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 (139) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +146 -0
  3. package/VERSION +1 -0
  4. package/bin/awf.js +549 -0
  5. package/bin/awk.js +1759 -0
  6. package/core/AGENTS.md +39 -0
  7. package/core/GEMINI.md +202 -0
  8. package/core/GEMINI.md.bak +244 -0
  9. package/core/orchestrator.md +58 -0
  10. package/package.json +46 -0
  11. package/schemas/brain.schema.json +342 -0
  12. package/schemas/preferences.schema.json +95 -0
  13. package/schemas/session.schema.json +112 -0
  14. package/skill-packs/neural-memory/README.md +111 -0
  15. package/skill-packs/neural-memory/pack.json +35 -0
  16. package/skill-packs/neural-memory/schemas/brain-snapshot.json +167 -0
  17. package/skill-packs/neural-memory/skills/nm-memory-audit/SKILL.md +157 -0
  18. package/skill-packs/neural-memory/skills/nm-memory-evolution/SKILL.md +202 -0
  19. package/skill-packs/neural-memory/skills/nm-memory-intake/SKILL.md +135 -0
  20. package/skill-packs/neural-memory/skills/nm-memory-sync/SKILL.md +184 -0
  21. package/skill-packs/neural-memory/workflows/nm-import.md +73 -0
  22. package/skill-packs/neural-memory/workflows/nm-recall.md +67 -0
  23. package/skill-packs/neural-memory/workflows/nm-snapshot.md +69 -0
  24. package/skills/adaptive-language/SKILL.md +189 -0
  25. package/skills/ambient-brain/SKILL.md +314 -0
  26. package/skills/ambient-brain/brain-router.md +185 -0
  27. package/skills/ambient-brain/brain-templates.md +201 -0
  28. package/skills/auto-save/SKILL.md +223 -0
  29. package/skills/awf-adaptive-language/SKILL.md +189 -0
  30. package/skills/awf-context-help/SKILL.md +180 -0
  31. package/skills/awf-error-translator/SKILL.md +153 -0
  32. package/skills/awf-session-restore/SKILL.md +270 -0
  33. package/skills/awf-version-tracker/SKILL.md +32 -0
  34. package/skills/awf-version-tracker/scripts/snapshot.sh +22 -0
  35. package/skills/beads-manager/SKILL.md +323 -0
  36. package/skills/brainstorm-agent/SKILL.md +295 -0
  37. package/skills/context-help/SKILL.md +180 -0
  38. package/skills/error-translator/SKILL.md +153 -0
  39. package/skills/ios-engineer/SKILL.md +101 -0
  40. package/skills/memory-sync/SKILL.md +378 -0
  41. package/skills/memory-sync/memory-router.md +185 -0
  42. package/skills/memory-sync/memory-templates.md +201 -0
  43. package/skills/orchestrator/SKILL.md +193 -0
  44. package/skills/session-restore/SKILL.md +240 -0
  45. package/templates/CODEBASE.md +80 -0
  46. package/templates/brain.example.json +321 -0
  47. package/templates/preferences.example.json +21 -0
  48. package/templates/project-identity/android.json +28 -0
  49. package/templates/project-identity/backend-nestjs.json +24 -0
  50. package/templates/project-identity/expo.json +27 -0
  51. package/templates/project-identity/ios.json +27 -0
  52. package/templates/project-identity/web-nextjs.json +24 -0
  53. package/templates/session.example.json +53 -0
  54. package/templates/specs/design-template.md +166 -0
  55. package/templates/specs/requirements-template.md +65 -0
  56. package/templates/specs/tasks-template.md +132 -0
  57. package/templates/structures/android.txt +10 -0
  58. package/templates/structures/backend-nestjs.txt +6 -0
  59. package/templates/structures/expo.txt +9 -0
  60. package/templates/structures/ios.txt +9 -0
  61. package/templates/structures/web-nextjs.txt +6 -0
  62. package/templates/workflow_dual_mode_template.md +87 -0
  63. package/workflows/_uncategorized/README.md +339 -0
  64. package/workflows/_uncategorized/ads-creative.md +357 -0
  65. package/workflows/_uncategorized/ads-full-optimization.md +308 -0
  66. package/workflows/_uncategorized/ads-plan.md +247 -0
  67. package/workflows/_uncategorized/ads-user-analysis.md +337 -0
  68. package/workflows/_uncategorized/skill-health.md +35 -0
  69. package/workflows/_uncategorized/skill-rollback.md +35 -0
  70. package/workflows/ads/admob.md +62 -0
  71. package/workflows/ads/ads-analyst.md +201 -0
  72. package/workflows/ads/ads-audit.md +106 -0
  73. package/workflows/ads/ads-optimize.md +97 -0
  74. package/workflows/ads/ads-targeting.md +241 -0
  75. package/workflows/ads/adsExpert.md +160 -0
  76. package/workflows/ads/smali-ads-config.md +400 -0
  77. package/workflows/ads/smali-ads-flow.md +331 -0
  78. package/workflows/ads/smali-ads-interstitial.md +377 -0
  79. package/workflows/ads/smali-ads-native.md +382 -0
  80. package/workflows/context/auto-execution-workflow.md +291 -0
  81. package/workflows/context/auto-implement.md +211 -0
  82. package/workflows/context/codebase-sync.md +163 -0
  83. package/workflows/context/logic-reasoning-workflow.md +260 -0
  84. package/workflows/context/next.md +195 -0
  85. package/workflows/context/recap.md +212 -0
  86. package/workflows/context/save-brain.md +285 -0
  87. package/workflows/context/user-intent-analysis-workflow.md +206 -0
  88. package/workflows/expert/codeExpert.md +126 -0
  89. package/workflows/expert/debugExpert.md +136 -0
  90. package/workflows/expert/planExpert.md +112 -0
  91. package/workflows/git/cloudflare-tunnel.md +135 -0
  92. package/workflows/git/git-commit-workflow.md +75 -0
  93. package/workflows/git/hotfix.md +357 -0
  94. package/workflows/git/release-notes.md +160 -0
  95. package/workflows/git/rollback.md +52 -0
  96. package/workflows/git/smart-git-ops.md +103 -0
  97. package/workflows/lifecycle/brainstorm.md +377 -0
  98. package/workflows/lifecycle/code.md +663 -0
  99. package/workflows/lifecycle/debug.md +116 -0
  100. package/workflows/lifecycle/deploy.md +95 -0
  101. package/workflows/lifecycle/init.md +152 -0
  102. package/workflows/lifecycle/master-code-workflow.md +300 -0
  103. package/workflows/lifecycle/migration.md +196 -0
  104. package/workflows/lifecycle/plan.md +91 -0
  105. package/workflows/lifecycle/refactor.md +165 -0
  106. package/workflows/lifecycle/run.md +52 -0
  107. package/workflows/lifecycle/test.md +91 -0
  108. package/workflows/meta/customize.md +346 -0
  109. package/workflows/meta/file-protection-rules.md +129 -0
  110. package/workflows/meta/help.html +350 -0
  111. package/workflows/meta/project-identity-enforcement.md +180 -0
  112. package/workflows/mobile/app-analysis.md +64 -0
  113. package/workflows/mobile/maestro-qa-workflow.md +470 -0
  114. package/workflows/mobile/maestro-test-workflow.md +84 -0
  115. package/workflows/mobile/structure-clean-architect.md +271 -0
  116. package/workflows/mobile/turbo-mobile-build.md +190 -0
  117. package/workflows/quality/accessibility-audit.md +311 -0
  118. package/workflows/quality/audit.md +217 -0
  119. package/workflows/quality/bug-hunter.md +243 -0
  120. package/workflows/quality/code-janitor.md +209 -0
  121. package/workflows/quality/code-quality-rules.md +132 -0
  122. package/workflows/quality/performance-audit.md +343 -0
  123. package/workflows/quality/project-audit.md +61 -0
  124. package/workflows/quality/self-healing-test.md +192 -0
  125. package/workflows/quality/ui-review.md +130 -0
  126. package/workflows/quality/ux-audit.md +213 -0
  127. package/workflows/quality/visual-debug.md +34 -0
  128. package/workflows/roles/oracle.md +267 -0
  129. package/workflows/roles/product-manager-workflow.md +52 -0
  130. package/workflows/roles/qa-engineer-workflow.md +41 -0
  131. package/workflows/roles/tech-lead-workflow.md +45 -0
  132. package/workflows/roles/ui-ux-designer-workflow.md +42 -0
  133. package/workflows/roles/vibe-coding-master-workflow.md +52 -0
  134. package/workflows/ui/app-screen-analyzer.md +152 -0
  135. package/workflows/ui/create-feature.md +332 -0
  136. package/workflows/ui/create-spec-architect.md +184 -0
  137. package/workflows/ui/design-to-ui.md +308 -0
  138. package/workflows/ui/ui-first-methodology.md +279 -0
  139. package/workflows/ui/visualize.md +298 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,27 @@
1
+ # Changelog
2
+
3
+ All notable changes to AWF will be documented here.
4
+
5
+ ## [6.0.0] - 2026-02-22
6
+
7
+ ### Added
8
+ - 🏗️ Unified architecture merging AWF v4 and Antigravity v5
9
+ - 📦 npm package distribution with CLI (`awf` command)
10
+ - 📂 Categorized workflow organization (lifecycle, context, quality, ui, ads, git, expert)
11
+ - 🔌 Skill Packs system (opt-in domain-specific knowledge)
12
+ - 🏥 `awf doctor` health check command
13
+ - 🔄 Smart sync — flattens categories on install, never overwrites custom files
14
+ - 🗃️ Backup system — disabling packs moves to backup, not delete
15
+
16
+ ### Changed
17
+ - Merged GEMINI.md rules (best of v4 detail + v5 Beads/MCP)
18
+ - Reduced core skills from 282 to 7 curated essentials
19
+ - Standardized workflow format with frontmatter + phases
20
+
21
+ ### Removed
22
+ - curl/wget install scripts (replaced by npm)
23
+ - Persona system (Tuấn/Hà/Mai/Long) — simplified to single assistant
24
+ - Duplicate workflow files (save-brain.md vs save_brain.md unified)
25
+
26
+ ### Migration
27
+ - See `docs/migration-v5-to-v6.md`
package/README.md ADDED
@@ -0,0 +1,146 @@
1
+ # AWKit — Antigravity Workflow Kit v1.0
2
+
3
+ > **v1.0.0** · Single Source of Truth · Beads-First · Ambient Memory
4
+
5
+ AWKit là framework điều phối AI agent chuyên nghiệp. Đây là **nơi duy nhất** chứa toàn bộ workflows, skills, GEMINI.md và cấu hình — không còn phân tán giữa nhiều repo.
6
+
7
+ ---
8
+
9
+ ## 🚀 Quick Start
10
+
11
+ ### Cách 1 — Cài qua GitHub (khuyên dùng, không cần npm account)
12
+ ```bash
13
+ npm install -g github:babyskill/awk
14
+ awkit install
15
+ awkit doctor
16
+ ```
17
+
18
+ ### Cách 2 — Clone & install thủ công
19
+ ```bash
20
+ git clone https://github.com/babyskill/awk.git ~/Dev/NodeJS/main-awf
21
+ cd ~/Dev/NodeJS/main-awf
22
+ node bin/awk.js install
23
+
24
+ # Verify
25
+ node bin/awk.js doctor
26
+ ```
27
+
28
+
29
+ ## 📦 Commands
30
+
31
+ | Command | Description |
32
+ |---------|-------------|
33
+ | `awkit install` | Deploy AWKit vào `~/.gemini/antigravity/` |
34
+ | `awkit update` | Update lên version mới nhất |
35
+ | `awkit sync` | Full sync: harvest + install (one shot) |
36
+ | `awkit status` | So sánh repo vs installed (diff view) |
37
+ | `awkit harvest` | Pull từ `~/.gemini/antigravity/` về repo |
38
+ | `awkit doctor` | Kiểm tra sức khoẻ installation |
39
+ | `awkit enable-pack <name>` | Kích hoạt skill pack |
40
+ | `awkit disable-pack <name>` | Vô hiệu skill pack |
41
+ | `awkit list-packs` | Xem danh sách skill packs |
42
+ | `awkit version` | Show version |
43
+
44
+ ### Typical Workflow
45
+
46
+ ```bash
47
+ # 1. Check what's out of sync
48
+ awkit status
49
+
50
+ # 2a. You edited in ~/.gemini/ → pull back to repo
51
+ awkit harvest
52
+
53
+ # 2b. You edited in repo → deploy to ~/.gemini/
54
+ awkit install
55
+
56
+ # 2c. Both directions (full round-trip)
57
+ awkit sync
58
+
59
+ # 3. Commit the snapshot
60
+ git add -A && git commit -m "chore: sync AWKit v7.0"
61
+ ```
62
+
63
+
64
+
65
+ ```
66
+ main-awf/ (AWKit v7.0 — Source of Truth)
67
+ ├── bin/
68
+ │ ├── awk.js ← CLI entry point
69
+ │ └── awf.js ← (legacy, kept for reference)
70
+ ├── core/
71
+ │ ├── GEMINI.md ← Master AI config (v6.4+)
72
+ │ ├── AGENTS.md ← Agent rules
73
+ │ └── orchestrator.md ← Orchestrator skill
74
+ ├── workflows/ ← 75+ workflows, categorized
75
+ │ ├── lifecycle/ plan, code, debug, deploy...
76
+ │ ├── context/ recap, next, save-brain...
77
+ │ ├── quality/ audit, performance, ux...
78
+ │ ├── ui/ visualize, design-to-ui...
79
+ │ ├── ads/ ads-audit, optimize...
80
+ │ ├── mobile/ maestro, turbo-build...
81
+ │ ├── expert/ planExpert, codeExpert...
82
+ │ ├── git/ commit, hotfix, rollback...
83
+ │ ├── roles/ tech-lead, pm, qa...
84
+ │ ├── meta/ customize, file-protection...
85
+ │ └── _uncategorized/ misc files
86
+ ├── skills/ ← 10+ skills (auto-activate)
87
+ │ ├── orchestrator/
88
+ │ ├── memory-sync/
89
+ │ ├── brainstorm-agent/
90
+ │ ├── beads-manager/
91
+ │ ├── awf-session-restore/
92
+ │ └── ...
93
+ ├── skill-packs/ ← Optional add-ons
94
+ │ └── neural-memory/ (Phase 3 - coming soon)
95
+ ├── schemas/ ← JSON schemas
96
+ ├── templates/ ← Project templates
97
+ ├── scripts/
98
+ │ └── harvest.js ← Migration: pull from ~/.gemini/
99
+ ├── VERSION → 1.0.0
100
+ └── package.json (@leejungkiin/awkit)
101
+ ```
102
+
103
+ ## 🌾 Harvest (Migration)
104
+
105
+ Nếu bạn chỉnh sửa trực tiếp trong `~/.gemini/antigravity/` và muốn sync về repo:
106
+
107
+ ```bash
108
+ # Xem trước (không thay đổi file)
109
+ node scripts/harvest.js --dry-run
110
+
111
+ # Thực thi harvest
112
+ node scripts/harvest.js
113
+ ```
114
+
115
+ ## 🔄 Workflow
116
+
117
+ ```
118
+ main-awf/ (edit here)
119
+
120
+ ▼ awkit install
121
+ ~/.gemini/antigravity/ (runtime)
122
+
123
+ ▼ AI reads from here
124
+ Gemini / Claude / Any AI
125
+ ```
126
+
127
+ ## 📦 Skill Packs
128
+
129
+ ```bash
130
+ awkit list-packs
131
+ awkit enable-pack neural-memory
132
+ awkit enable-pack ios-dev
133
+ ```
134
+
135
+ ## 🏗️ Versioning
136
+
137
+ | Version | Name | Notes |
138
+ |---------|------|-------|
139
+ | 4.x | AWF v4 | Shell-based, `awf-` prefix skills |
140
+ | 5.x | Antigravity v5 | Node.js, Beads integration |
141
+ | 6.x | AWF v6 | main-awf, multiple sources |
142
+ | **1.0** | **AWKit v1.0** | **Single source of truth, this repo** |
143
+
144
+ ---
145
+
146
+ *AWKit v1.0 — Antigravity Workflow Kit · Created by Kien AI*
package/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.0.0