poly-agent 1.0.4 → 1.0.6

package/dist/cli.js

@@ -90,7 +90,7 @@ async function runInit() {
         cancel('Operation cancelled.');
         process.exit(0);
     }
-    // Step 4: Copy files
+    // Step 4: Install prompts with shared instructions
     const targetDir = IDE_DIRECTORIES[selectedIDE];
     const fullTargetPath = path.join(process.cwd(), targetDir);
     const s = spinner();
@@ -98,9 +98,16 @@ async function runInit() {
     try {
         // Create target directory if it doesn't exist
         await fs.mkdir(fullTargetPath, { recursive: true });
-        // Copy each selected prompt file
-        const copyPromises = selectedPrompts.map(async (filename) => {
-            const sourcePath = path.join(promptsDir, filename);
+        // Install each selected prompt with shared instructions injected
+        const installPromises = selectedPrompts.map(async (filename) => {
+            // Load prompt with shared instructions injected
+            const prompt = await loader.loadPrompt(filename);
+            // Reconstruct the full file content with frontmatter
+            const fullContent = `---
+name: ${prompt.name}
+description: ${prompt.description}
+---
+${prompt.content}`;
             if (selectedIDE === 'Claude') {
                 // For Claude, create a folder with the prompt name and SKILL.md inside
                 const promptName = path.basename(filename, '.md');
@@ -108,23 +115,23 @@ async function runInit() {
                 const skillFilePath = path.join(skillFolderPath, 'SKILL.md');
                 // Create the skill folder
                 await fs.mkdir(skillFolderPath, { recursive: true });
-                // Copy the content to SKILL.md
-                await fs.copyFile(sourcePath, skillFilePath);
+                // Write the processed content to SKILL.md
+                await fs.writeFile(skillFilePath, fullContent, 'utf-8');
                 return `${promptName}/SKILL.md`;
             }
             else {
-                // For other IDEs, copy directly
+                // For other IDEs, write directly
                 const targetPath = path.join(fullTargetPath, filename);
-                await fs.copyFile(sourcePath, targetPath);
+                await fs.writeFile(targetPath, fullContent, 'utf-8');
                 return filename;
             }
         });
-        const copiedFiles = await Promise.all(copyPromises);
-        s.stop(`✓ Installed ${copiedFiles.length} prompt(s) successfully`);
+        const installedFiles = await Promise.all(installPromises);
+        s.stop(`✓ Installed ${installedFiles.length} prompt(s) successfully`);
         // Success message
         log.success(`Prompts installed to: ${targetDir}`);
         log.info(`Installed files:`);
-        copiedFiles.forEach(file => {
+        installedFiles.forEach(file => {
             log.info(`  - ${file}`);
         });
         outro('Installation complete! 🎉');

package/dist/lib/prompt-loader.js

@@ -2,9 +2,60 @@ import fs from 'fs/promises';
 import path from 'path';
 export class PromptLoader {
     promptsDir;
+    sharedInstructionsCache = null;
     constructor(promptsDir) {
         this.promptsDir = promptsDir;
     }
+    /**
+     * Load all shared instructions from the _shared directory.
+     * These will be appended to every prompt.
+     */
+    async loadSharedInstructions() {
+        // Return cached instructions if available
+        if (this.sharedInstructionsCache !== null) {
+            return this.sharedInstructionsCache;
+        }
+        const sharedDir = path.join(this.promptsDir, '_shared');
+        const instructions = [];
+        try {
+            const files = await fs.readdir(sharedDir);
+            const mdFiles = files.filter(f => f.endsWith('.md'));
+            for (const file of mdFiles) {
+                const filePath = path.join(sharedDir, file);
+                const fileContent = await fs.readFile(filePath, 'utf-8');
+                // Parse frontmatter to get name, extract content
+                const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+                const match = fileContent.match(frontmatterRegex);
+                if (match) {
+                    const metadata = this.parseFrontmatter(match[1]);
+                    instructions.push({
+                        name: metadata.name || path.basename(file, '.md'),
+                        content: match[2].trim()
+                    });
+                }
+                else {
+                    // No frontmatter, use entire content
+                    instructions.push({
+                        name: path.basename(file, '.md'),
+                        content: fileContent.trim()
+                    });
+                }
+            }
+        }
+        catch (error) {
+            // _shared directory doesn't exist or is empty - that's okay
+            // Return empty array, shared instructions are optional
+        }
+        this.sharedInstructionsCache = instructions;
+        return instructions;
+    }
+    /**
+     * Clear the shared instructions cache.
+     * Useful if shared instructions are modified at runtime.
+     */
+    clearCache() {
+        this.sharedInstructionsCache = null;
+    }
     async loadPrompt(filename, variables = {}) {
         const filePath = path.join(this.promptsDir, filename);
         try {
@@ -12,22 +63,33 @@ export class PromptLoader {
             // Basic Frontmatter parsing
             const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
             const match = fileContent.match(frontmatterRegex);
+            let name;
+            let description;
+            let content;
             if (!match) {
                 // Fallback if no frontmatter
-                return {
-                    name: path.basename(filename, '.md'),
-                    description: 'No description provided.',
-                    content: this.injectVariables(fileContent, variables)
-                };
+                name = path.basename(filename, '.md');
+                description = 'No description provided.';
+                content = fileContent;
+            }
+            else {
+                const rawFrontmatter = match[1];
+                const metadata = this.parseFrontmatter(rawFrontmatter);
+                name = metadata.name || path.basename(filename, '.md');
+                description = metadata.description || '';
+                content = match[2];
+            }
+            // Inject variables
+            content = this.injectVariables(content, variables);
+            // Append shared instructions
+            const sharedInstructions = await this.loadSharedInstructions();
+            if (sharedInstructions.length > 0) {
+                const sharedContent = sharedInstructions
+                    .map(inst => `\n---\n\n${inst.content}`)
+                    .join('\n');
+                content = content + sharedContent;
             }
-            const rawFrontmatter = match[1];
-            const content = match[2];
-            const metadata = this.parseFrontmatter(rawFrontmatter);
-            return {
-                name: metadata.name || path.basename(filename, '.md'),
-                description: metadata.description || '',
-                content: this.injectVariables(content, variables)
-            };
+            return { name, description, content };
         }
         catch (error) {
             throw new Error(`Failed to load prompt ${filename}: ${error}`);
@@ -55,7 +117,8 @@ export class PromptLoader {
     async listPrompts() {
         try {
             const files = await fs.readdir(this.promptsDir);
-            return files.filter(f => f.endsWith('.md'));
+            // Filter out _shared directory and only return .md files
+            return files.filter(f => f.endsWith('.md') && !f.startsWith('_'));
         }
         catch (error) {
             return [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poly-agent",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "CLI installer for AI IDE prompts - install commands, skills, and workflows for Cursor, ClaudeCode, and Antigravity",
   "main": "dist/index.js",
   "bin": {

package/prompts/_shared/context-hook.md

@@ -0,0 +1,103 @@
+---
+name: Context Hook
+description: Shared instructions for automatic context dumping after file edits.
+type: shared
+---
+
+# Context Management Hook
+
+## Behavior
+
+After **every file edit** you make, you MUST update the project context file. This ensures continuity across conversations and helps maintain a clear record of progress.
+
+## When to Update Context
+
+1. **After any file edit** - Immediately after modifying, creating, or deleting a file
+2. **When the task context changes** - New goals, pivots, or scope changes
+3. **When explicitly mentioned** - If the user references `.context/` or asks about context
+4. **At conversation milestones** - Completing a feature, fixing a bug, reaching a checkpoint
+
+## Context File Location & Naming
+
+- **Directory**: `.context/`
+- **Filename**: Generate a short, descriptive kebab-case name based on the current task
+  - Examples: `feature-auth.md`, `bugfix-api-timeout.md`, `refactor-database-layer.md`, `setup-ci-pipeline.md`
+- **Persistence**: Use the SAME context file throughout a conversation/task. Only create a new one if the task fundamentally changes.
+
+## Context File Format
+
+Use this exact structure:
+
+```markdown
+---
+created: [ISO timestamp when first created]
+updated: [ISO timestamp of last update]
+task: [One-line task description]
+status: [in-progress | completed | blocked | paused]
+---
+
+# Context: [short-name]
+
+## Summary
+[2-3 sentence AI-generated summary of what this task is about and current state]
+
+## Files Changed
+- `path/to/file.ts` - [Brief description of change]
+- `path/to/another.ts` - [Brief description of change]
+
+## Current Goals
+1. [Primary goal]
+2. [Secondary goal]
+3. [etc.]
+
+## Progress
+- [x] [Completed item]
+- [x] [Completed item]
+- [ ] [Pending item]
+- [ ] [Pending item]
+
+## Next Steps
+- [Immediate next action]
+- [Following action]
+
+## Notes
+[Any important context, decisions made, blockers, or things to remember]
+```
+
+## Rules
+
+1. **Always update, never skip** - Even small edits warrant a context update
+2. **Be concise but complete** - Capture essential information without verbosity
+3. **Track ALL file changes** - Every file you touch should be listed
+4. **Maintain history** - Don't remove completed items from Progress, mark them done
+5. **Update timestamps** - Always update the `updated` field in frontmatter
+6. **Create directory if needed** - If `.context/` doesn't exist, create it
+
+## Example Workflow
+
+1. User asks: "Add authentication to the API"
+2. You create/update `.context/feature-api-auth.md` with initial goals
+3. You edit `src/auth/middleware.ts`
+4. You immediately update `.context/feature-api-auth.md` with the file change
+5. You edit `src/routes/login.ts`
+6. You update `.context/feature-api-auth.md` again
+7. Continue until task complete, then set status to `completed`
+
+## Recalling Context
+
+When a user asks to recall or resume a context (e.g., "recall feature-auth", "continue from context X", "load context"):
+
+1. **Read ONLY the specified context file** from `.context/` - Do NOT scan the entire project
+2. **Trust the context file** - It contains all the information you need
+3. **Summarize the current state** - What was done, what remains
+4. **Confirm understanding** with the user before proceeding
+5. **Only read files listed in "Files Changed"** if you need to check current state
+6. **Continue updating** the same context file as you work
+
+**IMPORTANT**: When recalling context, do NOT:
+- Search or scan the entire codebase
+- Read files not mentioned in the context
+- Run broad exploratory searches
+- Assume information beyond what's in the context file
+
+If asked to **list contexts**, read the `.context/` directory and show available files with their status.

package/prompts/context-recall.md

@@ -0,0 +1,82 @@
+---
+name: Context Recall
+description: Load and resume work from a saved context file.
+---
+# Context Recall
+
+You are being asked to **resume work** from a previously saved context.
+
+## Instructions
+
+1. **Read the context file** specified by the user (from `.context/` directory)
+2. **Understand the state** - Review the summary, files changed, goals, and progress
+3. **Identify next steps** - Look at what was marked as pending or in "Next Steps"
+4. **Resume seamlessly** - Continue the work as if you never left
+
+## How to Use
+
+The user will provide one of:
+- A context file name: `feature-auth` or `feature-auth.md`
+- A full path: `.context/feature-auth.md`
+- Or ask you to list available contexts
+
+## If Asked to List Contexts
+
+Read the `.context/` directory and present available context files:
+
+```
+Available contexts:
+- feature-auth.md (updated: 2026-01-12)
+- bugfix-api-timeout.md (updated: 2026-01-11)
+- refactor-database.md (updated: 2026-01-10)
+```
+
+## After Loading Context
+
+1. **Summarize** what you understand about the task
+2. **Confirm** the current state and what remains to be done
+3. **Ask** if the user wants to continue from where it left off, or modify the approach
+4. **Continue updating** the same context file as you make changes
+
+## Example Interaction
+
+**User**: "Recall context feature-auth"
+
+**You**: 
+> I've loaded the context for **feature-auth**:
+> 
+> **Summary**: Implementing JWT-based authentication for the API
+> 
+> **Progress**:
+> - ✅ Created auth middleware
+> - ✅ Set up login route
+> - ⏳ Token refresh logic (in progress)
+> - ⬜ Rate limiting
+> 
+> **Last worked on**: `src/auth/refresh.ts`
+> 
+> Would you like me to continue with the token refresh logic, or would you prefer to work on something else?
+
+## Critical Rules
+
+1. **ONLY read the context file** - Do NOT scan the entire project or codebase
+2. **Trust the context file** - It contains everything you need to understand the task
+3. **Read files listed in "Files Changed"** - Only if you need to understand current state
+4. **Don't guess or make up content** - Only use information from the context file
+5. **If context file doesn't exist** - Inform the user and offer to create one
+6. **Keep the context file updated** - As you continue working
+
+## What NOT To Do
+
+- ❌ Do NOT search the entire codebase to "understand the project"
+- ❌ Do NOT read files that aren't mentioned in the context
+- ❌ Do NOT run broad searches or scans
+- ❌ Do NOT assume context beyond what's in the file
+
+## What TO Do
+
+- ✅ Read ONLY `.context/[name].md` first
+- ✅ Use the "Files Changed" section to know which files are relevant
+- ✅ Read specific files from "Files Changed" if needed for current state
+- ✅ Follow "Next Steps" from the context file
+- ✅ Ask the user if anything is unclear