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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.39-beta.13",
+  "version": "0.1.39-beta.14",
   "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 `---