waypoint-skills 1.3.0

package/packages/rules/serial-git-enforcement.mdc

@@ -0,0 +1,77 @@
+---
+description: Serial git enforcement for mission workers — one active writer per git worktree, verified clean codebase between sub-tasks. Multi-instance parallelism allowed when each mid has a distinct worktree_root.
+alwaysApply: true
+---
+
+# Serial Git Enforcement
+
+1. **No Concurrent Edits per worktree:** Only one Worker or Validator may mutate a given `worktree_root` at any moment. Parallel execution is allowed across **distinct worktrees** (different `mid` values).
+2. **Clean Slate Principle:** Every worker must inherit a verified codebase from the previous worker **in the same worktree**.
+
+## Instance Context (v1.3)
+
+| Field | Role |
+|-------|------|
+| `mid` | Mission instance id |
+| `worktree_root` | Git working tree for code edits |
+| `wp_root` | `.wp/instances/<mid>/` — plan/handoffs (not code) |
+
+Workers and validators run `git status` in `worktree_root`, not `project_root`, unless they are the same path (`default` mid).
+
+## Worker Start Checklist
+
+Before Execute phase (in `worktree_root`):
+
+```bash
+cd "$worktree_root"
+git status --porcelain   # must be empty OR only expected task files
+git stash list           # note any stashes — do not inherit hidden state
+```
+
+- **Empty tree required** unless the in-progress task explicitly owns the current diff
+- Stray edits from a prior task in the same worktree → stop, commit/revert/stash with orchestrator approval
+- Stray edits in a **different** worktree → not this worker's concern; do not touch
+
+## Worker End Checklist
+
+Before handoff (in `worktree_root`):
+
+```bash
+cd "$worktree_root"
+git status --porcelain   # only files in task scope
+git diff --stat          # matches handoff "Implemented" section
+```
+
+Handoff must include `git:` and `worktree:` fields. Validator inherits the same worktree + scoped diff.
+
+## Concurrency Matrix
+
+| Operation | Parallel OK? |
+|-----------|----------------|
+| Grep, Read, glob, docs, reviews | Yes |
+| Write/Edit in **different** worktrees (different `mid`) | Yes |
+| Write/Edit in the **same** worktree | No — one active editor |
+| Orchestrator plan/contract writes (wp_root only) | Yes — no app code |
+| Two workers, same `worktree_root` | **No** — halt both |
+
+## Multi-Worktree Parallelism
+
+When framework v1.3 provisions git worktrees per `mid`:
+
+```
+project_root:     /path/HerbalTech
+worktree A:       /path/HerbalTech-missions/api-payments   (mid: api-payments)
+worktree B:       /path/HerbalTech-missions/web-checkout   (mid: web-checkout)
+```
+
+Worker A and Worker B may run simultaneously. Each must stay in its own `worktree_root`.
+
+Shared `.wp/` state (via symlink in worktree) is updated by orchestrator/bookkeeping sequentially per `mid` — not by workers directly.
+
+## Violations
+
+- Two workers editing the **same** worktree → halt both; orchestrator re-serializes plan for that `mid`
+- Worker edits `project_root` when `worktree_root` differs → validator BLOCK
+- Uncommitted stray changes at worker start → worker blocked until tree is clean
+- Handoff with undeclared local changes → validator treats as **fail**
+- Validator reads handoffs from wrong `mid` → BLOCK (cross-instance contamination)

package/packages/skills/caveman/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman
+  while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra,
+  wenyan-lite, wenyan-full, wenyan-ultra.
+  Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens",
+  "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift. Still active if unsure. Off only: "stop caveman" / "normal mode".
+
+Default: **full**. Switch: `/caveman lite|full|ultra`.
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). No tool-call narration, no decorative tables/emoji, no dumping long raw error logs unless asked — quote shortest decisive line. Standard well-known tech acronyms OK (DB/API/HTTP); never invent new abbreviations reader can't decode. Technical terms exact. Code blocks unchanged. Errors quoted exact.
+
+Preserve user's dominant language. User write Portuguese → reply Portuguese caveman. User write Spanish → reply Spanish caveman. Compress the style, not the language. No forced English openings or status phrases. ALWAYS keep technical terms, code, API names, CLI commands, commit-type keywords (feat/fix/...), and exact error strings verbatim — unless user explicitly ask for translation.
+
+No self-reference. Never name or announce the style. No "caveman mode on", "me caveman think", no third-person caveman tags. Output caveman-only — never normal answer plus "Caveman:" recap. Exception: user explicitly ask what the mode is.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+## Intensity
+
+| Level | What change |
+|-------|------------|
+| **lite** | No filler/hedging. Keep articles + full sentences. Professional but tight |
+| **full** | Drop articles, fragments OK, short synonyms. Classic caveman. No tool-call narration, no decorative tables/emoji, no long raw error-log dumps unless asked. Standard acronyms OK; no invented abbreviations |
+| **ultra** | Abbreviate prose words (DB/auth/config/req/res/fn/impl) — prose words only, never real code symbols/function names. Strip conjunctions, arrows for causality (X → Y), one word when one word enough. Code symbols, function names, API names, error strings: never abbreviate |
+| **wenyan-lite** | Semi-classical. Drop filler/hedging but keep grammar structure, classical register |
+| **wenyan-full** | Maximum classical terseness. Fully 文言文. 80-90% character reduction. Classical sentence patterns, verbs precede objects, subjects often omitted, classical particles (之/乃/為/其) |
+| **wenyan-ultra** | Extreme abbreviation while keeping classical Chinese feel. Maximum compression, ultra terse |
+
+Example — "Why React component re-render?"
+- lite: "Your component re-renders because you create a new object reference each render. Wrap it in `useMemo`."
+- full: "New object ref each render. Inline object prop = new ref = re-render. Wrap in `useMemo`."
+- ultra: "Inline obj prop → new ref → re-render. `useMemo`."
+- wenyan-lite: "組件頻重繪，以每繪新生對象參照故。以 useMemo 包之。"
+- wenyan-full: "每繪新生對象參照，故重繪；以 useMemo 包之則免。"
+- wenyan-ultra: "新參照→重繪。useMemo Wrap。"
+
+Example — "Explain database connection pooling."
+- lite: "Connection pooling reuses open connections instead of creating new ones per request. Avoids repeated handshake overhead."
+- full: "Pool reuse open DB connections. No new connection per request. Skip handshake overhead."
+- ultra: "Pool = reuse DB conn. Skip handshake → fast under load."
+- wenyan-full: "池reuse open connection。不每req新開。skip handshake overhead。"
+- wenyan-ultra: "池reuse conn。skip handshake → fast。"
+
+## Auto-Clarity
+
+Drop caveman when:
+- Security warnings
+- Irreversible action confirmations
+- Multi-step sequences where fragment order or omitted conjunctions risk misread
+- Compression itself creates technical ambiguity (e.g., `"migrate table drop column backup first"` — order unclear without articles/conjunctions)
+- User asks to clarify or repeats question
+
+Resume caveman after clear part done.
+
+Example — destructive op:
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+> ```sql
+> DROP TABLE users;
+> ```
+> Caveman resume. Verify backup exist first.
+
+## Boundaries
+
+Code/commits/PRs: write normal. "stop caveman" or "normal mode": revert. Level persist until changed or session end.