@ngocsangairvds/vsaf 3.0.4 → 3.0.6

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.
@@ -22,7 +22,7 @@ Run from the project root. This parses all source files, builds the knowledge gr
22
22
  | `--force` | Force full re-index even if up to date |
23
23
  | `--embeddings` | Enable embedding generation for semantic search (off by default) |
24
24
 
25
- **When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. In Claude Code, a PostToolUse hook runs `analyze` automatically after `git commit` and `git merge`, preserving embeddings if previously generated.
25
+ **When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. Re-run `npx gitnexus analyze` manually after commits/merges when needed.
26
26
 
27
27
  ### status — Check index freshness
28
28
 
@@ -1,44 +1,40 @@
1
1
  ---
2
2
  name: vsaf-build
3
- description: Implement code theo tài liệu spec đã có. Dùng sau /vsaf-doc, khi PRD và spec đã được approve. Tự động đọc memory trước khi code.
3
+ description: Implement code theo tài liệu spec đã có. Dùng sau /vsaf-doc, khi PRD và plan đã được approve. Tự động search MemPalace trước khi code.
4
4
  ---
5
5
 
6
6
  # VSAF Build
7
7
 
8
8
  ## Mục tiêu
9
- Implement code đúng theo spec, từng task một, với TDD — đảm bảo mỗi commit có tests pass.
9
+ Implement code đúng theo plan, từng task một, với TDD — đảm bảo mỗi commit có tests pass.
10
10
 
11
11
  ## Điều kiện tiên quyết
12
- - Đã chạy `/vsaf-doc` và có file spec trong `openspec/`
13
- - User đã approve plan
12
+ - Đã chạy `/vsaf-doc` và có plan được approve
13
+ - User đã xác nhận task list và verification steps
14
14
 
15
15
  ## Các bước thực hiện
16
16
 
17
- ### Bước 1 — Đọc memory tự động trước khi code (bắt buộc)
18
- Thực hiện AUTO-READ từ `.claude/skills/vsaf-memory-protocol.md` với keyword là tên module/feature sắp implement.
17
+ ### Bước 1 — Search MemPalace trước khi code (bắt buộc)
18
+ - Gọi `mcp__mempalace__mempalace_search` với keyword là tên module/feature sắp implement
19
+ - Đảm bảo không có architectural decisions cũ xung đột với approach hiện tại
19
20
 
20
- ### Bước 2 — Đọc spec
21
- - Đọc file spec trong `openspec/` liên quan đến feature hiện tại
21
+ ### Bước 2 — Đọc plan
22
+ - Đọc file plan trong `docs/superpowers/plans/` liên quan đến feature hiện tại
22
23
  - Xác nhận task list và verification steps với user trước khi bắt đầu
23
24
 
24
25
  ### Bước 3 — Implement từng task (TDD)
25
- Với mỗi task trong spec:
26
+ Với mỗi task trong plan:
26
27
  1. **RED**: Viết test trước, chạy test → phải fail
27
28
  2. **GREEN**: Viết code tối thiểu để test pass
28
29
  3. **REFACTOR**: Clean up code, giữ test vẫn pass
29
30
  4. Chạy `mcp__gitnexus__detect_changes` để verify chỉ đúng files thay đổi
30
- 5. Chạy `/opsx:verify` để check task đúng spec
31
- 6. Commit: `git commit -m "feat: <task description>"`
31
+ 5. Commit: `git commit -m "<type>: <task description>"`
32
32
 
33
- ### Bước 4 — Security (tự động)
34
- - Security hooks chạy tự động — không cần gọi thủ công
35
- - Nếu bị block: đọc message, không dùng `--no-verify` để bypass
36
-
37
- ### Bước 5 — Xử lý khi fail
33
+ ### Bước 4 — Xử khi fail
38
34
  - Fail 1-2 lần: thử approach khác
39
35
  - Fail 3 lần cùng 1 task: DỪNG, báo user, quay lại `/vsaf-plan`
40
36
 
41
- ### Bước 6 — Output sau mỗi task
37
+ ### Bước 5 — Output sau mỗi task
42
38
  ```
43
39
  ✓ Task [N]: [tên task]
44
40
  - Files changed: [danh sách]
@@ -6,41 +6,33 @@ description: Viết tài liệu plan cho feature đã được phân tích. Dùn
6
6
  # VSAF Doc
7
7
 
8
8
  ## Mục tiêu
9
- Chuyển kết quả plan thành tài liệu chính thức: PRD, spec proposal, và task list có verification step.
9
+ Chuyển kết quả plan thành tài liệu chính thức: PRD và task list có verification step.
10
10
 
11
11
  ## Điều kiện tiên quyết
12
12
  Phải đã chạy `/vsaf-plan` và có output trước khi chạy skill này.
13
13
 
14
14
  ## Các bước thực hiện
15
15
 
16
- ### Bước 0Đọc memory tự động
17
- Thực hiện AUTO-READ từ `.claude/skills/vsaf-memory-protocol.md` với keyword từ feature hiện tại.
16
+ ### Bước 1Search MemPalace
17
+ - Gọi `mcp__mempalace__mempalace_search` với keyword từ feature hiện tại
18
+ - Kiểm tra có decision cũ nào cần reference không?
18
19
 
19
- ### Bước 1 — Sinh PRD (BMAD pm)
20
+ ### Bước 2 — Sinh PRD (BMAD pm)
20
21
  - Dùng skill `bmad-agent-pm` để tạo PRD từ kết quả plan
21
22
  - PRD phải bao gồm: FRs, NFRs, Epics, User Stories
22
23
  - Lưu vào `docs/` theo cấu trúc project
23
24
 
24
- ### Bước 2Tạo spec proposal (OpenSpec)
25
- - Dùng skill `opsx:propose` với tên feature
26
- - OpenSpec sẽ tạo task list atomic (mỗi task 2-5 phút)
27
- - Mỗi task PHẢI có verification step rõ ràng
28
- - Lưu vào `openspec/`
29
-
30
- ### Bước 3 — Fast-forward docs (OpenSpec)
31
- - Dùng skill `opsx:explore` để sync tất cả docs liên quan
32
- - Đảm bảo không có inconsistency giữa PRD và spec
33
-
34
- ### Bước 4 — Chi tiết hoá task list (Superpowers)
35
- - Dùng skill `superpowers:writing-plans` để review và làm rõ task list
25
+ ### Bước 3Chi tiết hoá task list (Superpowers)
26
+ - Dùng skill `superpowers:writing-plans` để tạo task list chi tiết
36
27
  - Kiểm tra: mỗi task có đủ context để implement không?
37
28
  - Kiểm tra: verification step có đo lường được không?
29
+ - Mỗi task phải atomic (2-5 phút work)
38
30
 
39
- ### Bước 5 — Lưu architecture decision (MemPalace)
31
+ ### Bước 4 — Lưu architecture decision (MemPalace)
40
32
  - Gọi `mcp__mempalace__mempalace_add_drawer` để lưu decision quan trọng
41
33
  - Nội dung: approach được chọn, lý do, alternatives đã bỏ qua
42
34
 
43
- ### Bước 6 — Output cho user
35
+ ### Bước 5 — Output cho user
44
36
  Thông báo các file đã tạo:
45
37
 
46
38
  ```
@@ -49,8 +41,8 @@ Thông báo các file đã tạo:
49
41
  ### PRD
50
42
  - docs/[feature]-prd.md
51
43
 
52
- ### Spec
53
- - openspec/[feature]-spec.md
44
+ ### Plan
45
+ - docs/superpowers/plans/[feature].md
54
46
  - [X] tasks, mỗi task có verification step
55
47
 
56
48
  ### Architecture Decision
@@ -63,4 +55,4 @@ Chạy /vsaf-build để bắt đầu implement
63
55
  ## Lưu ý
64
56
  - Không bắt đầu code trong bước này
65
57
  - Nếu task list quá dài (>10 tasks): đề nghị split thành nhiều PRs
66
- - Commit docs trước khi chuyển sang build: `git commit -m "spec: <feature>"`
58
+ - Commit docs trước khi chuyển sang build: `git commit -m "docs: plan for <feature>"`
@@ -10,26 +10,19 @@ Xây dựng full mental model về dự án trước khi chạm vào bất kỳ
10
10
 
11
11
  ## Các bước thực hiện
12
12
 
13
- ### Bước 0Đọc memory tự động
14
- Thực hiện AUTO-READ từ `.claude/skills/vsaf-memory-protocol.md` với keyword "architecture".
15
-
16
- ### Bước 1 — Kiến trúc tổng thể (Graphify)
17
- - Đọc file `graphify-out/GRAPH_REPORT.md` nếu đã tồn tại
18
- - Nếu chưa có: thông báo user chạy `/graphify .` để build graph trước
19
- - Tóm tắt: các module chính, dependencies, entry points
20
-
21
- ### Bước 2 — Code intelligence (GitNexus)
22
- - Dùng `mcp__gitnexus__context` để lấy codebase overview
13
+ ### Bước 1Code intelligence (GitNexus)
14
+ - Dùng `mcp__gitnexus__query` với query rộng (ví dụ: "main entry point", "core module") để lấy codebase overview
23
15
  - Dùng `mcp__gitnexus__group_list` để xem các functional clusters
16
+ - Nếu cần drill-down symbol cụ thể: dùng `mcp__gitnexus__context` với param `name` là tên symbol đó
24
17
  - Tóm tắt: execution flows quan trọng, symbols có nhiều dependencies nhất
25
18
 
26
- ### Bước 3 — Decisions cũ (MemPalace)
19
+ ### Bước 2 — Decisions cũ (MemPalace)
27
20
  - Gọi `mcp__mempalace__mempalace_search` với query "architecture"
28
21
  - Gọi `mcp__mempalace__mempalace_search` với query "decision"
29
22
  - Gọi `mcp__mempalace__mempalace_search` với query "pattern"
30
23
  - Tóm tắt: các quyết định kiến trúc quan trọng team đã đưa ra
31
24
 
32
- ### Bước 4 — Output cho user
25
+ ### Bước 3 — Output cho user
33
26
  Trình bày tóm tắt theo format:
34
27
 
35
28
  ```
@@ -51,5 +44,5 @@ Trình bày tóm tắt theo format:
51
44
 
52
45
  ## Lưu ý
53
46
  - KHÔNG sửa bất kỳ file nào trong bước này
54
- - Nếu bộ nhớ MemPalace trống: thông báo user chạy `mempalace mine` để populate
47
+ - Nếu bộ nhớ MemPalace trống: thông báo user chạy `vsaf mine` để populate
55
48
  - Sau khi hoàn thành: gợi ý user dùng `/vsaf-plan <feature>` để bắt đầu task
@@ -9,12 +9,14 @@ description: Lên plan cho 1 feature/task mới. Dùng khi nhận được yêu
9
9
  Hiểu đầy đủ yêu cầu, phân tích impact, và xác định chiến lược implement trước khi viết bất kỳ dòng code nào.
10
10
 
11
11
  ## Input
12
- `$ARGUMENTS` — mô tả feature/task cần làm (ví dụ: "tạo module quản lý dashboard")
12
+ `<feature>` — mô tả feature/task cần làm (ví dụ: "tạo module quản lý dashboard")
13
13
 
14
14
  ## Các bước thực hiện
15
15
 
16
- ### Bước 1 — Đọc memory tự động (bắt buộc)
17
- Thực hiện AUTO-READ từ `.claude/skills/vsaf-memory-protocol.md` với keyword từ `$ARGUMENTS`.
16
+ ### Bước 1 — Search MemPalace (bắt buộc)
17
+ - Gọi `mcp__mempalace__mempalace_search` với keyword từ `<feature>`
18
+ - Tìm kiếm: past decisions, architectural patterns, previous attempts
19
+ - Tóm tắt: có decision nào liên quan không?
18
20
 
19
21
  ### Bước 2 — Clarify scope (BMAD analyst)
20
22
  - Dùng skill `bmad-agent-analyst` để phân tích yêu cầu
@@ -25,20 +27,17 @@ Thực hiện AUTO-READ từ `.claude/skills/vsaf-memory-protocol.md` với keyw
25
27
  - Dùng `mcp__gitnexus__impact` với target là module/symbol liên quan
26
28
  - Dùng `mcp__gitnexus__query` để tìm code liên quan
27
29
  - Báo cáo blast radius: bao nhiêu module bị ảnh hưởng, risk level
30
+ - Nếu risk HIGH/CRITICAL: DỪNG, báo user trước khi tiếp tục
28
31
 
29
- ### Bước 4 — Trace dependencies (Graphify)
30
- - Nếu cần trace path giữa 2 services: dùng `/graphify path ServiceA ServiceB`
31
- - Xác định: integration points, shared dependencies
32
-
33
- ### Bước 5 — Architecture decision (BMAD architect)
32
+ ### Bước 4 — Architecture decision (BMAD architect)
34
33
  - Dùng skill `bmad-agent-architect` để đề xuất architecture approach
35
34
  - So sánh alternatives, chọn approach phù hợp nhất
36
35
 
37
- ### Bước 6 — Brainstorm (Superpowers)
36
+ ### Bước 5 — Brainstorm (Superpowers)
38
37
  - Dùng skill `superpowers:brainstorming` để explore alternatives
39
38
  - Đặt câu hỏi Socratic: "What if...", "What could go wrong..."
40
39
 
41
- ### Bước 7 — Output cho user
40
+ ### Bước 6 — Output cho user
42
41
  Trình bày kết quả theo format:
43
42
 
44
43
  ```
@@ -15,54 +15,38 @@ description: Review 3 lớp, ship code, và ghi lại toàn bộ knowledge vào
15
15
  ## Các bước thực hiện
16
16
 
17
17
  ### Bước 1 — Review Layer 1: Methodology (Superpowers)
18
- - Dùng skill `superpowers:requesting-code-review`
18
+ - Dùng skill `superpowers:code-review`
19
19
  - Kiểm tra: code structure, naming, patterns, SOLID principles
20
20
  - Fix issues nếu có, commit lại
21
21
 
22
- ### Bước 2 — Review Layer 2: Spec compliance (OpenSpec)
23
- - Dùng skill `opsx:verify` (hoặc `make verify`)
24
- - Kiểm tra: code có implement đúng tất cả FRs/NFRs trong spec không
25
- - Nếu fail: quay lại `/vsaf-build` để fix
26
-
27
- ### Bước 3 — Review Layer 3: Security (Security)
28
- - Chạy `vsaf verify`
29
- - Fix tất cả issues trước khi tiếp tục
30
- - Không skip warnings
31
-
32
- ### Bước 4 — Re-index knowledge graph
22
+ ### Bước 2 — Review Layer 2: Knowledge graph sync
33
23
  - Chạy `gitnexus analyze` để cập nhật call graph
34
- - Chạy `/graphify . --update` để cập nhật visual graph
35
- - Hoặc: `make index`
36
-
37
- ### Bước 5 — Archive spec
38
- - Dùng skill `opsx:archive` để đóng spec proposal đã hoàn thành
39
- - Lưu vào `openspec/archived/`
24
+ - Hoặc: `vsaf index`
25
+ - Đây layer cuối cùng — đảm bảo index reflect đúng code mới
40
26
 
41
- ### Bước 6 — Ghi nhớ tự động (MemPalace)
42
- Thực hiện AUTO-WRITE từ `.claude/skills/vsaf-memory-protocol.md`.
27
+ ### Bước 3 — Ghi nhớ vào MemPalace
28
+ - Gọi `mcp__mempalace__mempalace_add_drawer` để lưu decisions quan trọng từ feature này
29
+ - Gọi `mcp__mempalace__mempalace_diary_write` để ghi lại session summary
43
30
 
44
- ### Bước 9 — Push PR
31
+ ### Bước 4 — Push PR
45
32
  ```bash
46
33
  git push origin feature/<name>
47
34
  ```
48
35
  PR description phải bao gồm:
49
- - Link OpenSpec proposal
50
36
  - Impact summary (từ GitNexus)
51
37
  - Test results summary
52
38
 
53
- ### Bước 10 — Output cho user
39
+ ### Bước 5 — Output cho user
54
40
  ```
55
41
  ## Ship Complete: [feature]
56
42
 
57
43
  ### Reviews
58
44
  - Layer 1 (Methodology): PASS
59
- - Layer 2 (Spec): PASS
60
- - Layer 3 (Security): PASS
45
+ - Layer 2 (Graph sync): PASS
61
46
 
62
47
  ### Knowledge saved
63
48
  - Diary entry: ✓
64
49
  - Decisions: [X entries]
65
- - Reasoning chain: ✓
66
50
 
67
51
  ### PR
68
52
  - Branch: feature/[name]
@@ -73,4 +57,4 @@ Workflow hoàn tất. Chạy /vsaf-plan <next-feature> cho task tiếp theo.
73
57
 
74
58
  ## Lưu ý
75
59
  - Không ship nếu bất kỳ layer review nào fail
76
- - `mempalace mine ~/chats/` — chạy weekly, không phải mỗi feature
60
+ - `vsaf mine` — chạy weekly, không phải mỗi feature
@@ -10,14 +10,14 @@ Tạo tài liệu test coverage đầy đủ từ spec, sau đó thực thi và
10
10
 
11
11
  ## Điều kiện tiên quyết
12
12
  - Đã chạy `/vsaf-build` và tất cả tasks đã commit
13
- - Có file spec trong `openspec/`
13
+ - Có file PRD trong `docs/` (được tạo bởi `/vsaf-doc`)
14
14
 
15
15
  ## Các bước thực hiện
16
16
 
17
17
  ### Bước 1 — Sinh test cases từ spec (BMAD qa)
18
- - Dùng skill `bmad-qa-generate-e2e-tests` với spec file làm input
18
+ - Dùng skill `bmad-qa-generate-e2e-tests` với PRD file trong `docs/` làm input
19
19
  - Test cases phải cover: happy path, edge cases, error cases, NFRs
20
- - Nguồn gốc: từ FRs/NFRs trong spec — KHÔNG dựa trên implementation
20
+ - Nguồn gốc: từ FRs/NFRs trong PRD — KHÔNG dựa trên implementation
21
21
 
22
22
  ### Bước 2 — Đối chiếu coverage
23
23
  - So sánh test cases với task list trong spec
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # VSAF — SDLC Agentic Framework
2
2
 
3
- A spec-driven development framework for Claude Code. Write specs first, let AI
4
- agents plan and execute, review in 3 layers, track every decision. 8 integrated
5
- tools, $20/month total.
3
+ A development framework for Claude Code built on 4 integrated tools. Plan with
4
+ AI agents, understand impact before coding, execute with TDD guardrails, track
5
+ every decision. $20/month total.
6
6
 
7
7
  ---
8
8
 
@@ -10,13 +10,17 @@ tools, $20/month total.
10
10
 
11
11
  ```
12
12
  ┌──────────────────────────────────────────────────────────────────────┐
13
- │ PLANNING BMAD (agents) ──▶ OpenSpec (specs, tasks, verify)
13
+ │ PLANNING BMAD (agents)
14
+ │ Analyst, PM, Architect, Product Owner │
14
15
  ├──────────────────────────────────────────────────────────────────────┤
15
- │ CODE INTEL GitNexus (MCP backbone) + Graphify (multimodal)
16
+ │ CODE INTEL GitNexus (MCP backbone)
17
+ │ call-graph, impact analysis, blast radius │
16
18
  ├──────────────────────────────────────────────────────────────────────┤
17
- │ MEMORY claude-mem (auto) + MemPalace (knowledge base)
19
+ │ MEMORY MemPalace (knowledge base)
20
+ │ architecture decisions, temporal KG │
18
21
  ├──────────────────────────────────────────────────────────────────────┤
19
- │ IMPLEMENTATION Claude Code + Superpowers + security guardrails
22
+ │ IMPLEMENTATION Claude Code + Superpowers
23
+ │ brainstorm, TDD execution, code review │
20
24
  └──────────────────────────────────────────────────────────────────────┘
21
25
  ```
22
26
 
@@ -24,14 +28,13 @@ See [1-setup-guide.md](docs/onboarding/1-setup-guide.md#2-how-the-tools-fit-toge
24
28
 
25
29
  ## Quickstart
26
30
 
27
- Requires **Node.js ≥ 18**, **Python ≥ 3.10**, **Git**, **jq**, and a
31
+ Requires **Node.js ≥ 18**, **Python ≥ 3.10**, **Git**, and a
28
32
  **Claude Code subscription** ($20/mo). Full prerequisites in
29
33
  [1-setup-guide.md](docs/onboarding/1-setup-guide.md#3-prerequisites).
30
34
 
31
35
  ```bash
32
36
  git clone <this-repo> && cd vsaf
33
37
  npx @ngocsangairvds/vsaf@latest init
34
- npx @ngocsangairvds/vsaf@latest index
35
38
  npx @ngocsangairvds/vsaf@latest status
36
39
  ```
37
40
 
@@ -64,18 +67,18 @@ first 30 days.
64
67
  ```
65
68
  .
66
69
  ├── .claude/
67
- │ ├── settings.json # Local AI settings (optional hook policy)
68
- │ └── skills/ # Coding standards for Go, Rust, Python
70
+ │ ├── settings.json # Local AI settings
71
+ │ └── skills/ # VSAF + BMAD + GitNexus skills
72
+ ├── _bmad/ # BMAD agent workspace
73
+ ├── _bmad-output/ # BMAD generated artifacts (PRDs, arch docs)
69
74
  ├── docs/
70
- │ ├── architecture/ # Architecture documents (from BMAD Architect)
71
- │ └── onboarding/ # Developer onboarding (see table above)
72
- ├── githooks/ # Optional local hooks (disabled by default)
73
- ├── graphify-out/ # Graphify output (gitignored, regenerated by `vsaf index`)
74
- ├── openspec/ # OpenSpec workspace (proposals, specs, designs, tasks)
75
+ │ ├── architecture/ # Architecture documents (from BMAD Architect)
76
+ │ └── onboarding/ # Developer onboarding (see table above)
77
+ ├── assets/templates/ # Project scaffold templates
75
78
  ├── scripts/
76
79
  │ └── setup-vsaf.sh # Full setup automation (used by `vsaf init`)
77
- ├── CLAUDE.md # Claude Code system prompt — workflow rules
78
- └── Makefile # Legacy wrapper (optional; use `vsaf` commands)
80
+ ├── CLAUDE.md # Claude Code system prompt — workflow rules
81
+ └── AGENTS.md # GitNexus rules for AI agents
79
82
  ```
80
83
 
81
84
  ## Daily Operations
@@ -85,19 +88,17 @@ Run `npx @ngocsangairvds/vsaf@latest --help` for the full list. Highlights:
85
88
  | Command | What It Does |
86
89
  |---|---|
87
90
  | `vsaf init` | Install or update all tools |
88
- | `vsaf index` | Re-index codebase (GitNexus + Graphify) — run after every merge |
89
- | `vsaf verify` | Check implementation against OpenSpec specs |
90
- | `vsaf review` | Full 3-layer review coordinator |
91
+ | `vsaf index` | Re-index codebase (GitNexus) — run after every merge |
92
+ | `vsaf review` | 2-layer review coordinator |
91
93
  | `vsaf status` | Show status of all installed tools |
92
-
93
- All commands — including BMAD agents, OpenSpec, Superpowers, and GitNexus — are
94
- listed in [3-cheatsheet.md](docs/onboarding/3-cheatsheet.md).
94
+ | `vsaf mine` | Extract decisions into MemPalace (weekly + after major decisions) |
95
95
 
96
96
  ## Workflow
97
97
 
98
- Every feature follows a **10-step cycle**: scope → plan → spec impact
99
- analysis → brainstorm → TDD execute → 3-layer review → push → archive.
100
- Bug fixes ("Quick Flow") skip planning steps and go straight to brainstorm.
98
+ Every feature follows an **8-step cycle**: scope → plan → impact analysis
99
+ brainstorm → TDD execute → 2-layer review → push.
100
+ Bug fixes ("Quick Flow") skip BMAD planning docs, but still require
101
+ `gitnexus_impact` before editing symbols and `gitnexus_detect_changes` before commit.
101
102
 
102
103
  See [1-setup-guide.md § Your First Project](docs/onboarding/1-setup-guide.md#5-your-first-project--a-walkthrough)
103
104
  for a walkthrough, or [2-workflow-guide.md § JWT Demo](docs/onboarding/2-workflow-guide.md#4-full-sdlc-demo)
@@ -109,16 +110,13 @@ for a full command-by-command example.
109
110
  |---|---|---|
110
111
  | **Claude Code** | AI coding agent — everything else plugs into it | $20/mo |
111
112
  | **BMAD Method** | AI agents for planning: Analyst, PM, Architect, Product Owner | Free |
112
- | **OpenSpec** | Spec-driven development: proposals, specs, designs, task lists, verification | Free |
113
113
  | **Superpowers** | Methodology engine: brainstorm, plan, TDD execution, code review | Free |
114
- | **Security guardrails** | Optional hooks/policies + coding standards (team-defined security scanning) | Free |
115
114
  | **GitNexus** | Code knowledge graph via MCP — impact analysis, dependency queries | Free |
116
- | **Graphify** | Multimodal knowledge graph — visual dependency maps, path tracing | Free |
117
- | **claude-mem** | Auto-pilot memory — captures sessions, re-injects context next time | Free |
118
115
  | **MemPalace** | Knowledge base — verbatim storage of decisions, temporal knowledge graph | Free |
119
116
 
120
117
  ---
121
118
 
122
- **Core principles:** Spec before code. Context is king. Git is source of truth.
123
- 3-layer review before every PR. Re-index after every merge. Mine decisions
124
- weekly. Hooks are optional in the current simplified setup.
119
+ **Core principles:** Plan before code. Impact analysis before touching any symbol.
120
+ Run `gitnexus_detect_changes` before commit. 2-layer review before every PR.
121
+ Re-index after every merge. Mine decisions weekly and after major decisions.
122
+ MemPalace = decisions. Not CLAUDE.md.
@@ -1,37 +1,4 @@
1
1
  {
2
- "hooks": {
3
- "PreToolUse": [
4
- {
5
- "matcher": "Edit|Write|Create|MultiEdit",
6
- "hooks": [
7
- {
8
- "type": "command",
9
- "command": "FILE=\"$TOOL_INPUT_FILE\"; if [ -n \"$FILE\" ]; then if echo \"$FILE\" | grep -qE '\\.env$|\\.env\\.|\\.pem$|\\.key$|id_rsa|id_ed25519|\\.claude/settings\\.json'; then echo 'BLOCK: Protected file. Manual edit required for secrets/config files.'; exit 2; fi; fi"
10
- }
11
- ]
12
- },
13
- {
14
- "matcher": "Edit|Write|Create|Bash",
15
- "hooks": [
16
- {
17
- "type": "command",
18
- "command": "INPUT=\"$TOOL_INPUT\"; if [ -n \"$INPUT\" ]; then if echo \"$INPUT\" | grep -qE 'AKIA[0-9A-Z]{16}|ASIA[0-9A-Z]{16}|ghp_[a-zA-Z0-9]{36}|sk-[a-zA-Z0-9]{48}|xox[bpoas]-[a-zA-Z0-9-]+|eyJ[a-zA-Z0-9_-]*\\.[a-zA-Z0-9_-]*\\.[a-zA-Z0-9_-]*'; then echo 'BLOCK: Hardcoded secret/token detected. Use environment variables.'; exit 2; fi; fi"
19
- }
20
- ]
21
- }
22
- ],
23
- "Stop": [
24
- {
25
- "matcher": "",
26
- "hooks": [
27
- {
28
- "type": "command",
29
- "command": "ISSUES=\"\"; SECRETS=$(git diff --cached --diff-filter=ACM --name-only 2>/dev/null | xargs grep -lE \"AKIA[0-9A-Z]{16}|ghp_[a-zA-Z0-9]{36}|sk-[a-zA-Z0-9]{48}|xox[bpoas]-|BEGIN.*PRIVATE\" 2>/dev/null) || true; [ -n \"$SECRETS\" ] && ISSUES=\"${ISSUES}WARNING: Possible secrets staged: ${SECRETS} \"; LOGS=$(git diff --cached --name-only 2>/dev/null | xargs grep -lE \"console[.]log|debugger\" 2>/dev/null) || true; [ -n \"$LOGS\" ] && ISSUES=\"${ISSUES}WARNING: Debug artifacts in staged files: ${LOGS} \"; [ -n \"$ISSUES\" ] && echo \"$ISSUES\""
30
- }
31
- ]
32
- }
33
- ]
34
- },
35
2
  "permissions": {
36
3
  "allow": [
37
4
  "Read",