dev-booster 1.17.1 → 1.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-booster",
-  "version": "1.17.1",
+  "version": "1.18.0",
   "description": "Reusable AI development kit with manual boosters, governance, and project bootstrap",
   "type": "module",
   "scripts": {

package/src/index.js

@@ -20,6 +20,30 @@ const IDE_BRIDGE_BLOCK = [
   "Before any action, read `.devbooster/rules/PROTOCOL.md` for full governance rules.",
 ];
 const IDE_BRIDGE_MARKER = ".devbooster/rules/PROTOCOL.md";
+
+const AGENTS_TRIGGER_BLOCK = [
+  "",
+  "## Instant Triggers",
+  "",
+  "You can instantly activate any Dev Booster behavior by typing the corresponding `@` trigger in chat.",
+  "",
+  "**Important:** A trigger activates the booster's contract mode only (Armed/Stage 0).",
+  "It does NOT authorize the booster to analyze, investigate, or modify the project.",
+  "After activation, provide the concrete task or symptom before the booster proceeds.",
+  "",
+  "Read `.devbooster/rules/TRIGGERS.md` for the complete trigger dictionary.",
+  "",
+  "Common examples:",
+  "- `@Frontend` — activate frontend specialist",
+  "- `@Backend` — activate backend architect",
+  "- `@Debug` — systematic root cause analysis",
+  "- `@Audit` — lint and typecheck audit",
+  "- `@Refactor` — clean code and SOLID refactoring",
+  "- `@Performance` — Web Vitals and optimization",
+  "- `@Testing` — test strategy and coordination",
+  "- `@Advisor` — kit GPS to choose the right booster",
+];
+const AGENTS_TRIGGER_MARKER = "TRIGGERS.md";
 const IDE_BRIDGE_FALLBACK_FLAG = path.join("hub", "flags", "needs-ide-bridge");
 const IDE_BRIDGE_TARGETS = [
   ".rules",
@@ -242,6 +266,41 @@ function setupIdeBridgeFiles(dryRun) {
   );
 }
 
+function ensureAgentsTriggers(dryRun) {
+  const agentsPath = path.join(TARGET_DIR, "AGENTS.md");
+
+  if (!fs.existsSync(agentsPath)) {
+    if (!dryRun) {
+      const fullBlock = [
+        "# 🤖 DEV BOOSTER — AGENTIC KIT BOOTSTRAP",
+        "",
+        "Before any action, read `.devbooster/rules/PROTOCOL.md` for full governance rules.",
+        ...AGENTS_TRIGGER_BLOCK,
+        "",
+      ];
+      fs.writeFileSync(agentsPath, fullBlock.join("\n"));
+    }
+    console.log(
+      `  status: ${dryRun ? "would be created" : "created"} with protocol + triggers`,
+    );
+    return;
+  }
+
+  const existing = fs.readFileSync(agentsPath, "utf8");
+  if (existing.includes(AGENTS_TRIGGER_MARKER)) {
+    console.log("  status: triggers already present (preserved)");
+    return;
+  }
+
+  if (!dryRun) {
+    const updated = existing.trimEnd() + "\n\n" + AGENTS_TRIGGER_BLOCK.join("\n") + "\n";
+    fs.writeFileSync(agentsPath, updated);
+  }
+  console.log(
+    `  status: triggers section ${dryRun ? "would be appended" : "appended"}`,
+  );
+}
+
 function checkLocalInstall() {
   try {
     const localPkg = path.join(
@@ -348,6 +407,7 @@ async function runInstall() {
 
   await maybeAddDevBoosterToGitignore(dryRun);
   setupIdeBridgeFiles(dryRun);
+  ensureAgentsTriggers(dryRun);
 
   console.log(`
 ╭──────────────────────────────────────────────╮
@@ -435,6 +495,8 @@ function runUpdate() {
   console.log("                    ✔ TRIGGERS.md  (updated)");
   console.log("                    ℹ Whitelabel stack rules (preserved)\n");
 
+  ensureAgentsTriggers(dryRun);
+
   console.log("▸ DEVBOOSTER_INIT.md");
   console.log("  status: preserved (no changes made)\n");
 

package/template/.devbooster/rules/TRIGGERS.md

@@ -32,6 +32,7 @@ These triggers execute background utility tasks and update persistent rule or st
 These triggers instantly activate specific booster behavior contracts without requiring the user to manually load the booster files. Upon invocation, immediately read the corresponding booster file in `.devbooster/boosters/` and follow its execution instructions.
 
 - **`@AutoTriage`** ➔ Activates `.devbooster/boosters/auto-triage.md` (Artifact-centered automatic engineering triage with separate Plan + Review and execution approvals).
+- **`@SmartTask`** ➔ Activates `.devbooster/boosters/smart-task.md` (Lightweight triage with full investigation depth, single "pode seguir" approval, atomic plan + Builder execution, persisted artifact).
 - **`@Context`** ➔ Actives `.devbooster/boosters/context.md` (Silent Sponge context mapping).
 - **`@Coder`** ➔ Activates `.devbooster/boosters/coder.md` (Co-Creative design/writing).
 - **`@Builder`** ➔ Activates `.devbooster/boosters/builder.md` (Senior plan audit & execution).

package/template/DEVBOOSTER_INIT.md

@@ -13,7 +13,8 @@ Execute each step in order. Do not skip steps. Do not ask for confirmation betwe
 
 ### STEP 1 — Read the Governance Protocol
 Read `.devbooster/rules/PROTOCOL.md` in full.
-This defines your conduct rules, communication style, and architectural constraints. It also delegates instant command shortcuts (like `@Coder`, `@Builder`) to `.devbooster/rules/TRIGGERS.md`.
+This defines your conduct rules, communication style, and architectural constraints.
+For instant `@` shortcut triggers (`@Frontend`, `@Debug`, `@Audit`, etc.), see `AGENTS.md` at the project root (created in Step 6).
 
 ### STEP 2 — Bootstrap PROJECT.md
 Read `.devbooster/rules/PROJECT.md`.
@@ -41,6 +42,26 @@ In that case, create `AGENTS.md` at the project root and insert the following bl
 # 🤖 DEV BOOSTER — AGENTIC KIT BOOTSTRAP
 
 Before any action, read `.devbooster/rules/PROTOCOL.md` for full governance rules.
+
+## Instant Triggers
+
+You can instantly activate any Dev Booster behavior by typing the corresponding `@` trigger in chat.
+
+**Important:** A trigger activates the booster's contract mode only (Armed/Stage 0).
+It does NOT authorize the booster to analyze, investigate, or modify the project.
+After activation, provide the concrete task or symptom before the booster proceeds.
+
+Read `.devbooster/rules/TRIGGERS.md` for the complete trigger dictionary.
+
+Common examples:
+- `@Frontend` — activate frontend specialist
+- `@Backend` — activate backend architect
+- `@Debug` — systematic root cause analysis
+- `@Audit` — lint and typecheck audit
+- `@Refactor` — clean code and SOLID refactoring
+- `@Performance` — Web Vitals and optimization
+- `@Testing` — test strategy and coordination
+- `@Advisor` — kit GPS to choose the right booster
 ```
 
 Do not duplicate the block if the file already references `.devbooster/rules/PROTOCOL.md`.