diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 92abc29..f84d9ae 100644 --- a/.claude-plugin/marketplace.json +++ b/.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" diff --git a/aura-frog/.claude-plugin/plugin.json b/aura-frog/.claude-plugin/plugin.json index 7c723e3..645999c 100644 --- a/aura-frog/.claude-plugin/plugin.json +++ b/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", diff --git a/aura-frog/CLAUDE.md b/aura-frog/CLAUDE.md index 0dced73..658a383 100644 --- a/aura-frog/CLAUDE.md +++ b/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 diff --git a/aura-frog/package.json b/aura-frog/package.json index 0d8a07d..0f3bc75 100644 --- a/aura-frog/package.json +++ b/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", diff --git a/aura-frog/scripts/release.sh b/aura-frog/scripts/release.sh index 4d1a286..6f4a089 100755 --- a/aura-frog/scripts/release.sh +++ b/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. diff --git a/docs/reference/CHANGELOG.md b/docs/reference/CHANGELOG.md index 7fa5897..3af91b1 100644 --- a/docs/reference/CHANGELOG.md +++ b/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