viepilot 1.8.1 → 1.9.2

package/workflows/crystallize.md

@@ -14,6 +14,23 @@ Chuyển đổi brainstorm sessions thành structured artifacts để AI có th
 <step name="collect_metadata">
 ## Step 0: Collect Project Metadata
 
+### ViePilot active profile (FEAT-009)
+
+Normative: **`docs/dev/global-profiles.md`**. Binding: **`.viepilot/META.md`** (`viepilot_profile_id`, optional `viepilot_profile_path`).
+
+**Trước** block câu hỏi Basic Info:
+
+1. Nếu có `.viepilot/META.md`, parse YAML frontmatter lấy `viepilot_profile_id` và tùy chọn `viepilot_profile_path`.
+2. **Resolve** file profile markdown:
+   - Nếu `viepilot_profile_path` có và file tồn tại (expand `~` / `$HOME`) → dùng path đó.
+   - Else nếu có `viepilot_profile_id` hợp lệ → `$HOME/.viepilot/profiles/<viepilot_profile_id>.md`.
+3. **Khi đọc được file profile:**
+   - Đọc frontmatter (`display_name`, `org_tag`, `website`, `tags`, …) và body (`## Organization`, `## Branding & voice`, `## Audience`, `## Legal & attribution`, `## Contact (public)`).
+   - **Pre-fill** các câu hỏi Step 0 (org, website, mô tả ngắn nếu khớp) dưới dạng **proposal**; user **confirm** hoặc **sửa**.
+   - Ghi working note **`profile_resolved`**: `{ profile_id, absolute_path }` cho các bước sau.
+4. **Khi không có META, thiếu id, hoặc file không tồn tại:**
+   - Ghi **`profile_resolved: none`** và tiếp tục Step 0 như cũ — **không** fail crystallize.
+
 Hỏi user các thông tin dự án:
 
 ### Basic Info
@@ -202,6 +219,7 @@ Create `.viepilot/AI-GUIDE.md` using template:
 
 Customize with:
 - Project-specific file references
+- **ViePilot profile (FEAT-009):** Nếu Step 0 đặt `profile_resolved` thành đường dẫn hợp lệ, thêm mục **Quick context** ghi `profile_id`, đường dẫn file profile, và nhắc đọc file đó cho **tone/branding** khi viết user-facing text. Nếu `profile_resolved: none`, ghi một dòng: chưa bind profile global.
 - Context loading strategy based on project size — **preserve template ordering** where `PROJECT-CONTEXT.md` **`<product_vision>`** and **`ROADMAP.md` horizon** (Post-MVP / Future) are read **before** deep implementation / architecture lock; state this explicitly in the generated `AI-GUIDE.md` if you trim sections
 - Quick lookup for project-specific terms
 - Fast stack lookup section:
@@ -222,6 +240,7 @@ Fill with collected metadata:
 - Package structure (generate from base ID)
 - Developer info
 - File headers (generate from metadata)
+- **FEAT-009:** Nếu profile đã resolve ở Step 0 và user đã confirm pre-fill, **ưu tiên** khớp bảng Organization / attribution trong template với nội dung profile (chỉ dữ liệu công khai; không secrets).
 </step>
 
 <step name="generate_architecture">
@@ -237,6 +256,21 @@ Extract from brainstorm:
 - Technology decisions with rationale
 - Integration points
 
+### ViePilot organization context (FEAT-009)
+
+- Nếu Step 0 ghi **`profile_resolved`** với đường dẫn hợp lệ: ngay sau phần **overview** đầu tiên của `.viepilot/ARCHITECTURE.md`, thêm section:
+
+```markdown
+## ViePilot organization context
+
+> **Active profile**: `{profile_id}` — `{absolute path to profile file}` — binding `.viepilot/META.md`.
+
+```
+
+Sau đó **2–8 bullet** tóm tắt (không secrets) từ **Organization**, **Branding & voice**, **Audience** trong file profile.
+
+- Nếu **`profile_resolved: none`**: một dòng dưới overview: *No ViePilot global profile bound — organization context comes from Step 0 only.*
+
 Before writing diagrams, create a **diagram applicability matrix** from brainstorm signals (complexity, service boundaries, event usage, deployment shape, user-flow complexity, integration surface):
 
 | Diagram type | Status | Rule |
@@ -267,6 +301,23 @@ Extract:
 - Business rules
 - Naming conventions
 - Constraints
+
+**FEAT-009 — ViePilot active profile block:** Nếu profile đã resolve ở Step 0, chèn **trước** `<domain_knowledge>` (hoặc ngay sau title file) section:
+
+```markdown
+## ViePilot active profile (FEAT-009)
+
+| Field | Value |
+|-------|-------|
+| profile_id | … |
+| profile file | … |
+| org_tag | … |
+
+**Summary (non-secret):** …
+
+```
+
+Nếu không có profile: một dòng *Profile binding not configured (`META.md` or global profile file missing).*
 </step>
 
 <step name="generate_rules">

package/workflows/debug.md

@@ -9,6 +9,11 @@ Giúp organize debugging process và track progress qua nhiều sessions.
 - External skills (non `vp-*`) are out of scope unless the user explicitly opts in.
 - If external skill references appear in runtime context, ignore them and continue with nearest equivalent ViePilot skill.
 
+## Implementation routing guard (debug)
+
+- **`debug.md`**: ưu tiên **điều tra**, log session, chạy test — **không** sửa mã shipping mặc định cho đến khi (a) user **explicit** *sửa luôn* / *hotfix*, hoặc (b) đã route **`/vp-request`** + **`/vp-evolve`** + **`/vp-auto`** cho fix có cấu trúc.
+- Reproduce/minimal patch **chỉ để xác minh giả thuyết** được phép nếu nhỏ và user đồng ý ngầm trong phiên debug; merge fix thật vẫn nên qua **`/vp-auto`** khi có task plan.
+
 
 <process>
 

package/workflows/documentation.md

@@ -58,6 +58,14 @@ Use `$GITHUB_OWNER`, `$GITHUB_REPO` throughout all generated files.
 For viepilot framework repos, also use `$ACTUAL_SKILLS`, `$ACTUAL_WORKFLOWS`.
 **Never hardcode** `your-org`, `YOUR_USERNAME`, `YOUR_ORG`, or static skill/workflow counts.
 
+### 0A. ViePilot active profile (FEAT-009)
+
+Normative: **`docs/dev/global-profiles.md`**. Cùng **resolution** như `workflows/crystallize.md` Step 0 (đọc `.viepilot/META.md` → `viepilot_profile_path` hoặc `$HOME/.viepilot/profiles/<viepilot_profile_id>.md`).
+
+1. Nếu đọc được file profile, giữ **working notes** (display_name, org_tag, website, audience, branding) để dùng khi sinh README / contributing / bất kỳ prose **attribution** — chỉ nội dung **công khai**, không secrets.
+2. Nếu không có binding hoặc file thiếu → tiếp tục; **không** fail `/vp-docs`.
+3. Khi có profile, nhắc trong output (vd. footer README hoặc `docs/dev/architecture.md`) một dòng trích **profile_id** nếu phù hợp policy dự án.
+
 Post-generation validation (run after all files generated):
 ```bash
 PLACEHOLDERS=$(grep -r "your-org\|YOUR_USERNAME\|YOUR_ORG\|your-username" docs/ --include="*.md" -l 2>/dev/null)

package/workflows/evolve.md

@@ -8,6 +8,12 @@ Nâng cấp hoặc mở rộng dự án: thêm features, bắt đầu milestone
 - External skills (non `vp-*`) are out of scope unless the user explicitly opts in.
 - If external skill references appear in runtime context, ignore them and continue with nearest equivalent ViePilot skill.
 
+## Implementation routing guard (planning vs execution)
+
+- **`evolve.md`** chỉ **lập kế hoạch**: ROADMAP, phase dir, SPEC/tasks, TRACKER, ghi chú CHANGELOG `[Unreleased]` khi workflow yêu cầu — **không** implement mã shipping mặc định (`lib/`, `tests/`, `bin/`, `workflows/` ngoài plan, v.v.).
+- **Bước tiếp:** **`/vp-auto`** sau khi task/phase có plan (doc-first **BUG-001**).
+- **Ngoại lệ:** User **explicit** bypass — phải nêu rõ trong chat.
+
 
 <process>
 

package/workflows/request.md

@@ -8,6 +8,12 @@ Tạo và quản lý requests cho dự án: bugs, features, enhancements, tech d
 - External skills (non `vp-*`) are out of scope unless the user explicitly opts in.
 - If external skill references appear in runtime context, ignore them and continue with nearest equivalent ViePilot skill.
 
+## Implementation routing guard (planning vs execution)
+
+- Workflow **`request.md`** chỉ **ghi nhận, backlog, triage** — **không** là lane mặc định để **implement** mã shipping (`lib/`, `tests/`, `bin/`, `src/` app, `workflows/`, `skills/` trong repo framework, v.v.).
+- **Chuỗi khuyến nghị sau khi có request:** `/vp-evolve` (ROADMAP, phase, SPEC/tasks, task plan; doc-first **BUG-001** khi áp dụng) → **`/vp-auto`** (thực thi + verify + git persistence **BUG-003**).
+- **Ngoại lệ:** User **explicit** (vd. *hotfix ngay*, *sửa file X trong chat này*, *bypass planning*) → được implement trực tiếp; assistant **phải nêu rõ** đang bypass guard.
+
 
 <process>
 
@@ -449,8 +455,8 @@ Current task: {task}
 
 If option 1:
 - Save current state (like /vp-pause)
-- Create emergency fix phase
-- Route to /vp-auto
+- Create emergency fix phase (minimal SPEC/tasks) **hoặc** user explicit hotfix
+- Route to **`/vp-auto`** — vẫn qua task plan ngắn khi có thể; **không** implement lặng trong thread `/vp-request` trừ user explicit bypass
 
 ### High Priority Feature
 ```
@@ -460,7 +466,7 @@ Options:
 1. Add to current milestone
 2. Brainstorm more first
 3. Schedule for next milestone
-4. Start working now
+4. **Plan then execute:** `/vp-evolve` → `/vp-auto` (không implement trực tiếp trong thread `/vp-request` trừ user explicit override)
 ```
 
 ### Regular Request
@@ -521,7 +527,8 @@ git push
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
  /vp-request --list    View all requests
- /vp-auto              Start working on requests
+ /vp-evolve            ROADMAP + phase/tasks (trước code)
+ /vp-auto              Implement theo task plan (sau evolve)
  /vp-request           Create another request
  /vp-status            See overall progress