@tekmidian/pai 0.3.0 → 0.3.1

package/FEATURE.md

@@ -1,7 +1,3 @@
----
-links: "[[Ideaverse/AI/PAI/PAI|PAI]]"
----
-
 # PAI Feature Comparison
 
 ## Credit
@@ -117,6 +113,3 @@ Code to remember everything across sessions, use this.
 
 They're not mutually exclusive. Fabric handles one-shot prompt workflows. PAI Knowledge OS
 handles persistent memory for Claude Code. Many people will want both.
-
----
-*Links:* [[Ideaverse/AI/PAI/PAI|PAI]]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekmidian/pai",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "PAI Knowledge OS — Personal AI Infrastructure with federated memory and project management",
   "type": "module",
   "main": "dist/index.mjs",

package/templates/README.md

@@ -1,7 +1,3 @@
----
-links: "[[Ideaverse/AI/PAI/templates/templates|templates]]"
----
-
 # PAI Configuration Templates
 
 This directory contains example configuration files for personalizing your PAI Knowledge OS setup.
@@ -183,6 +179,3 @@ Once you've customized the basic templates, you can:
 ---
 
 **Template Version**: 1.0
-
----
-*Links:* [[Ideaverse/AI/PAI/templates/templates|templates]]

package/templates/agent-prefs.example.md

@@ -1,7 +1,3 @@
----
-links: "[[Ideaverse/AI/PAI/templates/templates|templates]]"
----
-
 # PAI Agent Preferences (Personal Configuration)
 
 Copy this file to `~/.config/pai/agent-prefs.md` and customize for your workflow. This file is **NOT** committed to any repository and contains your personal preferences.
@@ -364,6 +360,3 @@ A: `.claude.json` is for Claude Code and MCP server configuration. This file is
 
 **Q: What if I delete this file?**
 A: PAI will use defaults. You can always recreate it from this template.
-
----
-*Links:* [[Ideaverse/AI/PAI/templates/templates|templates]]

package/templates/claude-md.template.md

@@ -1,7 +1,3 @@
----
-links: "[[Ideaverse/AI/PAI/templates/templates|templates]]"
----
-
 # CLAUDE.md - PAI Global Configuration
 <!-- Generated by PAI Setup — Do not edit directly. Run `pai setup` to regenerate. -->
 <!-- Personal preferences and project mappings are read from ~/.config/pai/agent-prefs.md -->
@@ -735,6 +731,3 @@ For personal preferences (notification channels, voice settings, agent defaults)
 13. **Task management** - plan to tasks/todo.md first, track progress, document results
 
 This is constitutional. Violations waste time, money, and context.
-
----
-*Links:* [[Ideaverse/AI/PAI/templates/templates|templates]]

package/templates/pai-project.template.md

@@ -1,11 +1,13 @@
 ---
-links: "[[Ideaverse/AI/PAI/templates/templates|templates]]"
+pai:
+  slug: "${SLUG}"
+  registered: "${DATE}"
+  last_indexed: null
+  status: active
 ---
+
 # ${DISPLAY_NAME}
 
 <!-- Everything below the YAML frontmatter is yours — PAI never modifies content here. -->
 <!-- Use this file for project notes, decisions, preferences, or anything you want. -->
 <!-- PAI only reads and updates the `pai:` block in the frontmatter above. -->
-
----
-*Links:* [[Ideaverse/AI/PAI/templates/templates|templates]]

package/templates/pai-skill.template.md

@@ -5,16 +5,38 @@ description: PAI session lifecycle automation. USE WHEN user says "go", "continu
 
 <!-- Generated by PAI Setup -->
 
+## RESPONSE MODE CLASSIFICATION (Always Active)
+
+**Classify EVERY request into one of three modes BEFORE emitting any response token.**
+
+| Mode | When | Format |
+|------|------|--------|
+| **MINIMAL** | Greetings, thanks, acks, simple yes/no, one-word answers | Natural conversational response. No structured format. 1-3 sentences max. |
+| **STANDARD** | Single-step tasks, quick lookups, simple file reads, direct questions | Compact: just answer the question directly. |
+| **FULL** | Multi-step work, research, implementation, analysis, 3+ tool calls | Full structured format with SUMMARY/ANALYSIS/ACTIONS/RESULTS/STATUS/NEXT. |
+
+**Decision rule:** If you can answer in under 3 sentences without tools → MINIMAL. If it's one action or lookup → STANDARD. Everything else → FULL.
+
+---
+
 ## TOKEN MONITORING (Always Active)
 
 **Token Limit:** ~200k total context window
 **Auto-Reset Threshold:** ~100k tokens (50%)
 
-**After major actions, estimate token usage:**
-- Each file read ≈ 1-3k tokens
-- Each file written/edited ≈ 0.5-2k tokens
-- Each user message + response ≈ 2-5k tokens
-- Large search results ≈ 2-5k tokens
+### Proactive Context Management
+
+**After every 5+ sequential tool calls, PAUSE and self-assess:**
+1. Estimate current context usage (each file read ≈ 1-3k, edit ≈ 0.5-2k, message+response ≈ 2-5k, search results ≈ 2-5k)
+2. If estimated usage > 60% of window (~120k tokens): **self-summarize before continuing**
+   - **Preserve:** key decisions, numbers, code references, file paths, next actions
+   - **Discard:** verbose tool output, intermediate reasoning, raw search results
+   - Write a 1-3 paragraph summary replacing prior phase content
+3. If > 80%: consider whether to checkpoint and suggest `/clear`
+
+**This is proactive, not reactive.** Don't wait for auto-compact to surprise you. Manage context like a budget.
+
+### Auto-Reset Protocol
 
 **When approaching ~100k tokens, initiate AUTO-RESET:**
 
@@ -77,6 +99,28 @@ The GDPR requires consent for processing personal data ([GDPR Art. 6](https://gd
 
 ---
 
+## ANTI-CRITERIA IN PLANNING (Always Active)
+
+**When planning non-trivial work, define what MUST NOT happen alongside what must happen.**
+
+- Prefix negative requirements with `ISC-A` (Anti-Criteria): `ISC-A1: No personal data in exported files`
+- Anti-criteria are first-class verifiable requirements — verify them in the same pass as positive criteria
+- Common anti-criteria: no regressions, no secrets in commits, no breaking changes to public API, no data loss
+
+---
+
+## INVOCATION OBLIGATION (Always Active)
+
+**If you mention a tool or capability during planning, you MUST actually invoke it.**
+
+- Listing a capability but never calling it via tool is dishonest — it's "capability theater."
+- If you say "let me search for that" → you MUST call a search tool. Don't generate from memory.
+- If you plan to use a skill → you MUST call the Skill tool. Don't simulate the output.
+- If you decide NOT to use a planned capability → explicitly state why: "Skipping X because Y."
+- At the end of multi-step work, verify: every tool/skill you mentioned was either invoked or explicitly declined.
+
+---
+
 ## GIT COMMIT RULES (Always Active)
 
 **MANDATORY FOR ALL COMMITS:**
@@ -292,4 +336,93 @@ Session notes are stored in: `~/.claude/projects/{encoded-cwd}/Notes/` or local
 
 ---
 
-**This skill is installed by `pai setup`. For personal customization (identity, personality, response format, notification preferences), create your own skill in `~/.claude/skills/`.**
+## DELEGATION & PARALLELIZATION (Always Active)
+
+**Whenever a task can be parallelized, use multiple agents.**
+
+### Model Selection for Agents
+
+| Task Type | Model | Why |
+|-----------|-------|-----|
+| Deep reasoning, complex architecture | `opus` | Maximum intelligence needed |
+| Standard implementation, most coding | `sonnet` | Good balance of speed + capability |
+| Simple lookups, quick checks, grunt work | `haiku` | 10-20x faster, sufficient intelligence |
+
+**Rule of Thumb:**
+- Grunt work or verification → `haiku`
+- Implementation or research → `sonnet`
+- Deep strategic thinking → `opus`
+
+### How to Parallelize
+
+- Use a SINGLE message with MULTIPLE Agent/Task tool calls = parallel execution
+- Each agent gets FULL CONTEXT and DETAILED INSTRUCTIONS
+- **ALWAYS launch a spotcheck agent after parallel work completes**
+
+### Context Conservation
+
+Bulk/repetitive work consumes context. Delegate it to conserve your main conversation space for planning and decisions.
+
+**When to delegate:** Updating many files, batch refactoring, repetitive transformations, large-scale testing, batch file operations.
+
+**Pattern:**
+1. Plan the work in main conversation
+2. Delegate to agent(s) with detailed instructions
+3. Agent executes bulk changes efficiently
+4. Review results and iterate if needed
+5. Main conversation remains lean and focused
+
+---
+
+## STACK PREFERENCES (Always Active)
+
+- **TypeScript > Python** — Use TypeScript unless explicitly told otherwise
+- **Package managers:** bun for JS/TS (NOT npm/yarn/pnpm), uv for Python (NOT pip)
+- **Markdown > HTML:** Never use HTML tags for basic content
+- **Analysis vs Action:** If asked to analyze, do analysis only — don't change things unless asked
+
+---
+
+## FILE ORGANIZATION (Always Active)
+
+- **Scratchpad** (`${PAI_DIR}/scratchpad/`) — Temporary files only. Delete when done.
+- **History** (`${PAI_DIR}/History/`) — Permanent valuable outputs.
+- **Backups** (`${PAI_DIR}/History/backups/`) — All backups go here, NEVER inside skill directories.
+
+**Rules:**
+- Save valuable work to history, not scratchpad
+- Never create `backups/` directories inside skills
+- Never use `.bak` suffixes
+
+---
+
+## HISTORY SYSTEM — Past Work Lookup (Always Active)
+
+**When the user asks about anything done in the past, check the history system first.**
+
+The history system at `${PAI_DIR}/History/` contains all past work — sessions, learnings, research, decisions.
+
+### How to Search History
+
+```bash
+# Quick keyword search across all history
+rg -i "keyword" ${PAI_DIR}/History/
+
+# Search sessions specifically
+rg -i "keyword" ${PAI_DIR}/History/sessions/
+
+# List recent files
+ls -lt ${PAI_DIR}/History/sessions/ | head -20
+```
+
+### Directory Quick Reference
+
+| What you're looking for | Where to search |
+|------------------------|-----------------|
+| Session summaries | `History/sessions/YYYY-MM/` |
+| Problem-solving narratives | `History/learnings/YYYY-MM/` |
+| Research & investigations | `History/research/YYYY-MM/` |
+
+---
+
+**This skill is installed by `pai setup`. For personal customization (identity, personality, notification preferences), create your own skill in `~/.claude/skills/`.**