awesome-agv 3.2.0 → 3.4.0

package/README.md

@@ -333,9 +333,8 @@ Skills are deep expertise modules loaded on demand — agents only pay the token
 *   **[Convergence Loop](.agents/skills/convergence-loop/SKILL.md)**: Iterative problem solving protocol for coordinators.
 *   **[Fault Recovery](.agents/skills/fault-recovery/SKILL.md)**: Structured fault tolerance and escalation ladder.
 *   **[Integrity Enforcement](.agents/skills/integrity-enforcement/SKILL.md)**: Zero-tolerance compliance checking for the arbiter agent.
-*   **[Parallel Dispatch](.agents/skills/parallel-dispatch/SKILL.md)**: MECE task decomposition, file ownership enforcement, DAG-based execution, and safe merge protocol for intra-domain parallel dispatch. The safety invariants that prevent merge chaos when multiple agents write in parallel. Applies recursively at every nesting depth.
-*   **[Scope Decomposition](.agents/skills/scope-decomposition/SKILL.md)**: Project and mission decomposition techniques.
-*   **[Audit Checklist](.agents/skills/audit-checklist/SKILL.md)**: Consolidated audit checklists for code review and verification — loaded by `/audit` workflow and multi-agent review pipelines.
+*   **[Parallel Dispatch](.agents/skills/parallel-dispatch/SKILL.md)**: MECE task decomposition, scope sizing, file ownership enforcement, DAG-based execution, and safe merge protocol for intra-domain parallel dispatch. Includes scope decomposition techniques previously in a separate skill.
+*   **[Agent Protocols](.agents/skills/agent-protocols/SKILL.md)**: Shared behavioral protocols for all agents: recursive nesting, pre-implementation restatement, agent definition cascade, and parallel dispatch format.
 *   **[Acceptance Review](.agents/skills/acceptance-review/SKILL.md)**: Spec adherence and deliverable completeness verification — ensures what was delivered matches what was requested.
 
 #### 🌐 Language & Framework Idioms (26)

package/agv.config.json

@@ -34,11 +34,11 @@
       "perf-optimization",
       "refactoring-patterns",
       "research-methodology",
-      "scope-decomposition",
       "sequential-thinking",
       "supply-chain-security",
       "testability-patterns",
-      "testing-strategy"
+      "testing-strategy",
+      "agent-protocols"
     ],
     "stacks": {
       "go": {
@@ -254,9 +254,8 @@
       "fault-recovery",
       "integrity-enforcement",
       "parallel-dispatch",
-      "scope-decomposition",
-      "audit-checklist",
-      "acceptance-review"
+      "acceptance-review",
+      "agent-protocols"
     ]
   }
 }

package/bin/awesome-agv.js

@@ -694,6 +694,35 @@ function writeAgvrc(targetDir, mode, selectedStacks, deselected) {
   fs.writeFileSync(rcPath, JSON.stringify(config, null, 2) + '\n');
 }
 
+// ── Patch .gitignore ───────────────────────────────────────────────────────────
+const AGENTWORK_ENTRY = '.agentwork/';
+
+/**
+ * Ensures .agentwork/ is listed in .gitignore.
+ * Creates .gitignore if it doesn't exist.
+ * Returns: 'created' | 'patched' | 'already_present'
+ */
+function patchGitignore(targetDir) {
+  const gitignorePath = path.join(targetDir, '.gitignore');
+
+  if (!fs.existsSync(gitignorePath)) {
+    fs.writeFileSync(gitignorePath, `${AGENTWORK_ENTRY}\n`, 'utf8');
+    return 'created';
+  }
+
+  const content = fs.readFileSync(gitignorePath, 'utf8');
+  const lines = content.split('\n').map((l) => l.trim());
+
+  if (lines.includes(AGENTWORK_ENTRY)) {
+    return 'already_present';
+  }
+
+  // Append with a preceding newline if the file doesn't end with one
+  const separator = content.endsWith('\n') ? '' : '\n';
+  fs.appendFileSync(gitignorePath, `${separator}${AGENTWORK_ENTRY}\n`, 'utf8');
+  return 'patched';
+}
+
 // ── Read existing .agvrc ───────────────────────────────────────────────────────
 function readAgvrc(targetDir) {
   const rcPath = path.join(targetDir, AGENT_DIR, CONFIG_FILE);
@@ -760,7 +789,7 @@ function readManifest(tarballPath) {
 }
 
 // ── Print Success Summary ──────────────────────────────────────────────────────
-function printSuccess(targetDir, mode, selectedStacks) {
+function printSuccess(targetDir, mode, selectedStacks, gitignoreResult) {
   const agentDir = path.join(targetDir, AGENT_DIR);
   const rulesDir = path.join(agentDir, 'rules');
   const skillsDir = path.join(agentDir, 'skills');
@@ -788,6 +817,16 @@ function printSuccess(targetDir, mode, selectedStacks) {
         ? `${icon.target} Curated`
         : `${icon.gear} Advanced`;
 
+  // Gitignore status message
+  let gitignoreMsg;
+  if (gitignoreResult === 'created') {
+    gitignoreMsg = `${icon.check} ${c.bold}.gitignore${c.reset} created with ${c.cyan}.agentwork/${c.reset} entry`;
+  } else if (gitignoreResult === 'patched') {
+    gitignoreMsg = `${icon.check} ${c.bold}.gitignore${c.reset} patched — added ${c.cyan}.agentwork/${c.reset}`;
+  } else {
+    gitignoreMsg = `${icon.check} ${c.bold}.gitignore${c.reset} already contains ${c.cyan}.agentwork/${c.reset}`;
+  }
+
   console.log(`
 ${c.green}${c.bold}  Installation complete! ${icon.rocket}${c.reset}
 
@@ -798,6 +837,8 @@ ${c.green}${c.bold}  Installation complete! ${icon.rocket}${c.reset}
   ${icon.tool}  ${c.bold}${skillsCount}${c.reset} Skills     ${c.dim}Debugging, design, code review, language idioms${c.reset}
   ${icon.cycle}  ${c.bold}${workflowsCount}${c.reset} Workflows  ${c.dim}End-to-end dev processes${c.reset}
   🤖  ${c.bold}${agentsCount}${c.reset} Agents     ${c.dim}Specialized multi-agent personas${c.reset}
+
+  ${gitignoreMsg}
 `);
 
   if (selectedStacks && selectedStacks.size > 0) {
@@ -1005,8 +1046,11 @@ async function main() {
     // ── Write .agvrc ──
     writeAgvrc(options.targetDir, mode, selectedStackKeys, deselected);
 
+    // ── Patch .gitignore ──
+    const gitignoreResult = patchGitignore(options.targetDir);
+
     // ── Success ──
-    printSuccess(options.targetDir, mode, selectedStackKeys);
+    printSuccess(options.targetDir, mode, selectedStackKeys, gitignoreResult);
   } catch (err) {
     console.error(`\n  ${icon.error} ${c.red}Installation failed:${c.reset} ${err.message}\n`);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-agv",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Selective installer for Awesome AGV — a rugged, high-quality AI Agent configuration suite with 25 rules, 59 skills, 12 workflows, and 21 agent personas.",
   "bin": {
     "awesome-agv": "./bin/awesome-agv.js"