@ngocsangairvds/vsaf 3.0.9 → 3.0.10

package/README.md

@@ -11,7 +11,7 @@ every decision. $20/month total.
 ```
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PLANNING          BMAD (agents)                                     │
-│                    Analyst, PM, Architect, Product Owner             │
+│                    Analyst · Architect · Brainstorming · QA          │
 ├──────────────────────────────────────────────────────────────────────┤
 │  CODE INTEL        GitNexus (MCP backbone)                           │
 │                    call-graph, impact analysis, blast radius         │
@@ -20,7 +20,7 @@ every decision. $20/month total.
 │                    architecture decisions, temporal KG               │
 ├──────────────────────────────────────────────────────────────────────┤
 │  IMPLEMENTATION    Claude Code + Superpowers                         │
-│                    brainstorm, TDD execution, code review            │
+│                    TDD execution, code review                        │
 └──────────────────────────────────────────────────────────────────────┘
 ```
 
@@ -96,7 +96,8 @@ Run `npx @ngocsangairvds/vsaf@latest --help` for the full list. Highlights:
 Main skill commands inside Claude Code:
 
 - `/vsaf-onboard`
-- `/vsaf-plan` + `/vsaf-doc`
+- `/vsaf-plan <feature>`
+- `/vsaf-doc`
 - `/vsaf-test <path/to/srs>`
 - `/vsaf-build <path/to/srs> <path/to/testcases>`
 - `/vsaf-ship`
@@ -105,29 +106,84 @@ Main skill commands inside Claude Code:
 
 Every feature follows an **SRS-first cycle**:
 
-1. `/vsaf-onboard` — understand project context (code graph + decisions)
-2. `/vsaf-plan` + `/vsaf-doc` — turn requirement into approved SRS
-3. `/vsaf-test <path/to/srs>` — generate testcase docs from SRS
-4. `gitnexus_impact` + `mempalace_search` — mandatory impact/rationale gate
-5. `/vsaf-build <path/to/srs> <path/to/testcases>` — implement with TDD guardrails
-6. `/superpowers:code-review` + `vsaf index` + `/vsaf-ship` — review, sync graph, ship
+```
+/vsaf-onboard → /vsaf-plan → /vsaf-doc → /vsaf-test → /vsaf-build → /vsaf-ship
+```
 
 Bug fixes (Quick Flow) may use mini-SRS + mini-testcases, but still require
 `gitnexus_impact` before editing symbols and `gitnexus_detect_changes` before commit.
 
-Generated docs path convention:
-
-- SRS: `docs/project/srs/<feature>.md`
-- Testcases: `docs/project/testcases/<feature>.md`
-- Planning artifacts: `docs/project/planning-artifacts/`
-- Implementation artifacts: `docs/project/implementation-artifacts/`
+### Flow breakdown
+
+#### `/vsaf-onboard` — Understand the codebase
+| Step | Tool | Does |
+|------|------|------|
+| 1 | **GitNexus** `mcp__gitnexus__query` + `group_list` | Maps modules, clusters, entry points, hot symbols |
+| 2 | **MemPalace** `mempalace_search` × 3 | Surfaces past architecture decisions, patterns, rationale |
+| → | Output | Project overview: architecture, patterns, key decisions, risk areas |
+
+#### `/vsaf-plan <feature>` — Analyse and plan
+| Step | Tool | Does |
+|------|------|------|
+| 1 | **MemPalace** `mempalace_search` | Checks for prior decisions that affect this feature |
+| 2 | **BMAD** `bmad-agent-analyst` (Mary) | Elicits FRs, NFRs, edge cases, scope boundaries |
+| 3 | **GitNexus** `mcp__gitnexus__impact` + `query` | Blast radius — how many modules touched, risk level |
+| 4 | **Graphify** `/graphify path A B` *(if needed)* | Traces dependency path between two services |
+| 5 | **BMAD** `bmad-agent-architect` (Winston) | Proposes architecture approach, compares alternatives |
+| 6 | **BMAD** `bmad-brainstorming` | Creative exploration — min. 20 alternatives / risk angles |
+| → | Output | Scope, impact report, chosen approach, rejected alternatives |
+
+#### `/vsaf-doc` — Write the SRS
+| Step | Tool | Does |
+|------|------|------|
+| 1 | **MemPalace** `mempalace_search` | Checks for old decisions to reference in SRS |
+| 2 | *(Claude)* | Writes SRS with FRs/NFRs/acceptance criteria + traceability IDs → `docs/project/srs/` |
+| 3 | *(Claude)* | Writes implement notes: affected modules, technical constraints |
+| 4 | **MemPalace** `mempalace_add_drawer` | Persists chosen approach + rejected alternatives |
+| → | Output | `docs/project/srs/[feature].md` ready for testcase generation |
+
+#### `/vsaf-test <path/to/srs>` — Generate testcases
+| Step | Tool | Does |
+|------|------|------|
+| 1 | **BMAD** `bmad-qa-generate-e2e-tests` | Derives unit / integration / edge-case tests from SRS FRs/NFRs |
+| 2 | *(Claude)* | Validates every FR/NFR has ≥ 1 test, records gaps |
+| 3 | *(Claude)* | Builds FR/NFR → Testcase ID traceability matrix |
+| 4 | *(Claude)* | Saves to `docs/project/testcases/[feature].md` |
+| → | Output | Testcase contract — used as implementation guardrails |
+
+#### `/vsaf-build <path/to/srs> <path/to/testcases>` — Implement with TDD
+| Step | Tool | Does |
+|------|------|------|
+| 1 | **MemPalace** `mempalace_search` | Last check — no old decisions conflict with implementation |
+| 2 | *(Claude)* | Reads SRS + testcases, confirms FR/NFR → testcase mapping |
+| 3 | **Claude Code** (TDD loop) | RED → GREEN → REFACTOR per testcase group |
+| 3b | **GitNexus** `mcp__gitnexus__detect_changes` | Verifies only intended files changed before each commit |
+| → | Output | Working code, all tests passing, 1 commit per task |
+
+#### `/vsaf-ship` — Review, sync, and record
+| Step | Tool | Does |
+|------|------|------|
+| 1 | **Superpowers** `superpowers:code-review` | Layer 1 — structure, naming, SOLID, patterns |
+| 2 | **GitNexus** `gitnexus analyze` / `vsaf index` | Layer 2 — updates call graph to reflect new code |
+| 3 | **MemPalace** `mempalace_add_drawer` + `diary_write` | Saves decisions + session summary for future sessions |
+| 4 | *(git)* | Push branch, open PR with impact summary + test results |
+| → | Output | Shipped feature, updated graph, persistent knowledge |
+
+### Generated docs path convention
+
+| Artifact | Path |
+|----------|------|
+| SRS | `docs/project/srs/<feature>.md` |
+| Testcases | `docs/project/testcases/<feature>.md` |
+| Planning artifacts | `docs/project/planning-artifacts/` |
+| Implementation artifacts | `docs/project/implementation-artifacts/` |
 
 ### Command naming map
 
-- `/vsaf-onboarding` -> `vsaf-onboard`
-- `/vsaf-planning + requirement` -> `vsaf-plan` + `vsaf-doc`
-- `/vsaf-testcase + path/to/srs` -> `vsaf-test <path/to/srs>`
-- `/vsaf-implement + path/to/srs + path/to/test_case` -> `vsaf-build <srs> <testcases>`
+- `/vsaf-onboarding` → `vsaf-onboard`
+- `/vsaf-planning <requirement>` → `vsaf-plan` + `vsaf-doc`
+- `/vsaf-testcase <path/to/srs>` → `vsaf-test <path/to/srs>`
+- `/vsaf-implement <srs> <testcases>` → `vsaf-build <srs> <testcases>`
 
 See [1-setup-guide.md § Your First Project](docs/onboarding/1-setup-guide.md#5-your-first-project--a-walkthrough)
 for a walkthrough, or [2-workflow-guide.md § JWT Demo](docs/onboarding/2-workflow-guide.md#4-full-sdlc-demo)
@@ -138,8 +194,8 @@ for a full command-by-command example.
 | Tool | What It Does | Cost |
 |---|---|---|
 | **Claude Code** | AI coding agent — everything else plugs into it | $20/mo |
-| **BMAD Method** | AI agents for planning: Analyst, PM, Architect, Product Owner | Free |
-| **Superpowers** | Methodology engine: brainstorm, plan, TDD execution, code review | Free |
+| **BMAD Method** | AI agents for planning: Analyst, Architect, Brainstorming, QA | Free |
+| **Superpowers** | Methodology engine: code review | Free |
 | **GitNexus** | Code knowledge graph via MCP — impact analysis, dependency queries | Free |
 | **MemPalace** | Knowledge base — verbatim storage of decisions, temporal knowledge graph | Free |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngocsangairvds/vsaf",
-  "version": "3.0.9",
+  "version": "3.0.10",
   "description": "VSAF — Agentic AI SDLC Framework. 4 integrated tools: BMAD, GitNexus, Superpowers, MemPalace. 2-layer review.",
   "keywords": ["claude", "claude-code", "ai", "sdlc", "framework", "bmad", "gitnexus", "mempalace"],
   "bin": {