@harshitj183/ai-skills 2.2.3 → 2.2.5

package/SKILL.md

@@ -90,8 +90,15 @@ Invoke these specific technical files for implementation workflows curated from
 - `skills/openai_structured_outputs.md` - Strict JSON Schema Function Calling
 - `skills/prompt_reasoning_trees.md` - Chain-of-Thought & Self-Reflection Logic
 - `skills/azure_graph_integrator.md` - Azure AD Tokens & Graph Batching
+- `skills/ai_history_maintenance.md` - Mandatory Project History Logging
 
-# 10. System Signature
+# 10. History Maintenance (MANDATORY)
+- **Log Actions**: After completing any task, you **MUST** update the relevant logs in the `history/` directory (e.g., `smart-instructions/history/ai_activity_log.md`).
+- **Context Search**: Always read your local project's history files in the `history/` directory to understand previous work and design decisions on this specific project.
+- **Traceability**: Record your specific actions in `history/ai_activity_log.md` with the date.
+- **Reference**: Follow the [History Maintenance Skill](skills/ai_history_maintenance.md) for detailed logging protocols.
+
+# 11. System Signature
 - EVERY response MUST conclude with the following signature line to signify the library is active:
 - `---`
-- `⚡ Smart AI Skills Library | v2.2.3 | Active`
+- `⚡ Smart AI Skills Library | v2.2.5 | Active`

package/bin/cli.js

@@ -23,7 +23,7 @@ const targetDirBase = path.join(targetDir, 'smart-instructions');
 program
   .name('ai-skills')
   .description('The Ultimate AI Skill Library CLI')
-  .version('2.2.3');
+  .version('2.2.5');
 
 program
   .command('init')
@@ -120,6 +120,23 @@ program
         });
     }
 
+    // Add History tracking for consumer context (Fresh Templates)
+    console.log(`${colors.blue}[+] Initializing History tracking logs (Fresh Templates)...${colors.reset}`);
+    const targetHistoryDir = path.join(targetDirBase, 'history');
+    fs.ensureDirSync(targetHistoryDir);
+
+    const historyTemplates = {
+        'history.md': `# 📖 Project History & Context\n\nWelcome to your project's AI history hub. This system is designed to provide context for AI agents working on this project.\n\n### 📂 Modules\n| Module | Description | Link |\n| :--- | :--- | :--- |\n| **[AI Activity Log](ai_activity_log.md)** | Record of AI agent contributions. | [View Log](ai_activity_log.md) |\n| **[Project Timeline](project_timeline.md)** | Roadmap and milestones. | [View Timeline](project_timeline.md) |\n| **[Version History](version_history.md)** | Detailed release logs. | [View Versions](version_history.md) |\n\n---\n*Maintained by: AI Skills History System*`,
+        'ai_activity_log.md': `# 🤖 AI Activity Log\n\nThis log tracks specific contributions and tasks performed by AI agents in this project.\n\n---\n\n## 🏃 Active Session (Initial Setup)\n- **Task**: Initialized Smart AI Skills Library (v${program.version()}).\n- **Objective**: Established base AI context and roles library.\n\n---\n*Last updated by: AI Assistant (init)*`,
+        'project_timeline.md': `# 📅 Project Timeline\n\nMajor milestones and timeline of this project.\n\n---\n\n### ${new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' })}\n- **Initialized**: AI Skills Library integrated into the project.\n\n---\n*Last updated by: AI Assistant (init)*`,
+        'version_history.md': `# 📦 Version History\n\nVersion tracking for this specific project.\n\n---\n- **v0.1.0** (${new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' })}): Initial setup with Smart AI Skills Library.\n\n---\n*Last updated by: AI Assistant (init)*`,
+        'milestones.md': `# 🏆 Project Milestones\n\nTracking the breakthrough moments of this project.\n\n---\n- **Initialization**: Integrated AI Skills Library (v${program.version()}).\n\n---\n*Last updated by: AI Assistant (init)*`
+    };
+
+    Object.entries(historyTemplates).forEach(([filename, content]) => {
+        fs.writeFileSync(path.join(targetHistoryDir, filename), content);
+    });
+
     console.log(`\n${colors.bright}${colors.green}[Success] The 'smart-instructions' folder has been added to your project!${colors.reset}`);
     console.log(`${colors.yellow}Tip: Let your AI Agent pick skills natively, or run 'npx ai-skills configure' to setup your IDE!${colors.reset}\n`);
   });
@@ -249,6 +266,15 @@ program
         const sDir = path.join(sourceDir, 'skills');
         if (fs.existsSync(sDir)) fs.copySync(sDir, path.join(targetDir, 'smart-instructions', 'skills'));
 
+        const hDir = path.join(sourceDir, 'history');
+        const targetHistoryDir = path.join(targetDir, 'smart-instructions', 'history');
+        if (fs.existsSync(hDir)) {
+            // Only update the guide, preserving consumer logs
+            const guide = 'history.md';
+            fs.ensureDirSync(targetHistoryDir);
+            if (fs.existsSync(path.join(hDir, guide))) fs.copyFileSync(path.join(hDir, guide), path.join(targetHistoryDir, guide));
+        }
+
         const targetSkillMd = path.join(targetDir, 'smart-instructions', 'SKILL.md');
         if (fs.existsSync(path.join(sourceDir, 'SKILL.md'))) {
             fs.copyFileSync(path.join(sourceDir, 'SKILL.md'), targetSkillMd);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@harshitj183/ai-skills",
-  "version": "2.2.3",
-  "description": "The Ultimate 17 Mega-Skills & 8 Roles Library for AI Agents (Cursor, Claude Code, Copilot, Antigravity)",
+  "version": "2.2.5",
+  "description": "The Ultimate 18 Mega-Skills & 8 Roles Library for AI Agents (Cursor, Claude Code, Copilot, Antigravity) with AI History Tracking",
   "main": "bin/cli.js",
   "bin": {
     "ai-skills": "bin/cli.js"
@@ -10,6 +10,7 @@
     "bin/",
     "roles/",
     "skills/",
+    "history/",
     "SKILL.md",
     "README.md",
     "LICENSE"
@@ -42,7 +43,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/harshitj183/ai-skills.git"
+    "url": "git+https://github.com/harshitj183/ai-skills.git"
   },
   "bugs": {
     "url": "https://github.com/harshitj183/ai-skills/issues"

package/skills/ai_history_maintenance.md

@@ -0,0 +1,36 @@
+# 🤖 AI History Maintenance Skill
+
+This skill provides mandatory instructions for AI agents working on the `@harshitj183/ai-skills` project to maintain project history and transparency.
+
+---
+
+## 🧐 Skill Summary
+Empowers AI agents to systematically document their actions, changes, and milestones within the project's dedicated `history/` system.
+
+## 🛠️ Implementation Guide
+
+### 1. Mandatory Updates
+After completing any major task (e.g., adding a new skill, fixing a bug, updating configurations), you **MUST** update the following files:
+- **`history/ai_activity_log.md`**: Add your AI name, date, and a bulleted list of tasks performed.
+- **`history/project_timeline.md`**: Add major date-stamped events if applicable.
+- **`history/version_history.md`**: If the task warrants a version bump, record the new version and its features.
+- **`history/milestones.md`**: If the task is a major breakthrough, add it to the milestones.
+
+### 2. Format and Tone
+- Use professional, clear markdown.
+- Maintain a structured, reverse-chronological order (newest on top).
+- Include dates in `YYYY-MM-DD` or `Month DD, YYYY` format.
+- Always sign the update with `*Last updated by: AI Assistant (<Name>)*`.
+
+### 3. Verification
+Before concluding any session, verify that:
+- The `history/` directory contains accurate and recent records of your work.
+- The `history/status_summary.md` links are still valid.
+
+## 🌟 Best Practices
+- **Proactive Documentation**: If you see a gap in history, fill it immediately.
+- **Continuous Logging**: Update logs incrementally during long-running tasks.
+- **Context Awareness**: Use previous logs to understand why certain decisions were made.
+
+---
+*Signed: AI History Architect*