bearings 0.5.4 → 0.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bearings",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Give your AI agents their bearings — scaffold an agent-friendly setup in any repository.",
   "type": "module",
   "engines": {

package/templates/agents/skills/checklist/SKILL.md

@@ -35,6 +35,13 @@ authored instructions; the static previewer owns execution state.
 
 ## Content Policy
 
+- **Show** every operator-facing field (`title`, `summary`, `intro`,
+  `callout`, `conventions`, section `intro`, `instruction`, `expectedResult`,
+  `warning`, `failureGuidance`, link `label`). The field is the action,
+  command, path, identifier, or observable. Lead with that object. Shortest
+  scannable structure: line, bullets, `codeBlocks`, exact value. Prose fields
+  render HTML (`<code>`, `<strong>`). Titles, chrome, and `codeBlocks` stay
+  plain text. ASD-STE100 Simplified Technical English for a reader with ADHD.
 - Organize sections in execution order and keep each checklist item to one
   primary action or verification. Use `info` sections for concise context that
   the operator does not mark as executed.
@@ -64,6 +71,7 @@ authored instructions; the static previewer owns execution state.
 ## Completion
 
 Finish only when exactly one authored checklist file exists for this request,
-its mechanics and outcomes trace to evidence, its validator prints `OK`, the
-full library build succeeds, and the static previewer opens or its absolute path
-is reported after an opening failure.
+its mechanics and outcomes trace to evidence, every operator-facing field
+leads with an action, command, path, identifier, or observable, its validator
+prints `OK`, the full library build succeeds, and the static previewer opens
+or its absolute path is reported after an opening failure.

package/templates/agents/skills/checklist/previewer/viewer.js

@@ -35,6 +35,12 @@
     return node;
   }
 
+  function html(tag, className, markup) {
+    var node = element(tag, className);
+    if (markup !== undefined) node.innerHTML = markup;
+    return node;
+  }
+
   function setStatus(message, isError) {
     status.textContent = message;
     status.dataset.tone = isError ? 'error' : 'info';
@@ -331,7 +337,7 @@
 
   function textBlock(className, label, value) {
     var block = element('div', 'step-block ' + className);
-    block.append(element('span', 'field-label', label), document.createTextNode(value));
+    block.append(element('span', 'field-label', label), html('div', '', value));
     return block;
   }
 
@@ -844,7 +850,7 @@
     var navigationList = element('ol', 'section-nav-list');
     navigation.append(navigationList);
     var checklistBody = element('div', 'checklist-body');
-    if (checklist.intro) checklistBody.append(element('p', 'intro', checklist.intro));
+    if (checklist.intro) checklistBody.append(html('div', 'intro', checklist.intro));
     if (checklist.callout) checklistBody.append(textBlock('callout', 'Important', checklist.callout));
     if (checklist.conventions) checklistBody.append(textBlock('conventions', 'Conventions', checklist.conventions));
 
@@ -856,7 +862,7 @@
       var heading = element('div', 'section-heading');
       heading.append(element('span', 'section-number', section.number), element('h2', '', section.title));
       sectionElement.append(heading);
-      if (section.intro) sectionElement.append(element('p', 'section-intro', section.intro));
+      if (section.intro) sectionElement.append(html('div', 'section-intro', section.intro));
       var items = element('div', 'items');
       section.items.forEach(function (item) { items.append(renderItem(item, section.kind, false, sectionIndex)); });
       sectionElement.append(items);