@longph2102/v-flow 1.5.0

package/skills/check/cross-validator/config.json

@@ -0,0 +1,33 @@
+{
+  "setup_questions": [
+    {
+      "id": "strictness",
+      "question": "Mức độ strict của validation?",
+      "options": ["strict", "standard", "lenient"],
+      "default": "standard",
+      "description": "strict = mọi warning → concern. standard = balanced. lenient = chỉ critical gaps → fail."
+    },
+    {
+      "id": "concern_threshold",
+      "question": "Max concerns trước khi đổi verdict sang FAIL?",
+      "type": "number",
+      "default": 5,
+      "description": "Nếu > N concerns → FAIL thay vì PASS WITH CONCERNS."
+    },
+    {
+      "id": "require_security_section",
+      "question": "Bắt buộc plan có security section?",
+      "type": "boolean",
+      "default": true
+    }
+  ],
+  "hooks": {
+    "pre_check": "Build traceability matrix từ spec + plan + tasks + test-cases",
+    "post_check": "Write validation-report.md + update .flow-state.yaml + append _session.md"
+  },
+  "memory": {
+    "file": "check-history.log",
+    "format": "[date] | [feature] | [verdict] | [critical] | [major] | [concerns] | [coverage_pct]",
+    "purpose": "Track validation quality — dùng cho /v.metrics"
+  }
+}

package/skills/check/cross-validator/examples/good/validation-report-pass-with-concerns.md

@@ -0,0 +1,105 @@
+# Ví dụ — Validation Report (PASS WITH CONCERNS)
+
+> Đây là mẫu output chuẩn cho Master Check Agent.
+
+---
+
+# Validation Report — Feature 001: User Login
+
+**Ngày:** 2026-04-15
+**Verdict:** ⚠️ PASS WITH CONCERNS
+
+---
+
+## 1. Traceability Matrix
+
+| REQ | Task(s) | TC(s) | Status |
+|-----|---------|-------|--------|
+| REQ-E01 | T-001, T-002, T-004, T-005 | TC-E01-01, TC-E01-02 | ✅ Full |
+| REQ-E02 | T-004 | TC-E02-01 | ✅ Full |
+| REQ-U01 | T-001 | TC-U01-01, TC-U01-02 | ✅ Full |
+| REQ-O01 | T-004 | TC-O01-01, TC-O01-02, TC-O01-03 | ✅ Full |
+
+**Coverage**: 4/4 REQs (100%) ✅
+
+---
+
+## 2. Consistency Checks
+
+| Check | Result | Detail |
+|-------|--------|--------|
+| Architecture vs Constitution | ✅ PASS | Clean Architecture, BLoC pattern — match constitution §3.2 |
+| File paths | ✅ PASS | All paths follow `lib/features/{domain}/` convention |
+| No-Go Zone | ✅ PASS | `token_storage.dart` not in No-Go Zone |
+| Dependency direction | ✅ PASS | presentation → domain → data |
+| Error architecture | ⚠️ CONCERN | Error types defined, but missing retry strategy |
+| Security section | ✅ PASS | Auth flow, token storage documented |
+
+---
+
+## 3. Quality Assessment
+
+| Check | Result | Detail |
+|-------|--------|--------|
+| ENTRYPOINT | ✅ | T-001 correctly marked |
+| Circular DEPENDS | ✅ | No circular dependencies |
+| Task granularity | ✅ | All tasks ≤ 3h estimated |
+| TC coverage | ✅ | 100% REQ coverage |
+| TC edge cases | ⚠️ CONCERN | REQ-E02 only has happy-path error, missing empty email TC |
+| TC types | ✅ | Unit + E2E for critical paths |
+
+---
+
+## 4. Concerns
+
+### W-001: Missing retry strategy in error architecture
+- **Type**: Quality
+- **Severity**: Medium
+- **Description**: Plan defines error types but doesn't specify retry behavior for network errors. LoginUseCase should handle transient failures.
+- **Assigned to**: B.1 (Implement Agent — T-004)
+- **Must verify at**: R.1
+
+### W-002: REQ-E02 missing edge case TC for empty email
+- **Type**: Coverage
+- **Severity**: Low
+- **Description**: TC-E02-01 tests wrong password, but no TC for empty email or malformed email format.
+- **Assigned to**: B.1 (Implement Agent — add test in T-005)
+- **Must verify at**: R.1
+
+---
+
+## 5. Issues Found
+
+### Critical
+_(none)_
+
+### Major
+_(none)_
+
+### Minor
+- Rate limit TC-O01-01 doesn't specify timer reset behavior after 15 minutes
+
+---
+
+## 6. Verdict Rationale
+
+Traceability 100% (4/4 REQs covered). Constitution alignment verified. No No-Go Zone violations. 2 concerns raised (error retry + edge case TC) — both addressable during B.1 without redesign.
+
+**→ PASS WITH CONCERNS**: Implement Agent MAY proceed, MUST address W-001 and W-002.
+
+---
+
+## 7. Routing Decision
+
+```yaml
+verdict: "PASS_WITH_CONCERNS"
+concerns_count: 2
+route_decision: "/v.implement"
+concerns_carry_forward:
+  - id: "W-001"
+    assigned_phase: "B.1"
+    assigned_task: "T-004"
+  - id: "W-002"
+    assigned_phase: "B.1"
+    assigned_task: "T-005"
+```

package/skills/check/cross-validator/gotchas.md

@@ -0,0 +1,43 @@
+# Gotchas — Cross Validator
+
+> Cập nhật liên tục khi Agent gặp edge case mới.
+> Mỗi lỗi lặp lại 2 lần → BẮT BUỘC thêm vào đây.
+
+---
+
+## Anti-Patterns
+
+1. ❌ **Rubber stamp PASS** — Tất cả trông OK → PASS mà không check kỹ.
+   - **Hậu quả**: Gaps leak ra implement → costly rework.
+   - **Fix**: PHẢI build traceability matrix. Không có matrix = không có verdict.
+
+2. ❌ **FAIL vì perfectionism** — Fail mọi thứ vì "có thể tốt hơn".
+   - **Fix**: FAIL chỉ khi có EVIDENCE cụ thể: missing REQ coverage, constitution violation, No-Go Zone.
+
+3. ❌ **Quên No-Go Zone check** — Validate spec↔plan nhưng không check context.md.
+   - **Hậu quả**: Plan includes No-Go Zone modification → Implement Agent blocked.
+   - **Fix**: ALWAYS check plan file paths vs context.md No-Go Zones.
+
+4. ❌ **Concerns quá vague** — "W-001: Cần cải thiện quality."
+   - **Fix**: Concern PHẢI specific: "W-001: REQ-E02 chỉ có 1 TC (chỉ happy path), thiếu error TC."
+
+5. ❌ **Quên routing decision** — Report không nói FAIL vì gì và route đi đâu.
+   - **Fix**: Mỗi FAIL PHẢI có `fail_reason` + `route_decision`. Mỗi CONCERN PHẢI có `assigned_to`.
+
+6. ❌ **Đếm TC nhưng không check content** — "REQ-E01 có 3 TC" nhưng 3 TC test cùng behavior.
+   - **Fix**: Check TC CONTENT, không chỉ count. Duplicate TCs = coverage ảo.
+
+7. ❌ **Miss plan↔constitution alignment** — Verify REQ coverage nhưng quên pattern check.
+   - **Fix**: Phase 2 Consistency Check PHẢI bao gồm constitution pattern alignment.
+
+8. ❌ **Suy đoán thay vì flag** — Spec mơ hồ → tự interpret rồi PASS.
+   - **Fix**: Mơ hồ = flag. Không tự điền thông tin thiếu. Concern hoặc FAIL → BA Agent fix.
+
+---
+
+## Edge Cases
+
+- ✅ Spec rất nhỏ (2-3 REQ) → Matrix vẫn bắt buộc. Đơn giản hơn nhưng phải có.
+- ✅ No constitution.md → FLAG [⚠️ No constitution] → PASS WITH CONCERNS mặc định.
+- ✅ No context.md (greenfield) → Skip No-Go Zone check, note trong report.
+- ✅ > 5 concerns → Nâng lên FAIL, quá nhiều concerns = plan chưa ready.

package/skills/implement/constitution-enforcer/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: constitution-enforcer
+version: "1.0"
+agent: implement
+phase: B.1
+triggers:
+  - implement_agent_pre_commit
+  - review_agent_check
+dependencies:
+  - _shared/constitution-reader
+  - _shared/context-reader
+input:
+  - constitution.md
+  - source code files
+  - context.md (for no-go zones)
+output:
+  - compliance_report (pass/fail with violations list)
+complexity: medium
+---
+
+# Constitution Enforcer Skill
+
+> **Purpose**: Tự động kiểm tra code đang implement có tuân thủ các quy tắc trong `constitution.md` không.
+> **Khi nào dùng**: Trước mỗi commit trong B.1 (Implement) và tại R.1 (Review).
+
+## Quick Reference
+
+```
+Input:  constitution.md + source code files + context.md
+Output: Compliance report (PASS / FAIL with violations)
+Agent:  Implement Agent, Review Agent
+Phase:  B.1 → R.1
+```
+
+## Enforcement: tool-enforced vs LLM-judged
+
+> ⚠️ Đừng tự lừa bằng "đọc bằng mắt". Tách rõ phần **chạy được bằng lệnh** và phần **cần LLM/human suy xét**.
+
+| Tầng | Cách enforce | Gồm |
+|------|-------------|-----|
+| **Cơ học (deterministic)** | `bash .v-flow/skills/implement/constitution-enforcer/scripts/check-constitution.sh` + linter dự án | hardcoded secret, lint/format, (mở rộng được: forbidden import) |
+| **Semantic (LLM/human)** | đọc `constitution.md` + đối chiếu code | architecture/layer separation, naming convention nghiệp vụ, API/UI convention |
+
+- Implement Agent ở **B.1** chạy script ở Bước 4 (pre-commit). Lint command lấy từ `.v-flow/config.yaml → lint_command` hoặc autodetect.
+- Phần semantic vẫn phải review — script **không** thay thế.
+- Muốn enforce cứng → wire script vào git pre-commit / CI (xem `## Wiring enforcement thật` cuối file).
+
+## What This Skill Does
+
+1. **Parse Constitution Rules** — Đọc `constitution.md`, trích xuất các quy tắc enforceable
+2. **Classify Rules** — Phân loại thành: Naming, Architecture, Testing, Security, API, UI/UX
+3. **Scan Code** — Phần cơ học chạy `.v-flow/skills/implement/constitution-enforcer/scripts/check-constitution.sh`; phần semantic LLM đối chiếu
+4. **Report** — Tạo compliance report với violations và suggestions
+
+## Rule Categories
+
+| Category | Examples | Auto-checkable |
+|----------|---------|----------------|
+| **Naming** | Variable naming, file naming conventions | ✅ Yes |
+| **Architecture** | Layer separation, forbidden imports | ✅ Yes |
+| **Testing** | Min coverage, test file naming | ✅ Yes |
+| **Security** | No hardcoded secrets, input validation | ⚠️ Partial |
+| **API** | Response format, error handling | ⚠️ Partial |
+| **UI/UX** | Design system usage | ❌ Manual |
+
+## How to Use
+
+### Step 1: Extract Rules from Constitution
+
+```markdown
+Đọc constitution.md, trích xuất các quy tắc có thể enforce tự động.
+Mỗi rule cần có:
+- Rule ID (ví dụ: CONST-ARCH-001)
+- Category (Naming/Architecture/Testing/Security/API)
+- Description
+- Check method (regex pattern, import check, file structure check)
+- Severity (error/warning)
+```
+
+### Step 2: Check Code Against Rules
+
+```markdown
+Cho mỗi file trong changeset:
+1. Check naming conventions (file names, function names, variable names)
+2. Check import patterns (forbidden dependencies, layer violations)
+3. Check test existence (nếu constitution yêu cầu)
+4. Check security patterns (hardcoded values, unsafe operations)
+5. Check API conventions (response format, error handling)
+```
+
+### Step 3: Generate Report
+
+```markdown
+## Constitution Compliance Report
+
+### Summary
+- Rules checked: X
+- Violations: Y (Z errors, W warnings)
+- Compliance score: XX%
+
+### Violations
+| # | Rule | File | Line | Description | Severity |
+|---|------|------|------|-------------|----------|
+| 1 | CONST-ARCH-001 | src/api/handler.js | 15 | Direct DB access from handler (should use repository) | Error |
+
+### Passed Rules
+| Rule | Description |
+|------|-------------|
+| CONST-NAME-001 | File naming follows kebab-case |
+```
+
+## Integration Points
+
+- **Pre-commit**: Implement Agent chạy trước khi commit
+- **Review**: Review Agent include trong adversarial review
+- **CI**: Có thể tích hợp vào CI pipeline
+
+## Gotchas
+
+1. **Không phải mọi rule đều auto-checkable** — UI/UX rules cần manual review
+2. **False positives** — Regex-based checks có thể bắt nhầm. Agent nên verify context
+3. **Performance** — Với codebase lớn, chỉ check changed files, không scan toàn bộ
+4. **Constitution evolves** — Khi constitution update, cần re-run check trên existing code
+
+## Wiring enforcement thật (tùy chọn — khuyến nghị cho production)
+
+> Frontmatter `triggers: [pre_commit, review_check]` chỉ là **ý định** — harness/Claude Code KHÔNG tự fire. Có 2 cách để enforce thật (chọn 1):
+
+1. **Agent-invoked (mặc định, không cần setup)**: Implement Agent chạy script trong quy trình B.1 (Bước 4). Deterministic trong 1 lần chạy V-Flow, nhưng phụ thuộc agent thực hiện đúng quy trình.
+2. **Hard gate (CI / git hook)** — chống bỏ sót triệt để:
+   - **git pre-commit**: tạo `.husky/pre-commit` (hoặc `.git/hooks/pre-commit`) gọi `bash .v-flow/skills/implement/constitution-enforcer/scripts/check-constitution.sh` và `.v-flow/skills/implement/no-go-zone-guard/scripts/check-nogo-zones.sh` cho mỗi staged file.
+   - **CI**: thêm step chạy 2 script trên PR; fail build nếu exit ≠ 0.
+
+> ⚠️ Việc tạo git hook làm thay đổi môi trường dev của cả team — chỉ thêm khi đã thống nhất.

package/skills/implement/constitution-enforcer/config.json

@@ -0,0 +1,16 @@
+{
+  "name": "constitution-enforcer",
+  "version": "1.0",
+  "description": "Validates code against constitution.md rules during B.1 and R.1",
+  "agent": "implement",
+  "phase": ["B.1", "R.1"],
+  "triggers": ["pre_commit", "review_check"],
+  "dependencies": ["_shared/constitution-reader", "_shared/context-reader"],
+  "config": {
+    "severity_levels": ["error", "warning", "info"],
+    "default_categories": ["naming", "architecture", "testing", "security", "api"],
+    "scan_mode": "changed_files",
+    "fail_on": "error",
+    "report_format": "markdown"
+  }
+}

package/skills/implement/constitution-enforcer/examples/bad/vague-report.md

@@ -0,0 +1,42 @@
+# Constitution Enforcer — Bad Example
+
+> Ví dụ output THIẾU SÓT — không nên làm theo.
+
+## ❌ Bad Output
+
+```markdown
+## Constitution Check
+
+Everything looks fine. No major issues found.
+
+Compliance: OK
+```
+
+## Vấn đề
+
+| # | Lỗi | Giải thích |
+|---|------|-----------|
+| 1 | Không cụ thể | "Everything looks fine" không list rules đã check |
+| 2 | Không có evidence | Không chỉ rõ files đã scan |
+| 3 | False negative | Có thể bỏ sót violations vì không check systematic |
+| 4 | Không có score | Không có metric để track trends |
+| 5 | Không liệt kê passed rules | Không chứng minh thực sự đã check |
+
+## ❌ Bad Output — Quá vague
+
+```markdown
+## Compliance Report
+
+- Checked 3 files
+- Found some naming issues
+- Architecture seems OK
+```
+
+## Vấn đề
+
+| # | Lỗi | Giải thích |
+|---|------|-----------|
+| 1 | "Some naming issues" — mấy? ở đâu? | Phải chỉ file + line + rule |
+| 2 | "Seems OK" — không xác định | Phải PASS hoặc FAIL rõ ràng |
+| 3 | Không có Rule ID | Không thể trace back constitution section |
+| 4 | Không có severity | Không biết Error hay Warning |

package/skills/implement/constitution-enforcer/examples/good/compliance-report.md

@@ -0,0 +1,57 @@
+# Constitution Enforcer — Good Example
+
+> Ví dụ output khi Implement Agent chạy constitution-enforcer trước khi commit.
+
+## Input
+
+**Constitution.md excerpts:**
+```markdown
+§1 Architecture: Clean Architecture — domain layer KHÔNG import từ data/presentation
+§2 Code Standards: camelCase cho variables, PascalCase cho classes
+§6 Naming: Files dùng kebab-case, test files dùng *.test.js
+§7 No-Go Zones: lib/legacy-auth/** (không sửa, không import)
+```
+
+**Changed files:**
+- `src/features/user/domain/user.entity.js`
+- `src/features/user/data/user.repository.js`
+- `src/features/user/presentation/user.controller.js`
+
+## Output — Constitution Compliance Report
+
+```markdown
+## Constitution Compliance Report
+
+### Summary
+- Rules checked: 12
+- Violations: 2 (1 error, 1 warning)
+- Compliance score: 83%
+
+### Violations
+
+| # | Rule | File | Line | Description | Severity |
+|---|------|------|------|-------------|----------|
+| 1 | CONST-ARCH-001 | user.entity.js | 3 | `import { db } from '../../data/database'` — Domain layer importing from data layer | Error |
+| 2 | CONST-NAME-002 | user.controller.js | 15 | Variable `user_name` uses snake_case instead of camelCase | Warning |
+
+### Passed Rules
+
+| Rule | Description | Files Checked |
+|------|-------------|---------------|
+| CONST-NAME-001 | File naming follows kebab-case | 3/3 ✅ |
+| CONST-NAME-003 | Test files use *.test.js pattern | 1/1 ✅ |
+| CONST-ARCH-002 | No imports from No-Go Zones (lib/legacy-auth) | 3/3 ✅ |
+| CONST-SEC-001 | No hardcoded secrets detected | 3/3 ✅ |
+
+### Recommendations
+1. **CONST-ARCH-001**: Move database dependency to repository layer, inject via constructor
+2. **CONST-NAME-002**: Rename `user_name` → `userName`
+```
+
+## Why This Is Good
+
+1. ✅ Cụ thể — chỉ rõ file, line, và rule bị vi phạm
+2. ✅ Actionable — mỗi violation có recommendation cụ thể
+3. ✅ Balanced — liệt kê cả passed rules
+4. ✅ Severity phân rõ — Error vs Warning giúp prioritize
+5. ✅ Compliance score — metric đo lường trends

package/skills/implement/constitution-enforcer/gotchas.md

@@ -0,0 +1,26 @@
+# Constitution Enforcer — Gotchas & Common Mistakes
+
+## ⚠️ Gotcha 1: Over-enforcement
+
+**Sai**: Cứng nhắc block mọi vi phạm, kể cả những rule mơ hồ.  
+**Đúng**: Chỉ block trên `error` severity. `warning` chỉ cảnh báo, để developer quyết định.
+
+## ⚠️ Gotcha 2: Scope Creep
+
+**Sai**: Check toàn bộ codebase mỗi lần commit.  
+**Đúng**: Chỉ check **changed files** trong commit/PR hiện tại. Full scan chỉ khi `v-flow doctor`.
+
+## ⚠️ Gotcha 3: Static Rules vs Dynamic Context
+
+**Sai**: Áp dụng naming convention cho tất cả files, kể cả generated code.  
+**Đúng**: Respect No-Go Zones từ `context.md`. Generated code, vendor code, legacy code excluded.
+
+## ⚠️ Gotcha 4: Constitution Updates
+
+**Sai**: Khi constitution update, yêu cầu fix ngay toàn bộ codebase.  
+**Đúng**: New rules chỉ apply cho new/changed code. Tạo tech-debt ticket cho existing violations.
+
+## ⚠️ Gotcha 5: False Positives trong Security Checks
+
+**Sai**: Flag mọi string constant as "potential hardcoded secret".  
+**Đúng**: Chỉ flag patterns match secrets (keys, tokens, passwords). Use allowlist cho known safe constants.

package/skills/implement/constitution-enforcer/scripts/check-constitution.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# check-constitution.sh — Phần CƠ HỌC (tool-enforced) của Constitution compliance.
+# KHÔNG thay thế LLM review cho rule semantic (architecture/layering/API) — chỉ chạy
+# các check có thể tự động hóa: (1) scan hardcoded secret, (2) chạy linter của dự án.
+#
+# Usage:
+#   ./check-constitution.sh [--base <git-ref>] [--lint "<command>"]
+#   --base   : so changed files với ref này (mặc định: HEAD + staged)
+#   --lint   : lệnh lint tường minh; nếu bỏ → đọc .v-flow/config.yaml → lint_command,
+#              rồi autodetect (npm run lint / flutter analyze / ruff). Không có → skip.
+#
+# Exit: 0 = PASS · 1 = FAIL (secret tìm thấy hoặc lint fail)
+
+set -u
+BASE=""
+LINT_CMD=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --base) BASE="$2"; shift 2 ;;
+    --lint) LINT_CMD="$2"; shift 2 ;;
+    *) echo "Unknown arg: $1"; exit 1 ;;
+  esac
+done
+
+FAIL=0
+
+# ── Danh sách changed files ──────────────────────────────────────────────
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  echo "ℹ️  Không phải git repo — bỏ qua phần changed-files; chỉ chạy lint nếu có."
+  CHANGED=""
+else
+  if [ -n "$BASE" ]; then
+    CHANGED=$(git diff --name-only --diff-filter=ACM "$BASE" 2>/dev/null)
+  else
+    CHANGED=$( (git diff --name-only --diff-filter=ACM HEAD 2>/dev/null; \
+                git diff --cached --name-only --diff-filter=ACM 2>/dev/null) | sort -u)
+  fi
+fi
+
+# ── Check 1: Hardcoded secrets (deterministic) ───────────────────────────
+echo "── Secret scan (changed files) ──"
+SECRET_RE='(AKIA[0-9A-Z]{16})|(-----BEGIN [A-Z ]*PRIVATE KEY-----)|(([Aa][Pp][Ii]_?[Kk][Ee][Yy]|[Ss][Ee][Cc][Rr][Ee][Tt]|[Tt][Oo][Kk][Ee][Nn]|[Pp][Aa][Ss][Ss][Ww][Oo][Rr][Dd])[[:space:]]*[:=][[:space:]]*['"'"'"][^'"'"'"]{8,}['"'"'"])'
+# Allowlist: env-var, ví dụ, placeholder — bỏ qua để giảm false positive
+ALLOW_RE='process\.env|os\.environ|getenv|import\.meta\.env|example|placeholder|changeme|dummy|<your|xxxx|REDACTED|\$\{'
+SECRET_HITS=0
+if [ -n "$CHANGED" ]; then
+  while IFS= read -r f; do
+    [ -z "$f" ] || [ ! -f "$f" ] && continue
+    case "$f" in *.lock|*.png|*.jpg|*.svg|*.min.js) continue ;; esac
+    hits=$(grep -EnI "$SECRET_RE" "$f" 2>/dev/null | grep -Ev "$ALLOW_RE")
+    if [ -n "$hits" ]; then
+      echo "🚫 Hardcoded secret nghi vấn trong $f:"
+      echo "$hits" | sed 's/^/     /'
+      SECRET_HITS=$((SECRET_HITS+1))
+    fi
+  done <<EOF
+$CHANGED
+EOF
+fi
+if [ "$SECRET_HITS" -eq 0 ]; then echo "✅ Không thấy hardcoded secret."; else FAIL=1; fi
+
+# ── Check 2: Linter của dự án ────────────────────────────────────────────
+echo "── Linter ──"
+if [ -z "$LINT_CMD" ] && [ -f .v-flow/config.yaml ]; then
+  LINT_CMD=$(grep -E '^[[:space:]]*lint_command:' .v-flow/config.yaml 2>/dev/null \
+             | head -1 | sed -E 's/^[^:]*:[[:space:]]*//; s/^["'"'"']//; s/["'"'"']$//')
+fi
+if [ -z "$LINT_CMD" ]; then
+  if [ -f package.json ] && grep -q '"lint"' package.json 2>/dev/null; then LINT_CMD="npm run -s lint"
+  elif [ -f pubspec.yaml ]; then LINT_CMD="flutter analyze"
+  elif command -v ruff >/dev/null 2>&1 && ls ./*.py >/dev/null 2>&1; then LINT_CMD="ruff check ."
+  fi
+fi
+if [ -z "$LINT_CMD" ]; then
+  echo "⚠️  Không xác định được lệnh lint — set .v-flow/config.yaml → lint_command hoặc dùng --lint. (skip)"
+else
+  echo "▶  $LINT_CMD"
+  if eval "$LINT_CMD"; then echo "✅ Lint pass."; else echo "🚫 Lint FAIL."; FAIL=1; fi
+fi
+
+echo "────────────────────────────"
+if [ "$FAIL" -eq 0 ]; then
+  echo "✅ check-constitution: PASS (phần cơ học). Rule semantic vẫn cần LLM/human review."
+  exit 0
+else
+  echo "🚫 check-constitution: FAIL — sửa trước khi commit."
+  exit 1
+fi