@ghl-ai/aw 0.1.39-beta.13 → 0.1.39-beta.15

package/integrate.mjs

@@ -286,7 +286,7 @@ function generateClaudeMd(cwd, namespace, rulesSections = {}) {
   const team = namespace || 'my-team';
   let base = `# CLAUDE.md — ${team}
 
-Team: ${team} | Local-first orchestration via \`.aw_docs/\` | MCPs: \`memory/*\` (shared knowledge), \`git-jenkins\` (CI/CD), \`grafana\` (observability)
+Team: ${team} | Local-first orchestration via \`.aw_docs/\` | MCPs: \`memory/*\` (shared knowledge), \`jenkins_*\` (CI/CD via ghl-ai MCP), \`grafana\` (observability)
 
 ## Routing Rule (ABSOLUTE)
 
@@ -357,7 +357,7 @@ memory/search  → Search shared team knowledge base
 memory/store   → Push learnings to shared knowledge (eager sync after runs)
 memory/get     → Fetch specific memory by ID
 grafana/*      → External observability
-git-jenkins/*  → External CI/CD pipelines
+jenkins_*      → CI/CD pipelines (provided by ghl-ai MCP)
 stitch/*       → External design generation
 \`\`\`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.39-beta.13",
+  "version": "0.1.39-beta.15",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {

package/render-rules.mjs

@@ -322,9 +322,62 @@ function renderCursorRules(cwd, rulesDir, options = {}) {
   writeFileSync(join(cursorRulesDir, 'common-aw-routing.mdc'), routingRule);
   count++;
 
+  // Generate the prompt-response-format rule — machine-parseable trace
+  // of what skills/rules/MCPs were used during a response.
+  const traceRule = generateCursorPromptTraceRule();
+  writeFileSync(join(cursorRulesDir, 'common-prompt-trace.mdc'), traceRule);
+  count++;
+
   return count;
 }
 
+function generateCursorPromptTraceRule() {
+  // Frontmatter MUST be at byte 0. Machine-parseable JSON block at end of response.
+  return `---
+description: "Append a machine-parseable AW trace at the end of every response"
+alwaysApply: true
+---
+${GENERATED_MARKER}
+
+# AW Prompt Trace
+
+At the end of every substantive response, append a JSON-fenced block named \`aw-trace\` with the skills, rules, and MCPs that were loaded or applied during the response.
+
+## Format
+
+\`\`\`aw-trace
+{
+  "route": "/aw-plan",
+  "skills_used": ["using-aw-skills", "aw-plan", "incremental-implementation"],
+  "rules_applied": ["common-aw-routing", "universal", "security", "backend"],
+  "mcps_used": ["context7", "exa-search"],
+  "artifacts_written": [".aw_docs/features/<slug>/spec.md"]
+}
+\`\`\`
+
+## Field semantics
+
+| Field | Type | Required | Notes |
+|---|---|---|---|
+| \`route\` | string | yes | Selected AW route (e.g. \`/aw-plan\`, \`/aw-build\`) |
+| \`skills_used\` | string[] | yes | Skill names actually Read during the response. \`[]\` if none |
+| \`rules_applied\` | string[] | yes | Rule names from \`~/.cursor/rules/*.mdc\` or \`~/.aw_rules/\` that informed the response |
+| \`mcps_used\` | string[] | yes | MCP server names invoked. \`[]\` if none |
+| \`artifacts_written\` | string[] | optional | Files created or modified |
+
+## Rules
+
+- Always include the trace block — even for trivial responses (use \`[]\` for empty arrays).
+- Skill and rule names must match the on-disk basenames (no \`.mdc\` / \`.md\` extension).
+- The trace goes AFTER the substantive response, never before.
+- Do not include skills/rules that were merely "available" — only those that actually influenced this response.
+
+## Why
+
+This makes routing observable. Tools, audits, and compliance checks can parse the trace JSON to verify that the right AW routing happened (route selected → stage skill loaded → relevant rules applied) without scraping prose.
+`;
+}
+
 function generateCursorAwRoutingRule() {
   // Frontmatter MUST be at byte 0 for Cursor's alwaysApply/globs detection.
   return `---