@fr0mpy/prompt-system 2.0.0

package/templates/hooks/triggers.json

@@ -0,0 +1,174 @@
+{
+  "code": [
+    "create",
+    "build",
+    "make",
+    "add",
+    "implement",
+    "write",
+    "new",
+    "generate",
+    "component",
+    "hook",
+    "util",
+    "service",
+    "function",
+    "screen",
+    "class",
+    "module",
+    "button",
+    "card",
+    "input",
+    "modal",
+    "form",
+    "api",
+    "handler",
+    "code"
+  ],
+  "package": [
+    "install",
+    "package",
+    "npm",
+    "yarn",
+    "pnpm",
+    "dependency",
+    "dependencies",
+    "upgrade",
+    "update package"
+  ],
+  "structure": [
+    "directory",
+    "folder",
+    "mkdir",
+    "structure",
+    "move",
+    "rename",
+    "reorganize",
+    "refactor structure",
+    "file structure"
+  ],
+  "rules": [
+    "rule",
+    "rules",
+    "claude rule",
+    "add rule",
+    "create rule",
+    "update rule",
+    "modify rule"
+  ],
+  "subagent": [
+    "subagent",
+    "sub agent",
+    "agent",
+    "create agent",
+    "add agent",
+    "new agent"
+  ],
+  "command": [
+    "command",
+    "slash command",
+    "create command",
+    "add command",
+    "new command"
+  ],
+  "planning": [
+    "plan",
+    "design",
+    "architect",
+    "approach",
+    "strategy",
+    "how should",
+    "what if",
+    "decide",
+    "choose between"
+  ],
+  "review": [
+    "review",
+    "check",
+    "audit",
+    "analyze",
+    "assess",
+    "evaluate",
+    "look at",
+    "examine"
+  ],
+  "debug": [
+    "debug",
+    "error",
+    "bug",
+    "fix",
+    "broken",
+    "not working",
+    "failing",
+    "crash",
+    "issue",
+    "problem"
+  ],
+  "refactor": [
+    "refactor",
+    "simplify",
+    "clean up",
+    "improve",
+    "optimize",
+    "rewrite",
+    "restructure"
+  ],
+  "test": [
+    "test",
+    "testing",
+    "coverage",
+    "spec",
+    "unit test",
+    "integration test",
+    "e2e"
+  ],
+  "pr": [
+    "pull request",
+    "pr",
+    "merge",
+    "commit",
+    "git"
+  ],
+  "migration": [
+    "migrate",
+    "migration",
+    "upgrade",
+    "schema",
+    "database change",
+    "api version"
+  ],
+  "performance": [
+    "performance",
+    "slow",
+    "fast",
+    "optimize",
+    "speed",
+    "memory",
+    "render"
+  ],
+  "accessibility": [
+    "accessibility",
+    "a11y",
+    "screen reader",
+    "aria",
+    "wcag",
+    "keyboard"
+  ],
+  "session": [
+    "handoff",
+    "continue later",
+    "save progress",
+    "end session",
+    "wrap up",
+    "context"
+  ],
+  "thinking": [
+    "stuck",
+    "confused",
+    "help me think",
+    "rubber duck",
+    "talk through",
+    "explain my problem"
+  ],
+  "_comment": "Add new triggers here. Extension triggers in triggers.d/ are merged at runtime."
+}

package/templates/rules/agent-lifecycle-messages.md

@@ -0,0 +1,77 @@
+<!-- SUMMARY: Output clear feedback at each stage of agent delegation -->
+<!-- TRIGGER: always -->
+# RULE: Agent Lifecycle Messages
+
+⚠️ **ALWAYS-ACTIVE RULE** - Apply to ALL agent delegations.
+
+## 🔐 Enforcement
+
+**When delegating to an agent, you MUST:**
+1. Announce delegation with purpose
+2. Show context being passed
+3. Report completion with findings
+4. Confirm return to main context
+
+---
+
+## Message Format
+
+### Delegating
+```
+🚀 DELEGATING: [agent-name]
+   Purpose: [why needed]
+   ⏳ [action in progress]...
+```
+
+### Context Passed
+```
+📥 CONTEXT → [agent-name]:
+   • Scope: [files/dirs]
+   • Looking for: [patterns]
+   • Intent: [user goal]
+```
+
+### Agent Complete
+```
+✅ COMPLETE: [agent-name]
+   📊 Result: [found/not-found/partial]
+   📤 Findings:
+      • [finding 1]
+      • [finding 2]
+   💡 Next: [recommendation]
+```
+
+### Returning
+```
+🔄 RETURNING TO MAIN CONTEXT
+   Proceeding: [next action]
+```
+
+### Skipped
+```
+⏭️ SKIP: [agent-name] (already ran)
+   Cached: [key finding]
+```
+
+### Blocked
+```
+⚠️ BLOCKED: [agent-name]
+   Issue: [problem]
+   Fallback: [alternative]
+```
+
+---
+
+## Quick Reference
+
+| Stage | Emoji | When |
+|-------|-------|------|
+| Delegating | 🚀 | Starting agent |
+| Context | 📥 | Passing info |
+| Working | ⏳ | Agent processing |
+| Complete | ✅ | Agent done |
+| Findings | 📤 | What was found |
+| Next | 💡 | Recommendation |
+| Return | 🔄 | Back to main |
+| Skip | ⏭️ | Already ran |
+| Blocked | ⚠️ | Can't complete |

package/templates/rules/announce-actions.md

@@ -0,0 +1,58 @@
+<!-- SUMMARY: Announce actions, track agent usage, prevent duplicates -->
+<!-- TRIGGER: always -->
+# RULE: Announce Actions
+
+## 🔐 Enforcement
+
+**For every operation, you MUST:**
+1. Announce action before starting
+2. Use lifecycle messages for agents (see agent-lifecycle-messages rule)
+3. Report results with specific details
+4. **NEVER run the same agent twice in one prompt**
+
+---
+
+## Action Messages
+
+```
+🔧 ACTION: [what you're doing]
+✅ DONE: [specific result]
+❌ FAILED: [what went wrong]
+```
+
+---
+
+## Agent Deduplication
+
+⚠️ **CRITICAL**: Each agent runs ONCE per user prompt, max.
+
+Before invoking:
+- Check if already used this turn
+- If ran → use cached findings
+- Output skip message with cached result
+
+---
+
+## Quick Reference
+
+| Event | Format |
+|-------|--------|
+| Starting action | `🔧 ACTION: [what]` |
+| Delegating | `🚀 DELEGATING: [agent]` |
+| Context passed | `📥 CONTEXT → [agent]` |
+| Agent done | `✅ COMPLETE: [agent]` |
+| Returning | `🔄 RETURNING TO MAIN` |
+| Skipping | `⏭️ SKIP: [agent] (cached)` |
+| Action done | `✅ DONE: [result]` |
+| Failed | `❌ FAILED: [reason]` |
+
+---
+
+## Agent Triggers
+
+| Trigger | Agent | When |
+|---------|-------|------|
+| Creating code | `pre-code-check` | BEFORE writing |
+| Installing packages | `package-checker` | BEFORE installing |
+| File operations | `structure-validator` | AFTER creating |
+| Session start | `context-loader` | On stale context |

package/templates/rules/code-standards.md

@@ -0,0 +1,74 @@
+<!-- SUMMARY: Dynamic, scalable code - no hardcoding, discover don't assume -->
+<!-- TRIGGER: code -->
+# RULE: Code Standards - Dynamic & Scalable
+
+⚠️ **ALWAYS-ACTIVE RULE** - Applies to every code generation.
+
+## 🔐 Enforcement
+
+**For EVERY piece of code, you MUST:**
+1. No hardcoded values - use constants/config/theme
+2. Discover structure dynamically - never assume paths exist
+3. Single responsibility per file
+4. Code must work regardless of project size
+
+---
+
+## Dynamic Patterns
+
+| ❌ Hardcoded/Assumed | ✅ Dynamic/Discovered |
+|----------------------|----------------------|
+| `src/components/*.tsx` | Glob for `**/*.tsx`, group by directory |
+| `if (items.length === 3)` | `if (items.length === expectedCount)` |
+| `users[0], users[1]` | `users.map()` or `users.forEach()` |
+| `case 'admin': case 'user':` | `ROLES.includes(role)` |
+| Fixed array indices | Iterate or find by property |
+
+---
+
+## Value Mapping
+
+| ❌ Hardcoded | ✅ Use Instead |
+|--------------|----------------|
+| `'#007AFF'` | `theme.colors.primary` |
+| `padding: 16` | `theme.spacing.md` |
+| `'https://api...'` | `config.API_BASE_URL` |
+| `'Invalid email'` | `MESSAGES.INVALID_EMAIL` |
+| `if (x > 50)` | `if (x > CONFIG.THRESHOLD)` |
+
+---
+
+## Scalability Principles
+
+1. **Discover, don't assume** - Scan for what exists, don't hardcode paths
+2. **Iterate, don't index** - Use `.map()`, `.filter()`, `.find()` not `[0]`, `[1]`
+3. **Configure, don't embed** - Values that might change go in config
+4. **Categorize by pattern** - Group by naming convention, not explicit list
+
+---
+
+## Quick Examples
+
+**File Discovery:**
+```typescript
+// ❌ const screens = ['Home', 'Settings', 'Profile']
+// ✅ const screens = await glob('**/screens/**/*.tsx')
+```
+
+**Iteration:**
+```typescript
+// ❌ processItem(items[0]); processItem(items[1]);
+// ✅ items.forEach(item => processItem(item))
+```
+
+**Role Checks:**
+```typescript
+// ❌ if (role === 'admin' || role === 'superadmin')
+// ✅ if (ELEVATED_ROLES.includes(role))
+```
+
+**Path Building:**
+```typescript
+// ❌ const path = 'src/components/' + name + '.tsx'
+// ✅ const path = join(SRC_DIR, 'components', `${name}.tsx`)
+```

package/templates/rules/command-format.md

@@ -0,0 +1,60 @@
+<!-- SUMMARY: Follow standard format when creating slash commands -->
+<!-- TRIGGER: command -->
+# RULE: Command Format
+
+**ACTIVE RULE** - Apply when creating or modifying slash commands.
+
+## Enforcement
+
+**When creating commands, you MUST:**
+1. Keep prompts short (under 15 lines)
+2. Use numbered steps
+3. Include `$ARGUMENTS` if user input is needed
+4. Place in `.claude/commands/` directory
+
+---
+
+## Template
+
+```markdown
+Brief description of what this command does.
+
+1. First step
+2. Second step
+3. Third step
+
+$ARGUMENTS
+```
+
+---
+
+## Principles
+
+- **Concise** - Commands are prompts, not documentation
+- **Action-oriented** - Each step is a verb
+- **No fluff** - Skip explanations, just list steps
+- **Flexible** - Use `$ARGUMENTS` for user parameters
+
+---
+
+## Examples
+
+**Good:**
+```markdown
+Run tests and fix failures.
+
+1. Detect test runner
+2. Run tests
+3. Fix any failures
+4. Re-run until passing
+
+$ARGUMENTS
+```
+
+**Bad:**
+```markdown
+This command will help you run tests in your project.
+It supports multiple test frameworks including Jest, Vitest, and pytest.
+When tests fail, it will analyze the error messages...
+[too verbose]
+```

package/templates/rules/constructive-pushback.md

@@ -0,0 +1,62 @@
+<!-- SUMMARY: Challenge incorrect assumptions - validate claims before agreeing -->
+<!-- TRIGGER: always -->
+# RULE: Constructive Pushback - Validate Before Agreeing
+
+⚠️ **ALWAYS-ACTIVE RULE** - Apply selectively when user statements need verification.
+
+## Enforcement
+
+**When the user makes a claim or assumption, you MUST:**
+1. Verify accuracy before agreeing - don't reflexively confirm
+2. Push back politely if something is incorrect or suboptimal
+3. Offer the correct information with evidence
+4. Stay silent when the user is correct - no unnecessary friction
+
+---
+
+## When to Push Back
+
+| Situation | Action |
+|-----------|--------|
+| Incorrect technical claim | Correct with evidence |
+| Suboptimal approach | Suggest better alternative |
+| Missing edge case | Point out the gap |
+| Flawed assumption | Question the premise |
+| Misremembered API/syntax | Provide correct usage |
+
+---
+
+## When NOT to Push Back
+
+| Situation | Action |
+|-----------|--------|
+| User is correct | Proceed without comment |
+| Preference/style choice | Respect their choice |
+| Already discussed | Don't repeat yourself |
+| Minor/trivial detail | Let it go |
+| User explicitly chose despite tradeoffs | Honor their decision |
+
+---
+
+## How to Push Back
+
+**Do:**
+- "That approach could cause X issue - consider Y instead"
+- "Actually, that API was deprecated in v3 - the new method is..."
+- "That would work, but there's a simpler way..."
+
+**Don't:**
+- "You're absolutely right!" (when they're not)
+- "Great idea!" (when it's problematic)
+- "Sure, I'll do exactly that" (when you see issues)
+
+---
+
+## Quick Reference
+
+| Bad Pattern | Good Pattern |
+|-------------|--------------|
+| Agreeing to avoid friction | Respectful correction |
+| "Yes, and..." when wrong | "Actually..." with evidence |
+| Silent compliance with bugs | Proactive warning |
+| Over-explaining corrections | Brief, direct feedback |

package/templates/rules/context-passing-protocol.md

@@ -0,0 +1,75 @@
+<!-- SUMMARY: Ensure agents receive and return context correctly -->
+<!-- TRIGGER: always -->
+# RULE: Context Passing Protocol
+
+⚠️ **ALWAYS-ACTIVE RULE** - Apply when delegating to or receiving from agents.
+
+## 🔐 Enforcement
+
+**When delegating, you MUST pass:**
+1. Project type and stack
+2. Relevant file paths/directories
+3. User's stated intent
+4. Specific patterns to search for
+
+**When agent returns, you MUST:**
+1. Acknowledge findings explicitly
+2. State how findings affect your approach
+3. Reference specific files/lines from agent
+
+---
+
+## Outbound Context (Main → Agent)
+
+| Field | Required | Example |
+|-------|----------|---------|
+| Project | Yes | "Next.js 14 + TypeScript" |
+| Scope | Yes | "src/auth/, src/lib/" |
+| Patterns | Yes | "authentication, OAuth, login" |
+| Intent | Yes | "Add Google OAuth login" |
+| Constraints | If any | "Must use existing session utils" |
+
+---
+
+## Inbound Context (Agent → Main)
+
+| Field | Required | Example |
+|-------|----------|---------|
+| Result | Yes | "found" / "not-found" / "partial" |
+| Files | If found | "src/lib/auth.ts:42-68" |
+| Patterns | If found | "useSession hook, JWT validation" |
+| Gaps | If any | "No OAuth provider setup exists" |
+| Recommendation | Yes | "Extend auth.ts, add new oauth.ts" |
+
+---
+
+## Quick Reference
+
+### Pass TO agent:
+```
+📥 CONTEXT → [agent]:
+   • Project: [stack]
+   • Scope: [paths]
+   • Patterns: [keywords]
+   • Intent: [goal]
+```
+
+### Receive FROM agent:
+```
+📤 RECEIVED ← [agent]:
+   • Found: [files:lines]
+   • Patterns: [what exists]
+   • Gaps: [what's missing]
+   • Action: [what to do]
+```
+
+---
+
+## Anti-Patterns
+
+| Don't | Do |
+|-------|-----|
+| "Search the codebase" | "Search src/auth/ for OAuth patterns" |
+| "Found some code" | "Found auth logic at src/lib/auth.ts:42" |
+| "It didn't find anything" | "No OAuth patterns in src/. Will create new." |
+| Skip acknowledgment | Always state how findings change approach |

package/templates/rules/rule-format.md

@@ -0,0 +1,72 @@
+<!-- SUMMARY: Follow standard format when creating or modifying rules -->
+<!-- TRIGGER: rules -->
+# RULE: Rule Format - Standard Structure for All Rules
+
+⚠️ **ALWAYS-ACTIVE RULE** - Apply when creating or modifying any rule file.
+
+## 🔐 Enforcement
+
+**When creating/modifying rules, you MUST:**
+1. Follow the exact template below
+2. Keep content concise - no filler words
+3. Use the metadata comments for hook integration
+
+---
+
+## Template
+
+```markdown
+<!-- SUMMARY: One-line description (max 80 chars) -->
+<!-- TRIGGER: code | package | structure | always -->
+# RULE: Name - Short Description
+
+⚠️ **ALWAYS-ACTIVE RULE** - Brief scope statement.
+
+## 🔐 Enforcement
+
+**[When this triggers], you MUST:**
+1. Step one
+2. Step two
+3. Step three
+
+---
+
+## What to Check
+
+- Bullet point checks
+- Keep actionable
+
+## Quick Reference
+
+| Do | Don't |
+|----|-------|
+| Good example | Bad example |
+```
+
+---
+
+## Metadata Fields
+
+| Field | Values | Purpose |
+|-------|--------|---------|
+| `SUMMARY` | Max 80 chars | Displayed in lightweight mode |
+| `TRIGGER` | `code`, `package`, `structure`, `always` | When hook injects this rule |
+
+---
+
+## Principles
+
+1. **Concise** - No paragraphs explaining why. Just what to do.
+2. **Actionable** - Every line should be a clear instruction.
+3. **Scannable** - Use tables, bullets, code blocks. No walls of text.
+4. **Self-contained** - Rule should work without reading other docs.
+
+---
+
+## Anti-Patterns
+
+❌ Long explanations of "why" this rule exists
+❌ Multiple examples when one suffices
+❌ Repeating the same instruction in different words
+❌ Sections that don't add actionable value
+❌ "Philosophy" or "Background" sections