Glossary & Impact Map

Version: 1.6.2 | Last updated: 2026-03-24 Mục đích: Danh mục thuật ngữ, biến, fields sử dụng trong PARA Workspace. Mỗi entry = 5 trường thống nhất (graph-ready design).

active_plan

• Định nghĩa: Đường dẫn đến implementation plan đang hoạt động. Hỗ trợ local path và tiền tố @{ecosystem}/ cho cross-project.
• Nơi định nghĩa: kernel/schema/project.schema.json (type: string|null)
• Nơi sử dụng:
  • /open (Step 5) — đọc plan summary
  • /open (Step 5.5) — roadmap context (v1.6.1)
  • /end (Step 4) — kiểm tra tiến độ plan
  • /end (Step 4.5) — đồng bộ trạng thái roadmap (v1.6.1)
  • /plan (create Step 2.8, Step 10, review Step 1, Step 6.5) — kích hoạt/đọc/quản lý vòng đời plan
  • /para-audit (update Step 3) — xác thực trường tồn tại
• Ảnh hưởng khi sửa: 4 workflows. Nếu đổi cú pháp tiền tố @ → cần cập nhật logic phân giải ở 4 nơi.
• Ghi chú: Chỉ trỏ đến detail plan, không bao giờ trỏ đến roadmap. Roadmap là reference context (v1.6.1).
• Liên quan: ecosystem, type, satellites, roadmap, detail_plan

type

• Định nghĩa: Loại project. standard = project thường, ecosystem = meta-project điều phối satellites.
• Nơi định nghĩa: kernel/schema/project.schema.json (enum: standard|ecosystem, default: standard)
• Nơi sử dụng:
  • /open (Step 2) — phát hiện ecosystem
  • /open (Step 7) — bỏ qua git cho ecosystem
  • /end (Step 3.5) — bỏ qua gợi ý git
  • /new-project (Step 2) — hỏi chọn loại project
  • /para-audit (update Step 3) — xác thực tính nhất quán
• Ảnh hưởng khi sửa: 5 workflows. Nếu thêm giá trị enum mới → cập nhật 5 nơi.
• Liên quan: ecosystem, satellites

ecosystem

• Định nghĩa: Tên ecosystem cha (meta-project slug). Gán trên các satellite projects.
• Nơi định nghĩa: kernel/schema/project.schema.json (type: string|null, pattern: kebab-case)
• Nơi sử dụng:
  • /open (Step 2) — ghi nhận parent ecosystem
  • /open (Step 5) — phân giải tiền tố @
  • /para-audit (update Step 3) — đối chiếu với danh sách satellites
  • /new-project (Step 2) — hỏi nhập tên ecosystem
• Ảnh hưởng khi sửa: 4 workflows. Nếu đổi quy ước đặt tên → cần đổi tên toàn bộ satellite project.md.
• Liên quan: type, satellites, active_plan

satellites

• Định nghĩa: Danh sách slug các satellite projects. Chỉ hợp lệ khi type: ecosystem.
• Nơi định nghĩa: kernel/schema/project.schema.json (type: array|null, items: kebab-case)
• Nơi sử dụng:
  • /open (Step 2, Step 8) — hiển thị danh sách satellites trong report
  • /para-audit (update Step 3) — đối chiếu với ecosystem fields
• Ảnh hưởng khi sửa: 2 workflows. Ảnh hưởng thấp — chỉ hiển thị + xác thực.
• Liên quan: type, ecosystem

profile

• Định nghĩa: Profile preset khi khởi tạo workspace. Định hướng departments/capabilities.
• Nơi định nghĩa: kernel/schema/workspace.schema.json + project.schema.json (enum: dev|general|marketer|ceo)
• Nơi sử dụng:
  • para init CLI — chọn profile
  • para scaffold CLI — thiết lập trong .project.yml
  • Profile presets (templates/profiles/*/preset.yaml) — cấu trúc thư mục
  • /new-project (Step 2) — kế thừa từ workspace
• Ảnh hưởng khi sửa: Schema (2 files), CLI (2 lệnh), templates (4 presets), workflows (1). Rất cao.
• Liên quan: kernel_version

kernel_version

• Định nghĩa: Phiên bản kernel tại thời điểm init/update. Định dạng SemVer.
• Nơi định nghĩa: kernel/schema/workspace.schema.json + project.schema.json (type: string, pattern: semver)
• Nơi sử dụng:
  • .para-workspace.yml — cấp workspace
  • project.md — cấp project
  • para update CLI — kiểm tra tương thích
  • para migrate CLI — so sánh version
  • Catalog catalog.yml — ràng buộc kernel_min/kernel_max
  • /para-audit (update Step 1) — phát hiện thay đổi version
• Ảnh hưởng khi sửa: Schema (2 files), CLI (2 lệnh), catalog (mọi workflow entry), audit (1). Rất cao.
• Liên quan: profile

has_rules

• Định nghĩa: Boolean cho biết project có custom rules. DEPRECATED v1.6.2 — thay thế bằng agent map.
• Nơi định nghĩa: kernel/schema/project.schema.json (type: boolean, default: false, deprecated)
• Nơi sử dụng:
  • /open (Step 2.5c) — fallback khi agent.rules không tồn tại (backward compat)
  • /plan (Step 2.7 D2) — fallback cho việc nạp project rules
  • /para-audit (update Step 5) — phát hiện dự án cần migrate
• Ảnh hưởng khi sửa: 3 workflows (chỉ fallback path). Có thể xóa sau khi tất cả projects migrate sang agent map.
• Ghi chú: Đã được thay thế bởi agent map (v1.6.2). /open kiểm tra agent.rules trước, fallback sang has_rules.
• Liên quan: agent

agent

• Định nghĩa: Agent configuration map cho project-level indices. Chứa rules (boolean) và skills (boolean).
• Nơi định nghĩa: kernel/schema/project.schema.json (type: object|null, v1.6.2+)
• Nơi sử dụng:
  • /open (Step 2.5c) — quyết định nạp rules/skills index
  • /plan (Step 2.7 D2-D3) — nạp ràng buộc từ project rules/skills
  • /para-audit (update Step 3, 5) — kiểm tra schema + tính nhất quán
  • context-rules.md (§4) — Two-Tier project index loading
• Ảnh hưởng khi sửa: 4 workflows + 2 rules. Thay thế has_rules.
• Liên quan: has_rules (deprecated, tiền nhiệm)

proactive_trigger_check

• Định nghĩa: Cơ chế bảo vệ (v1.6.2) — agent quét TOÀN BỘ trigger tables (rules.md + skills.md, workspace + project) TRƯỚC mọi side-effect action. Nguyên tắc: “Check THEN act”.
• Nơi định nghĩa: Convention — agent-behavior.md §4 + context-rules.md §4 (v1.6.2)
• Nơi sử dụng:
  • agent-behavior.md §4 — Context Recovery + điều khoản proactive check
  • context-rules.md §4 — Quy trình nạp Agent Index
  • /open Step 2.5 — thiết lập trigger awareness ban đầu
  • Tất cả workflows Step 0 — Pre-flight re-reads (phòng thủ Layer 3)
• Ảnh hưởng khi sửa: 2 rules + 8 workflows. Ràng buộc hành vi cốt lõi.
• Liên quan: agent, has_rules

strategy

• Định nghĩa: Thư mục docs/strategy/ chứa tài liệu chiến lược (tầm nhìn, quyết định, luồng sản phẩm). Phát hiện qua filesystem, không cần trường schema.
• Nơi định nghĩa: Convention — không có schema (v1.6.1). Phát hiện bằng sự tồn tại của thư mục docs/strategy/.
• Nơi sử dụng:
  • /docs (Step 3.5) — phát hiện strategy docs + gợi ý tạo mới
  • /plan (Step 2.5) — ưu tiên brainstorm/strategy (D7, bỏ qua brainstorm nếu strategy mới hơn)
  • /plan (Step 2.9) — nạp context strategy cho detail plans
  • /open (Step 2 ext) — nạp summary chiến lược (~30 tokens)
  • /open (Step 5.5) — phát hiện strategy cascade (D10)
  • /end (Step 3.2) — phát hiện thay đổi strategy → tạo SYNC entries
• Ảnh hưởng khi sửa: 4 workflows. Nếu đổi đường dẫn thư mục → cập nhật tất cả glob patterns.
• Liên quan: roadmap, detail_plan, active_plan

roadmap

• Định nghĩa: plans/*-roadmap.md — living index của detail plans theo phases. Không bao giờ archive, không bao giờ set làm active_plan. Nhận diện qua naming convention (glob).
• Nơi định nghĩa: Convention — pattern [scope]-roadmap.md (v1.6.1). Không có trường schema.
• Nơi sử dụng:
  • /plan (Step 2.8) — chọn loại plan (phát hiện roadmap đã có)
  • /plan (Step 2.9) — trích target phase cho detail plan scope
  • /plan (Step 10) — tự động cập nhật roadmap khi detail plan được kích hoạt
  • /plan (review Step 6.5) — vòng đời roadmap (đánh dấu done, gợi ý phase tiếp)
  • /open (Step 5.5) — nạp context roadmap (tổng quan phases)
  • /end (Step 3.2) — phát hiện thay đổi roadmap
  • /end (Step 4.5) — đồng bộ trạng thái roadmap
• Ảnh hưởng khi sửa: 3 workflows. Nếu đổi naming convention → cập nhật tất cả glob patterns.
• Liên quan: strategy, detail_plan, active_plan

detail_plan

• Định nghĩa: plans/*.md (ngoại trừ roadmap) — implementation plan cấp task cho một version hoặc feature cụ thể. Là active_plan. Archive vào plans/done/ khi hoàn thành.
• Nơi định nghĩa: Convention — bất kỳ plans/*.md trừ *-roadmap.md (v1.6.1).
• Nơi sử dụng:
  • /plan (Step 2.8) — chọn loại plan (đếm active detail plans)
  • /plan (Step 9-10) — lưu + kích hoạt thành active_plan
  • /plan (review Step 6) — archive vào plans/done/
  • Tất cả workflows gián tiếp thông qua trường active_plan
• Ảnh hưởng khi sửa: Gián tiếp qua active_plan. Ảnh hưởng thấp khi đứng riêng.
• Liên quan: roadmap, strategy, active_plan

Bảng tóm tắt ảnh hưởng (Impact Summary)