@piagent/platform 1.8.0 → 1.9.1

package/docs/vi/architecture.md

@@ -37,6 +37,7 @@ Rule máy đọc nằm tại `architecture/layers.json`; chạy `npm run archite
 | Layer | Vị trí hiện tại | Ownership | Không được chứa |
 |---|---|---|---|
 | Composition | `packages/piagent-core/extensions/piagent-guard.ts` | Wiring, dependency construction, thứ tự registration | Feature algorithm, mutable state implementation, formatter lớn |
+| Managed harness | `packages/piagent-core/managed/` | Phiên công ty do Agent Watch nhập: grant Studio, tool worker trong sandbox, helper research/review, web search/fetch | OAuth cá nhân, extension cá nhân, quyết định chính sách của Studio |
 | Runtime adapters | `packages/piagent-core/runtime/` | Pi lifecycle hook, shared session state, command/tool registration, input routing | Policy decision dùng lại |
 | Core services | `packages/piagent-core/extensions/` trừ entrypoint | Policy, context, task lifecycle, state service | Pi command menu và UI text |
 | MCP integration | `packages/piagent-core/mcp/` | MCP config layer, readiness, approval, command action | Task và context policy |
@@ -73,7 +74,14 @@ Folder `extensions/` vẫn chứa một số service module do lịch sử. Tên
 
 ## Adaptive durable runtime
 
-Runtime hiện tại có sáu lớp state operational/derived:
+> Từ bản 1.9.0 (bỏ task contract ngày 2026-09-30), session không còn tạo task
+> contract, journal, trajectory hay recovery handoff, và guard không coi bản ghi
+> nào là đang hoạt động. Bốn lớp đầu trong bảng dưới mô tả bản ghi do các bản
+> trước tạo; chúng vẫn đọc được để xem lịch sử và kiểm tra. Lượt freeform vẫn giữ
+> các kiểm tra của guard về path, quyền, xác nhận, context budget và edit trên bản
+> đọc cũ.
+
+Runtime đã định nghĩa sáu lớp state operational/derived:
 
 | Layer | Source of truth | Derived state |
 |---|---|---|

package/docs/workflow-recipes.md

@@ -3,7 +3,7 @@
 
 ## Mục tiêu
 
-Các recipe này biến những bài toán lặp lại thành workflow có tên rõ, dùng được cho project khác mà không phụ thuộc một project nội bộ cụ thể.
+Các recipe này biến những bài toán lặp lại thành cách yêu cầu rõ ràng, dùng được cho project khác mà không phụ thuộc một project nội bộ cụ thể. Từ bản 1.9.0 không còn `/workflow` hay `/onboard`: mỗi recipe là một yêu cầu bằng lời thường.
 
 ## Recipe 1 — Platform improvement
 
@@ -12,11 +12,11 @@ Dùng khi muốn cải tiến setup, prompt, MCP, model scope, memory, runtime p
 Lệnh trong Pi:
 
 ```text
-/onboard
-/onboard run
-/workflow platform-improve Improve <target behavior> in <platform area>.
+Improve <target behavior> in <platform area>.
 ```
 
+Nếu project chưa onboard, nhờ agent "đọc project (chỉ đọc) và ghi lại project context" trước.
+
 Input tối thiểu:
 
 - source docs URL hoặc repo URL nếu task cần external context;
@@ -60,9 +60,7 @@ Setup project generic:
 Lệnh trong Pi:
 
 ```text
-/onboard
-/onboard run
-/workflow be-to-fe Implement FE from BE spec: <endpoint/spec/change>
+Implement FE from BE spec: <endpoint/spec/change>. Backend is read-only.
 ```
 
 Input tối thiểu:
@@ -115,8 +113,6 @@ Rule:
 Dùng khi muốn giảm scout lại giữa các session mà không bật auto memory.
 
 ```text
-/onboard
-/onboard run
 /context index
 /context search auth
 ```
@@ -126,4 +122,4 @@ Rule:
 1. Context index là advisory map, không phải source of truth.
 2. Node/edge phải ngắn và có citation tới file/doc/task đã verify.
 3. Không lưu raw transcript, secret, token, session, hoặc source excerpt dài.
-4. Nếu index stale so với profile/tech/onboarding snapshot, chạy lại `/onboard run` hoặc record lại bằng `piagent_context_index_record`.
+4. Nếu index stale so với profile/tech/onboarding snapshot, nhờ agent onboard lại hoặc record lại bằng `piagent_context_index_record`.

package/docs-site/architecture.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.8.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.9.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/architecture" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/architecture" hreflang="en" lang="en">EN</a>
@@ -59,6 +59,7 @@
           <div class="nav-group">
             <p class="nav-title">Get started</p>
             <a class="nav-link" href="/">Overview</a>
+            <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
             <a class="nav-link" href="/quickstart">Quickstart</a>
             <a class="nav-link" href="/whats-new">Có gì mới</a>
             <a class="nav-link" href="/scope">Phạm vi platform</a>
@@ -147,8 +148,8 @@
       <p><span class="inline-code">runtime/context/adaptive-planner.ts</span> chọn budget, retrieval lane, code inclusion và plan receipt theo phase, context pressure, model capability và thinking level.</p>
     </article>
     <article class="card">
-      <h3>Task journal</h3>
-      <p><span class="inline-code">extensions/task-journal.js</span> ghi checkpoint cho start, progress, mutation, verifier và completion. Resume tin task contract trước; retention compaction giữ hash anchor.</p>
+      <h3>Lịch sử task cũ</h3>
+      <p><span class="inline-code">extensions/task-journal.js</span> vẫn đọc checkpoint của các task tạo trước bản 1.9.0 để xem lại; session mới không ghi task nữa.</p>
     </article>
     <article class="card">
       <h3>Repository memory</h3>

package/docs-site/assets/docs.css

@@ -1457,3 +1457,83 @@ h3[id] {
     display: none;
   }
 }
+
+/* Screenshots and diagrams. Screenshots are taken from the dashboard in dark
+   mode so they sit on the page without a bright frame. */
+.shot {
+  margin: 28px 0 0;
+  border: 1px solid var(--line);
+  border-radius: 18px;
+  overflow: hidden;
+  background: var(--panel);
+  box-shadow: var(--shadow);
+}
+
+.shot img {
+  display: block;
+  width: 100%;
+  height: auto;
+}
+
+.shot figcaption {
+  padding: 12px 18px 14px;
+  border-top: 1px solid var(--line-soft);
+  color: var(--muted);
+  font-size: 0.92rem;
+}
+
+.shot-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 20px;
+  margin-top: 24px;
+}
+
+.shot-grid .shot {
+  margin: 0;
+}
+
+.diagram {
+  margin: 24px 0 0;
+  padding: 18px;
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  background: var(--bg-soft);
+  overflow-x: auto;
+}
+
+.diagram svg {
+  display: block;
+  width: 100%;
+  min-width: 720px;
+  height: auto;
+}
+
+.diagram-hint {
+  display: none;
+  margin-top: 8px;
+  color: var(--muted-2);
+  font-size: 0.85rem;
+}
+
+@media (max-width: 860px) {
+  .shot-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .diagram-hint {
+    display: block;
+  }
+
+  .diagram {
+    padding: 10px;
+  }
+}
+
+/* Long unbroken tokens (commit hashes, run ids) in running text wrap instead
+   of widening the page on a phone. */
+p code,
+li code,
+td code {
+  overflow-wrap: anywhere;
+}

package/docs-site/benchmark.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.8.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.9.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/benchmark" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/benchmark" hreflang="en" lang="en">EN</a>
@@ -59,6 +59,7 @@
           <div class="nav-group">
             <p class="nav-title">Get started</p>
             <a class="nav-link" href="/">Overview</a>
+            <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
             <a class="nav-link" href="/quickstart">Quickstart</a>
             <a class="nav-link" href="/whats-new">Có gì mới</a>
             <a class="nav-link" href="/scope">Phạm vi platform</a>
@@ -102,6 +103,11 @@
               <h1>Bằng chứng chất lượng và hiệu suất</h1>
               <p>Production benchmark so sánh Piagent với surface codex-cli trên cùng model, cùng thinking level, 18 nhóm bài và 108 session được chấm tự động.</p>
             </div>
+<div class="callout">
+  <strong>Số liệu lịch sử</strong>
+  <p>Phép đo này chạy ở v1.6.0, khi session còn task contract và các lệnh workflow. Bản 1.9.0 làm việc theo lời thường và chưa đo lại; đừng dùng các con số dưới đây cho 1.9.0.</p>
+</div>
+
 <section class="benchmark-summary" aria-labelledby="benchmark-verdict">
   <div class="benchmark-verdict">
     <div>

package/docs-site/commands.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.8.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.9.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/commands" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/commands" hreflang="en" lang="en">EN</a>
@@ -59,6 +59,7 @@
           <div class="nav-group">
             <p class="nav-title">Get started</p>
             <a class="nav-link" href="/">Overview</a>
+            <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
             <a class="nav-link" href="/quickstart">Quickstart</a>
             <a class="nav-link" href="/whats-new">Có gì mới</a>
             <a class="nav-link" href="/scope">Phạm vi platform</a>
@@ -110,7 +111,6 @@
       <div class="tag-list">
         <span class="tag">/login</span>
         <span class="tag">/model</span>
-        <span class="tag">/commands</span>
         <span class="tag">/piagent-status</span>
         <span class="tag">/piagent-inspector</span>
         <span class="tag">/piagent-orchestration</span>
@@ -119,10 +119,10 @@
         <span class="tag">/task-preflight</span>
         <span class="tag">/context preflight</span>
         <span class="tag">/name</span>
-        <span class="tag">/fresh</span>
+        <span class="tag">/new</span>
         <span class="tag">/session</span>
       </div>
-      <p>Dùng để setup session, chọn model, xem profile/usage/orchestration và quyết định có cần fresh session trước task lớn không.</p>
+      <p>Dùng để setup session, chọn model, xem profile/usage/orchestration và quyết định có cần mở session mới (<span class="inline-code">/new</span>) trước việc lớn không.</p>
     </article>
     <article class="card">
       <h3 id="project-profile">Project profile</h3>
@@ -139,35 +139,32 @@
       <p>Áp profile trực tiếp hoặc mở select option để chọn profile/tech stack. Output ngắn, không yêu cầu model giải thích dài.</p>
     </article>
     <article class="card">
-      <h3 id="implementation-workflow">Implementation workflow</h3>
+      <h3 id="implementation-workflow">Giao việc</h3>
       <div class="tag-list">
-        <span class="tag">/workflow</span>
-        <span class="tag">/workflow task</span>
-        <span class="tag">/workflow plan</span>
-        <span class="tag">/workflow review</span>
-        <span class="tag">/workflow scout</span>
-        <span class="tag">/workflow discuss</span>
+        <span class="tag">lời thường</span>
+        <span class="tag">chỉ đọc, không sửa</span>
+        <span class="tag">lập plan trước</span>
+        <span class="tag">review diff</span>
       </div>
-      <p>Gói sẵn read context, task contract, implementation, verify evidence và final handoff.</p>
+      <p>Từ bản 1.9.0 không còn <span class="inline-code">/workflow</span>, <span class="inline-code">/task</span> hay task contract: nói việc cần làm bằng lời thường; guard kiểm tra từng tool call.</p>
     </article>
     <article class="card">
       <h3 id="git-handoff">Git handoff</h3>
       <div class="tag-list">
-        <span class="tag">/workflow commit</span>
-        <span class="tag">/workflow pr</span>
+        <span class="tag">commit bằng lời thường</span>
+        <span class="tag">draft PR bằng lời thường</span>
         <span class="tag">git status</span>
         <span class="tag">git diff</span>
       </div>
-      <p>Không cần namespace <span class="inline-code">/git</span>. Commit/PR đi qua workflow guard; push và stage rộng như <span class="inline-code">git add -A</span> cần xác nhận.</p>
+      <p>Không cần namespace <span class="inline-code">/git</span>. Commit/PR là yêu cầu thường; push, ghi lên GitHub và stage rộng như <span class="inline-code">git add -A</span> cần xác nhận.</p>
     </article>
     <article class="card">
-      <h3 id="fresh-sessions">Fresh sessions</h3>
+      <h3 id="fresh-sessions">Session mới</h3>
       <div class="tag-list">
-        <span class="tag">/fresh task</span>
-        <span class="tag">/fresh scout</span>
-        <span class="tag">/fresh be-to-fe</span>
+        <span class="tag">/new</span>
+        <span class="tag">/compact</span>
       </div>
-      <p>Dùng khi context đã nặng hoặc cần một session sạch cho workflow mới.</p>
+      <p>Dùng khi context đã nặng hoặc cần một session sạch cho việc mới (<span class="inline-code">/fresh</span> đã bỏ từ bản 1.9.0).</p>
     </article>
     <article class="card">
       <h3 id="mcp">MCP</h3>
@@ -201,9 +198,9 @@
       <p>Xem intent, risk, scope, runtime, solver route, phase, tool/helper recommendation, backend, approval và blocker trước khi bắt đầu.</p>
     </article>
     <article class="command-card">
-      <header><span>Live task status</span><button class="clip-btn" data-clip="/piagent-status">Lấy lệnh</button></header>
+      <header><span>Trạng thái session</span><button class="clip-btn" data-clip="/piagent-status">Lấy lệnh</button></header>
       <pre><code>/piagent-status</code></pre>
-      <p>Đọc Task Contract, checkpoint, verifier, recovery, helper, resume state và terminal receipt. Receipt chỉ approved khi hard completion gate trên working tree hiện tại pass.</p>
+      <p>Profile, guard, runtime và model đang dùng của session. Không sửa file, không chạy lại check và không mở lượt model.</p>
     </article>
     <article class="command-card">
       <header><span>Activity, diff và context</span><button class="clip-btn" data-clip="/piagent-inspector">Lấy lệnh</button></header>
@@ -223,7 +220,24 @@
   </div>
   <div class="callout">
     <strong>Diff rõ nguồn, token không ước lượng.</strong>
-    <p>Footer status dùng file task đã quan sát để cập nhật nhanh; view <span class="inline-code">files</span> tính exact snapshot delta và đánh dấu <span class="inline-code">mixed-working-tree</span> nếu task đụng file đã dirty từ trước. Pi chỉ cung cấp model usage theo turn/session, nên token theo từng built-in tool luôn hiện unavailable.</p>
+    <p>Footer status dùng các file đã quan sát trong session để cập nhật nhanh; view <span class="inline-code">files</span> tính exact snapshot delta và đánh dấu <span class="inline-code">mixed-working-tree</span> nếu lượt làm việc đụng file đã dirty từ trước. Pi chỉ cung cấp model usage theo turn/session, nên token theo từng built-in tool luôn hiện unavailable.</p>
+  </div>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Skill và package tùy chọn</p>
+  <h2 id="skill-va-package">Kiểm tra chất lượng test, chạy vòng thử nghiệm</h2>
+  <div class="command-grid">
+    <article class="command-card">
+      <header><span>Rà soát test</span><button class="clip-btn" data-clip="/skill:test-audit rà soát test của module thanh toán">Lấy lệnh</button></header>
+      <pre><code>/skill:test-audit rà soát test của module thanh toán</code></pre>
+      <p>Skill <span class="inline-code">test-audit</span> đi kèm Piagent: chặn test mới không bảo vệ hành vi nào, tìm test trùng, test bám vào cách cài đặt và code chỉ tồn tại để phục vụ test. Agent tự dùng khi viết hay sửa test; gõ lệnh trên để rà cả một vùng.</p>
+    </article>
+    <article class="command-card">
+      <header><span>Vòng thử nghiệm</span><button class="clip-btn" data-clip="git switch -c experiment/toc-do-test">Lấy lệnh</button></header>
+      <pre><code>git switch -c experiment/toc-do-test</code></pre>
+      <p>Nếu cài thêm package có vòng thử nghiệm tự động (<span class="inline-code">run_experiment</span>, <span class="inline-code">log_experiment</span>): guard kiểm lệnh thử như mọi lệnh shell, và chỉ cho vòng lặp chạy trên nhánh <span class="inline-code">experiment/</span> hoặc worktree riêng, bắt đầu khi không còn thay đổi chưa commit, vì mỗi lần bỏ một ý tưởng nó xóa mọi thay đổi chưa commit.</p>
+    </article>
   </div>
 </section>
             <nav class="pager" aria-label="Trang kế tiếp">

package/docs-site/content/architecture.html

@@ -43,8 +43,8 @@
       <p><span class="inline-code">runtime/context/adaptive-planner.ts</span> chọn budget, retrieval lane, code inclusion và plan receipt theo phase, context pressure, model capability và thinking level.</p>
     </article>
     <article class="card">
-      <h3>Task journal</h3>
-      <p><span class="inline-code">extensions/task-journal.js</span> ghi checkpoint cho start, progress, mutation, verifier và completion. Resume tin task contract trước; retention compaction giữ hash anchor.</p>
+      <h3>Lịch sử task cũ</h3>
+      <p><span class="inline-code">extensions/task-journal.js</span> vẫn đọc checkpoint của các task tạo trước bản 1.9.0 để xem lại; session mới không ghi task nữa.</p>
     </article>
     <article class="card">
       <h3>Repository memory</h3>

package/docs-site/content/benchmark.html

@@ -1,3 +1,8 @@
+<div class="callout">
+  <strong>Số liệu lịch sử</strong>
+  <p>Phép đo này chạy ở v1.6.0, khi session còn task contract và các lệnh workflow. Bản 1.9.0 làm việc theo lời thường và chưa đo lại; đừng dùng các con số dưới đây cho 1.9.0.</p>
+</div>
+
 <section class="benchmark-summary" aria-labelledby="benchmark-verdict">
   <div class="benchmark-verdict">
     <div>

package/docs-site/content/commands.html

@@ -6,7 +6,6 @@
       <div class="tag-list">
         <span class="tag">/login</span>
         <span class="tag">/model</span>
-        <span class="tag">/commands</span>
         <span class="tag">/piagent-status</span>
         <span class="tag">/piagent-inspector</span>
         <span class="tag">/piagent-orchestration</span>
@@ -15,10 +14,10 @@
         <span class="tag">/task-preflight</span>
         <span class="tag">/context preflight</span>
         <span class="tag">/name</span>
-        <span class="tag">/fresh</span>
+        <span class="tag">/new</span>
         <span class="tag">/session</span>
       </div>
-      <p>Dùng để setup session, chọn model, xem profile/usage/orchestration và quyết định có cần fresh session trước task lớn không.</p>
+      <p>Dùng để setup session, chọn model, xem profile/usage/orchestration và quyết định có cần mở session mới (<span class="inline-code">/new</span>) trước việc lớn không.</p>
     </article>
     <article class="card">
       <h3 id="project-profile">Project profile</h3>
@@ -35,35 +34,32 @@
       <p>Áp profile trực tiếp hoặc mở select option để chọn profile/tech stack. Output ngắn, không yêu cầu model giải thích dài.</p>
     </article>
     <article class="card">
-      <h3 id="implementation-workflow">Implementation workflow</h3>
+      <h3 id="implementation-workflow">Giao việc</h3>
       <div class="tag-list">
-        <span class="tag">/workflow</span>
-        <span class="tag">/workflow task</span>
-        <span class="tag">/workflow plan</span>
-        <span class="tag">/workflow review</span>
-        <span class="tag">/workflow scout</span>
-        <span class="tag">/workflow discuss</span>
+        <span class="tag">lời thường</span>
+        <span class="tag">chỉ đọc, không sửa</span>
+        <span class="tag">lập plan trước</span>
+        <span class="tag">review diff</span>
       </div>
-      <p>Gói sẵn read context, task contract, implementation, verify evidence và final handoff.</p>
+      <p>Từ bản 1.9.0 không còn <span class="inline-code">/workflow</span>, <span class="inline-code">/task</span> hay task contract: nói việc cần làm bằng lời thường; guard kiểm tra từng tool call.</p>
     </article>
     <article class="card">
       <h3 id="git-handoff">Git handoff</h3>
       <div class="tag-list">
-        <span class="tag">/workflow commit</span>
-        <span class="tag">/workflow pr</span>
+        <span class="tag">commit bằng lời thường</span>
+        <span class="tag">draft PR bằng lời thường</span>
         <span class="tag">git status</span>
         <span class="tag">git diff</span>
       </div>
-      <p>Không cần namespace <span class="inline-code">/git</span>. Commit/PR đi qua workflow guard; push và stage rộng như <span class="inline-code">git add -A</span> cần xác nhận.</p>
+      <p>Không cần namespace <span class="inline-code">/git</span>. Commit/PR là yêu cầu thường; push, ghi lên GitHub và stage rộng như <span class="inline-code">git add -A</span> cần xác nhận.</p>
     </article>
     <article class="card">
-      <h3 id="fresh-sessions">Fresh sessions</h3>
+      <h3 id="fresh-sessions">Session mới</h3>
       <div class="tag-list">
-        <span class="tag">/fresh task</span>
-        <span class="tag">/fresh scout</span>
-        <span class="tag">/fresh be-to-fe</span>
+        <span class="tag">/new</span>
+        <span class="tag">/compact</span>
       </div>
-      <p>Dùng khi context đã nặng hoặc cần một session sạch cho workflow mới.</p>
+      <p>Dùng khi context đã nặng hoặc cần một session sạch cho việc mới (<span class="inline-code">/fresh</span> đã bỏ từ bản 1.9.0).</p>
     </article>
     <article class="card">
       <h3 id="mcp">MCP</h3>
@@ -97,9 +93,9 @@
       <p>Xem intent, risk, scope, runtime, solver route, phase, tool/helper recommendation, backend, approval và blocker trước khi bắt đầu.</p>
     </article>
     <article class="command-card">
-      <header><span>Live task status</span><button class="clip-btn" data-clip="/piagent-status">Lấy lệnh</button></header>
+      <header><span>Trạng thái session</span><button class="clip-btn" data-clip="/piagent-status">Lấy lệnh</button></header>
       <pre><code>/piagent-status</code></pre>
-      <p>Đọc Task Contract, checkpoint, verifier, recovery, helper, resume state và terminal receipt. Receipt chỉ approved khi hard completion gate trên working tree hiện tại pass.</p>
+      <p>Profile, guard, runtime và model đang dùng của session. Không sửa file, không chạy lại check và không mở lượt model.</p>
     </article>
     <article class="command-card">
       <header><span>Activity, diff và context</span><button class="clip-btn" data-clip="/piagent-inspector">Lấy lệnh</button></header>
@@ -119,6 +115,23 @@
   </div>
   <div class="callout">
     <strong>Diff rõ nguồn, token không ước lượng.</strong>
-    <p>Footer status dùng file task đã quan sát để cập nhật nhanh; view <span class="inline-code">files</span> tính exact snapshot delta và đánh dấu <span class="inline-code">mixed-working-tree</span> nếu task đụng file đã dirty từ trước. Pi chỉ cung cấp model usage theo turn/session, nên token theo từng built-in tool luôn hiện unavailable.</p>
+    <p>Footer status dùng các file đã quan sát trong session để cập nhật nhanh; view <span class="inline-code">files</span> tính exact snapshot delta và đánh dấu <span class="inline-code">mixed-working-tree</span> nếu lượt làm việc đụng file đã dirty từ trước. Pi chỉ cung cấp model usage theo turn/session, nên token theo từng built-in tool luôn hiện unavailable.</p>
+  </div>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Skill và package tùy chọn</p>
+  <h2 id="skill-va-package">Kiểm tra chất lượng test, chạy vòng thử nghiệm</h2>
+  <div class="command-grid">
+    <article class="command-card">
+      <header><span>Rà soát test</span><button class="clip-btn" data-clip="/skill:test-audit rà soát test của module thanh toán">Lấy lệnh</button></header>
+      <pre><code>/skill:test-audit rà soát test của module thanh toán</code></pre>
+      <p>Skill <span class="inline-code">test-audit</span> đi kèm Piagent: chặn test mới không bảo vệ hành vi nào, tìm test trùng, test bám vào cách cài đặt và code chỉ tồn tại để phục vụ test. Agent tự dùng khi viết hay sửa test; gõ lệnh trên để rà cả một vùng.</p>
+    </article>
+    <article class="command-card">
+      <header><span>Vòng thử nghiệm</span><button class="clip-btn" data-clip="git switch -c experiment/toc-do-test">Lấy lệnh</button></header>
+      <pre><code>git switch -c experiment/toc-do-test</code></pre>
+      <p>Nếu cài thêm package có vòng thử nghiệm tự động (<span class="inline-code">run_experiment</span>, <span class="inline-code">log_experiment</span>): guard kiểm lệnh thử như mọi lệnh shell, và chỉ cho vòng lặp chạy trên nhánh <span class="inline-code">experiment/</span> hoặc worktree riêng, bắt đầu khi không còn thay đổi chưa commit, vì mỗi lần bỏ một ý tưởng nó xóa mọi thay đổi chưa commit.</p>
+    </article>
   </div>
 </section>