chore(release): 3.8.0-alpha.13 + vá lỗ package.json không được sync

.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "aurafrog",
   "description": "Official Aura Frog marketplace - AI-powered development with specialized agents, structured workflows, and self-improving learning system",
-  "version": "3.8.0-alpha.12",
+  "version": "3.8.0-alpha.13",
   "owner": {
     "name": "Nguyen Thien Thanh",
     "email": "nguyenthienthanh.kiyoshi@gmail.com",
@@ -15,7 +15,7 @@
       "name": "aura-frog",
       "source": "./aura-frog",
       "description": "Planning-first LLM OS for software engineering. Hierarchical planning (T0-T4) survives session reset · forensic reasoning traces · L1+L2 conflict detection · self-healing safety gates · per-agent MCP security · durable project-context snapshots · cross-tool porter (Copilot/Codex/Cursor) · CLI dashboard. 15 agents, 5-phase TDD, 71 rules, 56 skills, 24 commands, 46 hooks, 8 MCP servers. Backward-compatible — /run unchanged.",
-      "version": "3.8.0-alpha.12",
+      "version": "3.8.0-alpha.13",
       "author": {
         "name": "Nguyen Thien Thanh",
         "url": "https://github.com/nguyenthienthanh"

aura-frog/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "aura-frog",
-  "version": "3.8.0-alpha.12",
+  "version": "3.8.0-alpha.13",
   "description": "Planning-first LLM OS for software engineering. Hierarchical planning (T0-T4) survives session reset · forensic reasoning traces · L1+L2 conflict detection · self-healing safety gates · per-agent MCP security · durable project-context snapshots · cross-tool porter (Copilot/Codex/Cursor) · CLI dashboard. 15 agents, 5-phase TDD, 72 rules (3-tier), 43 skills, 24 commands, 51 hooks, 6 MCP servers. ~87% markdown. Backward-compatible with /run.",
   "author": {
     "name": "Nguyen Thien Thanh",

aura-frog/CLAUDE.md

@@ -1,6 +1,6 @@
 # Aura Frog OS — Plugin for Claude Code
 
-**System:** Aura Frog v3.8.0-alpha.12 | **Format:** [TOON](https://github.com/toon-format/toon)
+**System:** Aura Frog v3.8.0-alpha.13 | **Format:** [TOON](https://github.com/toon-format/toon)
 **Purpose:** Planning-first LLM OS. Agents + skills + commands + 5-phase TDD + hierarchical planning (T0-T4) + memory tier + pre-flight + L1/L2 conflicts + freeze cascade + self-healing safety gates + MCP security tier + MCP servers. Component counts: see **Resources** below (single source).
 
 ---
@@ -288,4 +288,4 @@ resources[8]{name,location}:
 
 ---
 
-**Version:** 3.8.0-alpha.12
+**Version:** 3.8.0-alpha.13

aura-frog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aura-frog",
-  "version": "3.8.0-alpha.12",
+  "version": "3.8.0-alpha.13",
   "description": "Planning-first LLM OS for Claude Code. Hierarchical planning (T0-T4) that survives session reset, forensic reasoning traces, conflict detection, self-healing safety gates, and a 5-phase TDD workflow. 15 agents, 72 rules, 59 skills, 24 commands, 50 hooks.",
   "keywords": [
     "claude",

aura-frog/scripts/release.sh

@@ -25,6 +25,7 @@ set -euo pipefail
 # Canonical version locations (edited by `prepare`, historical refs untouched):
 #   - .claude-plugin/plugin.json           "version"
 #   - .claude-plugin/marketplace.json      "version" (x2)   [repo root]
+#   - package.json                         "version"        [npm publish đọc file này]
 #   - CLAUDE.md                            header / 8-Pillars / footer
 #   - docs/**/*.md                         last_aligned_with: frontmatter
 #   - docs/reference/CHANGELOG.md          [Unreleased] -> [version] stamp
@@ -42,6 +43,7 @@ REPO_ROOT="$(cd "$BASE_DIR/.." && pwd)"
 
 PLUGIN_JSON="$BASE_DIR/.claude-plugin/plugin.json"
 MARKETPLACE_JSON="$REPO_ROOT/.claude-plugin/marketplace.json"
+PKG_JSON="$BASE_DIR/package.json"
 CLAUDE_MD="$BASE_DIR/CLAUDE.md"
 CHANGELOG="$REPO_ROOT/docs/reference/CHANGELOG.md"
 
@@ -73,6 +75,10 @@ cmd_prepare() {
   # 1) plugin.json + marketplace.json — the "version" fields only.
   subst "$PLUGIN_JSON"      "s/(\"version\"\s*:\s*\")\Q$OLD\E(\")/\${1}$NEW\${2}/g"
   subst "$MARKETPLACE_JSON" "s/(\"version\"\s*:\s*\")\Q$OLD\E(\")/\${1}$NEW\${2}/g"
+  # package.json — file mà `npm publish` đọc version từ đó. Trước v3.8.0-alpha.13 nó
+  # KHÔNG nằm trong danh sách canonical nào (cả release.sh lẫn sync-version.sh), nên
+  # mỗi lần phát hành phải nhớ sửa tay; quên là npm lệch khỏi plugin.json.
+  subst "$PKG_JSON"         "s/(\"version\"\s*:\s*\")\Q$OLD\E(\")/\${1}$NEW\${2}/g"
 
   # 2) CLAUDE.md — every current-version ref (header, 8-Pillars, footer). No
   #    historical version strings live in this file, so a scoped replace is safe.

docs/reference/CHANGELOG.md

@@ -12,6 +12,58 @@ All notable changes to Aura Frog will be documented in this file.
 
 ## [Unreleased]
 
+## [3.8.0-alpha.13] - 2026-08-25 (tech-writing skill + 4 template viết lại)
+
+### Added
+
+- **`tech-writing` skill** — viết requirements/PRD, tech spec, LLD, decision record
+  và phân tích kỹ thuật ở mức nghi thức khớp với quy mô task. Dựng trên 2 lượt
+  deep-research (214 agent, 49 nguồn sơ cấp). Bốn điểm đáng chú ý:
+  - **Phân tầng T0–T3, mặc định HẠ tầng**: Y-statement → ADR (Nygard) → MADR → RFC.
+    Thứ phân biệt là mức phân tích phương án, không phải độ dài.
+  - **Cấm tự chấm bản nháp trong chính context bản nháp.** Huang et al. (ICLR 2024):
+    GPT-4 GSM8K 95.5 → 91.5 → 89.0 và GPT-3.5 CommonSenseQA 75.8 → 38.1 sau khi tự
+    sửa; cải thiện trong nghiên cứu trước đến từ oracle label và biến mất khi bỏ nó.
+    Skill dùng chain-of-verification trả lời câu hỏi kiểm chứng ở context RIÊNG, và
+    ưu tiên verifier NGOÀI (chạy test, gọi API) hơn suy nghĩ nội tại.
+  - **Grounding trước khi viết**: trích nguyên văn → mọi claim về code phải có
+    `file_read` trước đó (`rules/core/grounding-discipline.md`) → claim không chống
+    lưng được thì XOÁ và đánh dấu lỗ hổng.
+  - **Nhãn mức bằng chứng** `[CODE]` / `[SOURCE]` / `[CONVENTION]` / `[UNVERIFIED]`,
+    và ghi rõ gần như toàn bộ nội dung là quy ước có nguồn, không phải hiệu quả đo được.
+- **`templates/decision-record.md`** — thang 4 bậc trong một file, kèm vòng đời trạng
+  thái của Oxide RFD (cố tình không có `draft`).
+
+### Changed
+
+- **Bốn template phase-1 viết lại.** Chúng vốn là khung rỗng: `lld.md` dán cứng ví dụ
+  `ShareModal.tsx`/Zustand của một dự án khác, `requirements.md` có NFR bịa số
+  (`< 200ms`, `1000 concurrent users`), `confluence-page.md` liệt kê
+  `FacebookCard`/`InstagramCard`.
+  - `lld.md` — nói THẲNG là không có chuẩn cho LLD (IEEE 1016-2009 để ranh giới
+    architecture/HLD/LLD ngoài phạm vi). Dùng 12 design viewpoint làm THỰC ĐƠN, cộng
+    tiêu chí dừng của ECSS: chi tiết tới mức đơn vị code/compile/test được, không hơn.
+    Idempotency/observability/migration đánh dấu `[UNVERIFIED]` — không chuẩn nào
+    chống lưng.
+  - `requirements.md` — bộ ba C/R/A của INCOSE GtWR v4: C1–C9 cá thể, C10–C15 tập hợp,
+    tập con ~10–12 rule lint được, A-attributes làm schema truy vết. Ghi rõ INCOSE §1.8
+    nói công cụ NLP/AI không phủ hết rule.
+  - `confluence-page.md` — bỏ ví dụ dán cứng, thêm mục Non-goals / Nhược điểm / Chế độ hỏng.
+- **`DESIGN_DECISIONS.md` sửa ánh xạ sai** — trước đây trỏ vào `lld.md` (LLD không phải
+  chỗ ghi quyết định), giờ trỏ `decision-record.md`; thêm `LLD.md` thành file riêng.
+  `rules/workflow/workflow-deliverables.md` 12 → 14 deliverables.
+- **`documentation` skill** thu hẹp về Runbook; ADR chuyển sang `tech-writing`.
+
+### Fixed
+
+- **`package.json` không được sync version.** File mà `npm publish` đọc version từ đó
+  KHÔNG nằm trong danh sách canonical của `release.sh` lẫn `sync-version.sh`, nên mỗi
+  lần phát hành phải nhớ sửa tay — quên là npm lệch khỏi `plugin.json`. Đã thêm vào
+  `release.sh prepare`.
+- **Link chết `skills/git-worktree/SKILL.md` trong README** — skill bị xoá có chủ ý ở
+  `03ddfe33` (consolidate 59→42) nhưng link bị bỏ lại, làm job "Check for broken
+  markdown links" đỏ trên chính `main`. Trỏ lại sang `skills/git`.
+
 ## [3.8.0-alpha.12] - 2026-08-20 (Audit follow-ups: skill consolidation, KG-2, custom statusline)
 
 Completes the two follow-up tracks the audit (PR #50) deliberately deferred as