@p_tipso/agentive 1.0.2 → 1.0.3

package/README.md

@@ -20,16 +20,16 @@
 
 ---
 
-Stop maintaining separate rule files for every AI tool. **agentive** scaffolds a universal `.agents/` directory and an `AGENTS.md` file in your project — providing a **single source of truth** for all your agent commands, skills, and rules.
+Stop maintaining separate rule files for every AI tool. **agentive** scaffolds a universal `.agents/` directory, an `AGENTS.md` file, and an `.aiignore` file in your project — providing a **single source of truth** for all your agent commands, skills, and rules, while significantly saving token usage.
 
 ## ✨ Why Agentive?
 
 | Feature                       | Description                                                          |
 | :---------------------------- | :------------------------------------------------------------------- |
-| 🚀 **Zero Config**            | Run one command and get a fully structured workspace instantly.      |
+| 🚀 **Interactive Setup**    | Select your environment (General, Expo, React Native) to get tailored rules. |
 | 🌍 **Universal**              | Framework-agnostic setup. Works with React, Python, Go, you name it. |
 | 🧠 **Single Source of Truth** | Centralize skills and rules for _all_ your AI agents in one place.   |
-| ⚡ **No Prompts**             | Just run it. No annoying interactive setup wizards to slow you down. |
+| ⚡ **Dynamic Layering**     | Scaffolds base rules and safely merges framework-specific guardrails. |
 
 ---
 
@@ -60,11 +60,12 @@ agentive
 
 ## 🏗 What Happens Under the Hood?
 
-When you run `agentive`, it detects your current directory and instantly scaffolds this structure:
+When you run `agentive`, it launches an interactive wizard asking about your project environment (e.g., General, Mobile > Expo, React Native). It then intelligently scaffolds a tailored workspace:
 
 ```text
 your-project/
 ├── AGENTS.md                      ← Root agent instructions
+├── .aiignore                      ← Hides irrelevant files from AI to save tokens
 ├── .agents/
 │   ├── settings.json              ← Project config
 │   ├── settings.local.json        ← Local machine overrides (auto-gitignored)
@@ -78,12 +79,16 @@ your-project/
 │       └── README.md              ← Guide: how to add rules
 ```
 
-### 📂 Folder Guide
+### 📂 File & Folder Guide
 
+- **`.aiignore`**: Prevents context pollution and saves tokens by hiding files (like `node_modules` or build outputs) from your AI agents.
 - **`commands/`**: Reusable prompt instructions that agents can execute on demand (e.g. `review.md`).
 - **`skills/`**: Skill definitions that teach agents how to behave in specific roles.
 - **`rules/`**: Project-wide rules that all agents must follow strictly.
 
+### 🌟 Framework-Specific Guardrails
+By selecting a specific framework (like **Expo** or **React Native**), `agentive` overlays expertly crafted rules into your `.agents/` folder. This ensures your AI understands nuances like *Expo Router*, *Native Modules*, or *Unitless Pixels* right out of the box—preventing common hallucinations.
+
 ---
 
 ## 🤝 Contributing

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@p_tipso/agentive",
-  "version": "1.0.2",
-  "description": "A universal, framework-agnostic AI agent repository setup CLI. Scaffold a .agent/ workspace and sync to Cursor, Claude, and Windsurf.",
+  "version": "1.0.3",
+  "description": "A universal, framework-agnostic AI agent repository setup CLI. Scaffold a .agents/ workspace, AGENTS.md, and .aiignore to sync and optimize context for Cursor, Claude, and Windsurf.",
   "license": "MIT",
   "author": "Pakawat Tipso",
   "type": "commonjs",
@@ -27,7 +27,8 @@
     "scaffold",
     "init",
     "rules",
-    "context"
+    "context",
+    "aiignore"
   ],
   "repository": {
     "type": "git",

package/src/commands/init.js

@@ -57,7 +57,7 @@ async function runInit() {
       name: 'framework',
       message: 'Which framework are you using?',
       choices: [
-        { title: 'Expo', value: 'expo' },
+        { title: 'Expo (Recommended)', value: 'expo' },
         { title: 'React Native', value: 'react-native' },
       ],
       initial: 0,
@@ -88,6 +88,7 @@ async function runInit() {
   });
 
   console.log(chalk.green('  ✔ ') + chalk.white('Created ') + chalk.cyan('AGENTS.md'));
+  console.log(chalk.green('  ✔ ') + chalk.white('Created ') + chalk.cyan('.aiignore'));
   console.log(chalk.green('  ✔ ') + chalk.white('Scaffolded ') + chalk.cyan('.agents/') + chalk.white(' workspace'));
 
   // --- Done ---
@@ -97,6 +98,7 @@ async function runInit() {
   console.log(chalk.white('  Your AI workspace is ready:'));
   console.log('');
   console.log(chalk.gray('    AGENTS.md                       ← root agent instructions'));
+  console.log(chalk.gray('    .aiignore                       ← hides files from AI to save tokens'));
   console.log(chalk.gray('    .agents/'));
   console.log(chalk.gray('    ├── settings.json               ← project config'));
   console.log(chalk.gray('    ├── settings.local.json         ← local overrides (gitignored)'));

package/src/templates/base/AGENTS.md

@@ -19,6 +19,11 @@ All agent configuration lives inside the `.agents/` directory:
 | `.agents/skills/` | Skill definitions that teach agents how to behave |
 | `.agents/rules/` | Project-wide rules all agents must follow |
 
+## Context Management
+
+When exploring, reading, or searching this repository, you **MUST** respect the exclusion rules defined in `.aiignore`. 
+Additionally, you must also read and respect any rules defined in `.gitignore`, `.cursorignore`, or `.aiexclude` if they exist in the repository to prevent context pollution and save token usage.
+
 ## Getting Started
 
 1. Edit the markdown files inside `.agents/` to customise agent behaviour

package/src/templates/base/aiignore

@@ -0,0 +1,48 @@
+# Standard AI Ignore file - prevents context pollution & saves tokens
+# Learn more: https://github.com/TiPS0/agentive
+
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+vendor/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Build outputs & generated files
+dist/
+build/
+out/
+coverage/
+.next/
+.nuxt/
+.vuepress/
+.cache/
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Version control & OS files
+.git/
+.DS_Store
+*.pem
+
+# Editor directories and files
+.idea/
+.vscode/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/src/utils/fileSystem.js

@@ -136,6 +136,13 @@ async function copyTemplates(templatesDir, agentsDir, projectName, projectType =
     await fs.writeFile(path.join(cwd, 'AGENTS.md'), content, 'utf-8');
   } catch { /* template may not exist */ }
 
+  // 1.5 Copy aiignore from base to project root as .aiignore
+  const aiignoreSrc = path.join(templatesDir, 'base', 'aiignore');
+  try {
+    let content = await fs.readFile(aiignoreSrc, 'utf-8');
+    await fs.writeFile(path.join(cwd, '.aiignore'), content, 'utf-8');
+  } catch { /* template may not exist */ }
+
   const foldersToInclude = ['commands', 'skills', 'rules'];
 
   // Helper to copy a specific template layer