@heyai-rules/pilo-masterkit 2.1.0 → 3.1.0

package/.agent/workflows/checkpoint.md

@@ -1,74 +1,74 @@
-# Checkpoint Command
-
-Create or verify a checkpoint in your workflow.
-
-## Usage
-
-`/checkpoint [create|verify|list] [name]`
-
-## Create Checkpoint
-
-When creating a checkpoint:
-
-1. Run `/verify quick` to ensure current state is clean
-2. Create a git stash or commit with checkpoint name
-3. Log checkpoint to `.claude/checkpoints.log`:
-
-```bash
-echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log
-```
-
-4. Report checkpoint created
-
-## Verify Checkpoint
-
-When verifying against a checkpoint:
-
-1. Read checkpoint from log
-2. Compare current state to checkpoint:
-   - Files added since checkpoint
-   - Files modified since checkpoint
-   - Test pass rate now vs then
-   - Coverage now vs then
-
-3. Report:
-```
-CHECKPOINT COMPARISON: $NAME
-============================
-Files changed: X
-Tests: +Y passed / -Z failed
-Coverage: +X% / -Y%
-Build: [PASS/FAIL]
-```
-
-## List Checkpoints
-
-Show all checkpoints with:
-- Name
-- Timestamp
-- Git SHA
-- Status (current, behind, ahead)
-
-## Workflow
-
-Typical checkpoint flow:
-
-```
-[Start] --> /checkpoint create "feature-start"
-   |
-[Implement] --> /checkpoint create "core-done"
-   |
-[Test] --> /checkpoint verify "core-done"
-   |
-[Refactor] --> /checkpoint create "refactor-done"
-   |
-[PR] --> /checkpoint verify "feature-start"
-```
-
-## Arguments
-
-$ARGUMENTS:
-- `create <name>` - Create named checkpoint
-- `verify <name>` - Verify against named checkpoint
-- `list` - Show all checkpoints
-- `clear` - Remove old checkpoints (keeps last 5)
+# Checkpoint Command
+
+Create or verify a checkpoint in your workflow.
+
+## Usage
+
+`/checkpoint [create|verify|list] [name]`
+
+## Create Checkpoint
+
+When creating a checkpoint:
+
+1. Run `/verify quick` to ensure current state is clean
+2. Create a git stash or commit with checkpoint name
+3. Log checkpoint to `.claude/checkpoints.log`:
+
+```bash
+echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log
+```
+
+4. Report checkpoint created
+
+## Verify Checkpoint
+
+When verifying against a checkpoint:
+
+1. Read checkpoint from log
+2. Compare current state to checkpoint:
+   - Files added since checkpoint
+   - Files modified since checkpoint
+   - Test pass rate now vs then
+   - Coverage now vs then
+
+3. Report:
+```
+CHECKPOINT COMPARISON: $NAME
+============================
+Files changed: X
+Tests: +Y passed / -Z failed
+Coverage: +X% / -Y%
+Build: [PASS/FAIL]
+```
+
+## List Checkpoints
+
+Show all checkpoints with:
+- Name
+- Timestamp
+- Git SHA
+- Status (current, behind, ahead)
+
+## Workflow
+
+Typical checkpoint flow:
+
+```
+[Start] --> /checkpoint create "feature-start"
+   |
+[Implement] --> /checkpoint create "core-done"
+   |
+[Test] --> /checkpoint verify "core-done"
+   |
+[Refactor] --> /checkpoint create "refactor-done"
+   |
+[PR] --> /checkpoint verify "feature-start"
+```
+
+## Arguments
+
+$ARGUMENTS:
+- `create <name>` - Create named checkpoint
+- `verify <name>` - Verify against named checkpoint
+- `list` - Show all checkpoints
+- `clear` - Remove old checkpoints (keeps last 5)

package/.agent/workflows/claw.md

@@ -1,23 +1,23 @@
----
-description: Legacy slash-entry shim for the nanoclaw-repl skill. Prefer the skill directly.
----
-
-# Claw Command (Legacy Shim)
-
-Use this only if you still reach for `/claw` from muscle memory. The maintained implementation lives in `skills/nanoclaw-repl/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `nanoclaw-repl` skill directly.
-- Keep this file only as a compatibility entry point while command-first usage is retired.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `nanoclaw-repl` skill and keep the response focused on operating or extending `scripts/claw.js`.
-- If the user wants to run it, use `node scripts/claw.js` or `npm run claw`.
-- If the user wants to extend it, preserve the zero-dependency and markdown-backed session model.
-- If the request is really about long-running orchestration rather than NanoClaw itself, redirect to `dmux-workflows` or `autonomous-agent-harness`.
+---
+description: Legacy slash-entry shim for the nanoclaw-repl skill. Prefer the skill directly.
+---
+
+# Claw Command (Legacy Shim)
+
+Use this only if you still reach for `/claw` from muscle memory. The maintained implementation lives in `skills/nanoclaw-repl/SKILL.md`.
+
+## Canonical Surface
+
+- Prefer the `nanoclaw-repl` skill directly.
+- Keep this file only as a compatibility entry point while command-first usage is retired.
+
+## Arguments
+
+`$ARGUMENTS`
+
+## Delegation
+
+Apply the `nanoclaw-repl` skill and keep the response focused on operating or extending `scripts/claw.js`.
+- If the user wants to run it, use `node scripts/claw.js` or `npm run claw`.
+- If the user wants to extend it, preserve the zero-dependency and markdown-backed session model.
+- If the request is really about long-running orchestration rather than NanoClaw itself, redirect to `dmux-workflows` or `autonomous-agent-harness`.

package/.agent/workflows/clean-memory.md

@@ -1,34 +1,34 @@
----
-description: Chiến lược Quản trị Tri thức & Dọn dẹp Ngữ cảnh toàn diện cho AI Agent.
----
-
-# 🧠 Knowledge Distillation & Memory Hygiene Protocol
-
-Quy mô dự án càng lớn, AI càng dễ bị "nhiễu" bởi các log cũ và các bước thực thi rườm rà. Workflow này không chỉ xóa dữ liệu, mà là quá trình **TỔNG HỢP** tri thức để giữ cho AI luôn thực tế và nhạy bén.
-
-## 1. Giai đoạn Quét tri thức (Knowledge Sweep)
-Agent phải rà soát toàn bộ các nguồn dữ liệu đang "phình to":
-- **Tasks**: Toàn bộ file trong `.agent/tasks/` (Tìm các task đã `DONE` nhưng chưa được tổng hợp kết quả).
-- **Session Memory**: Tệp `session_memory.md` hoặc các tệp ghi chép nháp.
-- **Workflow Logs**: Các kết quả thực thi lệnh slash trước đó.
-
-## 2. Giai đoạn Chắt lọc tinh hoa (Synthesis & Extraction)
-Thay vì xóa bỏ, Agent phải **TRÍCH XUẤT** các giá trị vĩnh viễn:
-- **ADRs**: Các quyết định kiến trúc quan trọng phải được chuyển vào `PROJECT_MAP.md`.
-- **Instincts**: Các quy tắc làm việc mới "học" được từ lỗi sai phải được chuyển vào `PILO_MASTER.md` hoặc `.agent/rules/`.
-- **State Compression**: Tóm lược 10 bước làm việc thành 1 dòng trạng thái duy nhất ("Ví dụ: Đã hoàn thành refactor module X, cấu trúc hiện tại là Y").
-
-## 3. Giai đoạn Thực thi Làm sạch (Atomic Pruning)
-Sau khi đã cất giữ tinh hoa vào các file "não bộ" (`PROJECT_MAP.md`, `PILO_MASTER.md`), Agent mới được phép:
-- Lưu trữ (Archive) hoặc xóa bỏ các task cũ đã hoàn thành.
-- Làm sạch các log thừa trong terminal hoặc file tạm.
-- Cắt tỉa các tệp memory để chỉ giữ lại **Ngữ cảnh hiện tại (Current Status)** và **Mục tiêu tiếp theo (Next Goal)**.
-
-## 4. Xác nhận & Báo cáo
-Agent báo cáo lại:
-- `Synthesized`: Những tri thức mới nào đã được đưa vào bản đồ dự án?
-- `Pruned`: Đã xóa bỏ bao nhiêu KB/Dòng dữ liệu dư thừa?
-- `Ready`: Xác nhận ngữ cảnh hiện tại đã "sạch" và tập trung vào mục tiêu mới.
-
----
-> **Triết lý**: Đừng chỉ xóa đi quá khứ, hãy biến nó thành kinh nghiệm để tối ưu tương lai.
+---
+description: Chiến lược Quản trị Tri thức & Dọn dẹp Ngữ cảnh toàn diện cho AI Agent.
+---
+
+# 🧠 Knowledge Distillation & Memory Hygiene Protocol
+
+Quy mô dự án càng lớn, AI càng dễ bị "nhiễu" bởi các log cũ và các bước thực thi rườm rà. Workflow này không chỉ xóa dữ liệu, mà là quá trình **TỔNG HỢP** tri thức để giữ cho AI luôn thực tế và nhạy bén.
+
+## 1. Giai đoạn Quét tri thức (Knowledge Sweep)
+Agent phải rà soát toàn bộ các nguồn dữ liệu đang "phình to":
+- **Tasks**: Toàn bộ file trong `.agent/tasks/` (Tìm các task đã `DONE` nhưng chưa được tổng hợp kết quả).
+- **Session Memory**: Tệp `session_memory.md` hoặc các tệp ghi chép nháp.
+- **Workflow Logs**: Các kết quả thực thi lệnh slash trước đó.
+
+## 2. Giai đoạn Chắt lọc tinh hoa (Synthesis & Extraction)
+Thay vì xóa bỏ, Agent phải **TRÍCH XUẤT** các giá trị vĩnh viễn:
+- **ADRs**: Các quyết định kiến trúc quan trọng phải được chuyển vào `PROJECT_MAP.md`.
+- **Instincts**: Các quy tắc làm việc mới "học" được từ lỗi sai phải được chuyển vào `PILO_MASTER.md` hoặc `.agent/rules/`.
+- **State Compression**: Tóm lược 10 bước làm việc thành 1 dòng trạng thái duy nhất ("Ví dụ: Đã hoàn thành refactor module X, cấu trúc hiện tại là Y").
+
+## 3. Giai đoạn Thực thi Làm sạch (Atomic Pruning)
+Sau khi đã cất giữ tinh hoa vào các file "não bộ" (`PROJECT_MAP.md`, `PILO_MASTER.md`), Agent mới được phép:
+- Lưu trữ (Archive) hoặc xóa bỏ các task cũ đã hoàn thành.
+- Làm sạch các log thừa trong terminal hoặc file tạm.
+- Cắt tỉa các tệp memory để chỉ giữ lại **Ngữ cảnh hiện tại (Current Status)** và **Mục tiêu tiếp theo (Next Goal)**.
+
+## 4. Xác nhận & Báo cáo
+Agent báo cáo lại:
+- `Synthesized`: Những tri thức mới nào đã được đưa vào bản đồ dự án?
+- `Pruned`: Đã xóa bỏ bao nhiêu KB/Dòng dữ liệu dư thừa?
+- `Ready`: Xác nhận ngữ cảnh hiện tại đã "sạch" và tập trung vào mục tiêu mới.
+
+---
+> **Triết lý**: Đừng chỉ xóa đi quá khứ, hãy biến nó thành kinh nghiệm để tối ưu tương lai.