bobs-workshop 3.1.0 → 3.1.3

package/dist/tools/background-agent/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAGZ,MAAM,SAAS,CAAC;AAQjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB;IAOvD,OAAO;IAOD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;YAoC3C,SAAS;IA8FvB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/C,WAAW,IAAI,cAAc,EAAE;IAI/B,eAAe,IAAI,cAAc,EAAE;IAInC,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;YAuClE,eAAe;YAmCf,wBAAwB;IAoCtC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;YAOL,gBAAgB;IAkI9B,QAAQ,IAAI,IAAI;CAmBjB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/tools/background-agent/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAGZ,MAAM,SAAS,CAAC;AAyCjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB;IAOvD,OAAO;IAOD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;YAoC3C,SAAS;IAwGvB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/C,WAAW,IAAI,cAAc,EAAE;IAI/B,eAAe,IAAI,cAAc,EAAE;IAInC,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;YAuClE,eAAe;YAmCf,wBAAwB;IAoCtC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;YAOL,gBAAgB;IAkI9B,QAAQ,IAAI,IAAI;CAmBjB"}

package/dist/tools/background-agent/manager.js

@@ -1,6 +1,36 @@
 import { ConcurrencyManager } from "./concurrency";
 const TASK_TTL_MS = 30 * 60 * 1000; // 30 minutes
 const MIN_STABILITY_TIME_MS = 10 * 1000; // 10 seconds before stability detection
+const MAX_SYSTEM_CONTENT_LENGTH = 50000; // Maximum characters for system prompt
+const MAX_PROMPT_LENGTH = 10000; // Maximum characters for user prompt
+/**
+ * Sanitize content for safe JSON transmission to kimi model
+ * Handles Unicode issues, control characters, and length limits
+ */
+function sanitizeForModel(content, maxLength = MAX_SYSTEM_CONTENT_LENGTH) {
+    if (!content)
+        return "";
+    // Step 1: Remove control characters (keep only \n, \r, \t)
+    let sanitized = content
+        .replace(/[\x00-\x08\x0B-\x0C\x0E-\x1F]/g, '')
+        // Step 2: Replace Unicode line/paragraph separators
+        .replace(/\u2028/g, '\n')
+        .replace(/\u2029/g, '\n')
+        // Step 3: Replace other problematic Unicode
+        .replace(/\uFEFF/g, '') // BOM
+        .replace(/\u200B-\u200D/g, '') // Zero-width spaces
+        // Step 4: Escape backslashes to prevent JSON issues
+        .replace(/\\/g, '\\\\')
+        // Step 5: Normalize line endings
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n');
+    // Step 6: Truncate if too long (with indicator)
+    if (sanitized.length > maxLength) {
+        const truncationMsg = "\n\n[Content truncated due to length limits]";
+        sanitized = sanitized.substring(0, maxLength - truncationMsg.length) + truncationMsg;
+    }
+    return sanitized;
+}
 export class BackgroundManager {
     tasks;
     client;
@@ -89,7 +119,9 @@ export class BackgroundManager {
                 for (const skillName of input.skills) {
                     const skillPath = join(this.directory, ".opencode", "skill", "bobs-workshop", skillName, "SKILL.md");
                     if (existsSync(skillPath)) {
-                        const skillFile = readFileSync(skillPath, "utf8");
+                        let skillFile = readFileSync(skillPath, "utf8");
+                        // Sanitize content for kimi model compatibility
+                        skillFile = sanitizeForModel(skillFile, 10000); // Limit per skill
                         skillContent += `\n\n---\n## Skill: ${skillName}\n\n${skillFile}`;
                     }
                 }
@@ -98,12 +130,18 @@ export class BackgroundManager {
             if (input.manual_path) {
                 const { existsSync, readFileSync } = await import("node:fs");
                 if (existsSync(input.manual_path)) {
-                    const manualContent = readFileSync(input.manual_path, "utf8");
+                    let manualContent = readFileSync(input.manual_path, "utf8");
+                    // Sanitize content for kimi model compatibility
+                    manualContent = sanitizeForModel(manualContent, 30000); // Larger limit for manual
                     skillContent = skillContent
                         ? `${skillContent}\n\n## MANUAL Context:\n${manualContent}`
                         : manualContent;
                 }
             }
+            // Final sanitization of combined skill content
+            skillContent = sanitizeForModel(skillContent, MAX_SYSTEM_CONTENT_LENGTH);
+            // Sanitize user prompt to prevent JSON issues
+            const sanitizedPrompt = sanitizeForModel(input.prompt, MAX_PROMPT_LENGTH);
             // Fire-and-forget prompt
             this.client.session.prompt({
                 path: { id: sessionID },
@@ -115,7 +153,7 @@ export class BackgroundManager {
                         task: false,
                         delegate_task: false,
                     },
-                    parts: [{ type: "text", text: input.prompt }],
+                    parts: [{ type: "text", text: sanitizedPrompt }],
                 },
             }).catch((error) => {
                 console.error("[background-agent] Prompt error:", error);

package/dist/tools/manual/verify-manual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-manual.d.ts","sourceRoot":"","sources":["../../../src/tools/manual/verify-manual.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAErE,QAAA,MAAM,gBAAgB,EAAE,cAkDtB,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"verify-manual.d.ts","sourceRoot":"","sources":["../../../src/tools/manual/verify-manual.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAmCrE,QAAA,MAAM,gBAAgB,EAAE,cA4DtB,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/tools/manual/verify-manual.js

@@ -1,4 +1,33 @@
 import { tool } from "@opencode-ai/plugin/tool";
+const MAX_SYSTEM_CONTENT_LENGTH = 50000;
+/**
+ * Sanitize content for safe JSON transmission to kimi model
+ * Handles Unicode issues, control characters, and length limits
+ */
+function sanitizeForModel(content, maxLength = MAX_SYSTEM_CONTENT_LENGTH) {
+    if (!content)
+        return "";
+    // Step 1: Remove control characters (keep only \n, \r, \t)
+    let sanitized = content
+        .replace(/[\x00-\x08\x0B-\x0C\x0E-\x1F]/g, '')
+        // Step 2: Replace Unicode line/paragraph separators
+        .replace(/\u2028/g, '\n')
+        .replace(/\u2029/g, '\n')
+        // Step 3: Replace other problematic Unicode
+        .replace(/\uFEFF/g, '') // BOM
+        .replace(/[\u200B-\u200D]/g, '') // Zero-width spaces
+        // Step 4: Escape backslashes to prevent JSON issues
+        .replace(/\\/g, '\\\\')
+        // Step 5: Normalize line endings
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n');
+    // Step 6: Truncate if too long (with indicator)
+    if (sanitized.length > maxLength) {
+        const truncationMsg = "\n\n[Content truncated due to length limits]";
+        sanitized = sanitized.substring(0, maxLength - truncationMsg.length) + truncationMsg;
+    }
+    return sanitized;
+}
 const VerifyManualTool = tool({
     description: "Run bob-rev verification in background for a MANUAL",
     args: {
@@ -22,17 +51,23 @@ const VerifyManualTool = tool({
         let manualContent = "";
         if (existsSync(args.manual_path)) {
             manualContent = readFileSync(args.manual_path, "utf8");
+            // Sanitize content for kimi model compatibility
+            manualContent = sanitizeForModel(manualContent, 30000);
         }
         const skillPath = join(directory, ".opencode", "agent", "bobs-workshop", "bob-rev.md");
         let agentPrompt = "You are bob-rev, a reviewer agent that verifies implementation against MANUAL requirements.";
         if (existsSync(skillPath)) {
             agentPrompt = readFileSync(skillPath, "utf8");
+            // Sanitize agent prompt as well
+            agentPrompt = sanitizeForModel(agentPrompt, 20000);
         }
+        // Build and sanitize system prompt
+        const systemPrompt = sanitizeForModel(`${agentPrompt}\n\n## MANUAL to Verify:\n${manualContent}`, MAX_SYSTEM_CONTENT_LENGTH);
         await client.session.prompt({
             path: { id: createData.data.id },
             body: {
                 agent: "bob-rev",
-                system: `${agentPrompt}\n\n## MANUAL to Verify:\n${manualContent}`,
+                system: systemPrompt,
                 tools: {
                     task: false,
                     delegate_task: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bobs-workshop",
-  "version": "3.1.0",
+  "version": "3.1.3",
   "description": "MANUAL-driven development with background agents for OpenCode",
   "type": "module",
   "main": "./dist/plugins/bobs-workshop.js",

package/postinstall.js

@@ -16,7 +16,9 @@ const PACKAGE_NAME = 'bobs-workshop';
  * Skip when: global npm update, or running from within bobs-workshop repo itself.
  */
 function isInstalledAsDependencyInThisRepo() {
-  const projectRoot = process.cwd();
+  // Use INIT_CWD which npm sets to the directory where 'npm install' was invoked
+  // process.cwd() returns the package directory (node_modules/bobs-workshop/) during postinstall
+  const projectRoot = process.env.INIT_CWD || process.cwd();
   const pkgPath = join(projectRoot, 'package.json');
   if (!existsSync(pkgPath)) return false;
   let pkg;
@@ -68,7 +70,8 @@ function postinstall() {
     return; // Not a repo that depends on bobs-workshop (e.g. global update or bobs-workshop repo itself)
   }
 
-  const projectRoot = process.cwd();
+  // Use INIT_CWD to get the actual project directory where npm install was run
+  const projectRoot = process.env.INIT_CWD || process.cwd();
   const opencodeDir = join(projectRoot, '.opencode');
 
   console.log('🔧 Installing bobs-workshop...');

package/src/agents/alice.md

@@ -269,9 +269,9 @@ All requirements covered in one manual.
 
 **MANUAL Structure**:
 ```markdown
-# 📘 MANUAL: [Feature Name]
+# [MANUAL] MANUAL: [Feature Name]
 
-## 📊 Executive Summary
+##  Executive Summary
 **Feature**: [Concise description]
 **Business Value**: [Why this matters]
 **Effort Estimate**: [T-shirt size: S/M/L/XL]
@@ -282,7 +282,7 @@ All requirements covered in one manual.
 **Dependencies**: [Other features, external services, other manuals]
 **Part of Multi-Manual**: [Yes/No] - If Yes, specify: [folder path]
 
-## 📝 Product Specifications
+## [DOC] Product Specifications
 
 ### Problem Statement
 [Clear articulation of the problem being solved]
@@ -308,24 +308,24 @@ All requirements covered in one manual.
 - [What we explicitly will NOT do] - Reason: [Why deferred]
 - [What we explicitly will NOT do] - Reason: [Why deferred]
 
-## 🏗️ Architecture Analysis
+## [ARCH] Architecture Analysis
 
-### 🗄️ Database Architecture
+### [DB] Database Architecture
 [From Phase 2 exploration]
 
-### 🔧 Backend Architecture
+### [TOOL] Backend Architecture
 [From Phase 2 exploration]
 
-### 🔗 Integration Architecture
+### [LINK] Integration Architecture
 [From Phase 2 exploration]
 
-### 🎨 Frontend Architecture
+### [UI] Frontend Architecture
 [From Phase 2 exploration]
 
-### 🎯 UI/UX Considerations
+### [TARGET] UI/UX Considerations
 [From Phase 2 exploration]
 
-## 🚀 Implementation Plan
+## [LAUNCH] Implementation Plan
 
 ### Task Breakdown (Idempotent Tasks)
 
@@ -372,16 +372,16 @@ DB-001 → BE-001 → FE-001 → TEST-001
 ### Critical Path
 [Sequence of tasks determining minimum duration]
 
-## 📈 Execution Logs
+##  Execution Logs
 [To be filled by bob]
 
-## 🔍 Review Notes
+## [SEARCH] Review Notes
 [To be filled by bob-rev]
 
-## 🐛 Debug Logs
+## [BUG] Debug Logs
 [To be filled by trace]
 
-## ✅ Verification Logs
+## YES Verification Logs
 [To be filled by bob-send]
 
 ## 🤝 Agent Handoffs

package/src/agents/bob-rev.md

@@ -54,7 +54,6 @@ Issue a PASS or FAIL verdict with evidence using parallel background analysis.
 - clean-code - Use when evaluating code maintainability and best practices
 - code-review-checklist - Use when conducting thorough code reviews
 - testing-patterns - Use when verifying test coverage and test quality
-- verification - Use when validating implementation against MANUAL specifications
 
 ## Custom Tools
 - background_agent - Use for launching parallel verification tasks (security, performance, quality)
@@ -87,9 +86,9 @@ Verify:
 
 | Type | ID | Status | Evidence |
 |------|-----|--------|----------|
-| FR | FR-001 | ✅/❌ | [File:line] |
-| FR | FR-002 | ✅/❌ | [File:line] |
-| US | US-001 | ✅/❌ | [File:line] |
+| FR | FR-001 | YES/NO | [File:line] |
+| FR | FR-002 | YES/NO | [File:line] |
+| US | US-001 | YES/NO | [File:line] |
 
 ### Scope Creep Check
 - [ ] No unauthorized features added
@@ -183,14 +182,14 @@ const qualityResult = background_output({ task_id: "[quality_task_id]" });
 **Step 2: Apply Decision Rules**
 
 **PASS requires**:
-- ✅ Manual compliance (from Phase 1)
-- ✅ No critical security issues
-- ✅ No more than 2 high-severity issues total
+- YES Manual compliance (from Phase 1)
+- YES No critical security issues
+- YES No more than 2 high-severity issues total
 
 **FAIL if**:
-- ❌ Any manual compliance violation
-- ❌ Any critical security vulnerability
-- ❌ More than 2 high-severity issues
+- NO Any manual compliance violation
+- NO Any critical security vulnerability
+- NO More than 2 high-severity issues
 
 **Evidence-Based Reporting Criteria**:
 
@@ -220,9 +219,9 @@ Use `manual_update` tool:
 ```typescript
 manual_update({
   manual_path: "manuals/MANUAL-[date]-[feature].md",
-  section: "🔍 Review Notes",
+  section: "[SEARCH] Review Notes",
   content: `
-## 🔍 Review Notes
+## [SEARCH] Review Notes
 
 **Reviewed**: [YYYY-MM-DD HH:MM]
 **Reviewer**: bob-rev
@@ -251,7 +250,7 @@ manual_update({
 
 ### Decision
 
-## 🎯 VERDICT: [PASS ✅ / FAIL ❌]
+## [TARGET] VERDICT: [PASS YES / FAIL NO]
 
 **Rationale**: [1-2 sentence explanation]
   `
@@ -266,7 +265,7 @@ manual_update({
 **VERIFY Phase Complete**
 
 **MANUAL**: \`manuals/MANUAL-[date]-[feature].md\`
-**Verdict**: [✅ PASS / ❌ FAIL]
+**Verdict**: [YES PASS / NO FAIL]
 
 [If PASS]
 All criteria met. Ready for SEND phase.

package/src/agents/bob-send.md

@@ -40,7 +40,6 @@ Run lint, test, and build checks. If all pass, write commit message and commit t
 
 
 ## Available Skills
-- verification - Use when running final quality checks before shipping
 
 ## Custom Tools
 - manual_update - Use when writing Verification Logs to MANUAL after successful commit
@@ -145,9 +144,9 @@ Use `manual_update` tool:
 ```typescript
 manual_update({
   manual_path: "manuals/MANUAL-[date]-[feature].md",
-  section: "✅ Verification Logs",
+  section: "YES Verification Logs",
   content: `
-## ✅ Verification Logs
+## YES Verification Logs
 
 **Shipped**: [YYYY-MM-DD HH:MM]
 **Reviewer**: bob-send
@@ -156,9 +155,9 @@ manual_update({
 ### Check Results
 | Check | Status | Notes |
 |-------|--------|-------|
-| Lint | ✅ PASS | 0 errors |
-| Tests | ✅ PASS | All tests passed |
-| Build | ✅ PASS | Build successful |
+| Lint | YES PASS | 0 errors |
+| Tests | YES PASS | All tests passed |
+| Build | YES PASS | Build successful |
 
 ### Commit
 **Commit Hash**: [hash]
@@ -169,7 +168,7 @@ manual_update({
 ${commitMessage}
 \`\`\`
 
-**Feature shipped successfully!** 🚀
+**Feature shipped successfully!** [LAUNCH]
   `
 });
 ```
@@ -187,12 +186,12 @@ ${commitMessage}
 **Commit**: [hash]
 
 ### Summary
-- Lint: ✅
-- Tests: ✅
-- Build: ✅
-- Commit: ✅
+- Lint: YES
+- Tests: YES
+- Build: YES
+- Commit: YES
 
-**Feature shipped to current branch!** 🚀
+**Feature shipped to current branch!** [LAUNCH]
 ```
 
 ---
@@ -240,9 +239,9 @@ ${commitMessage}
 ```
 
 CHECKS PASSED
-Lint: ✅
-Tests: ✅
-Build: ✅
+Lint: YES
+Tests: YES
+Build: YES
 Commit: [hash]
 Branch: [current branch]
 Verification Logs: Updated

package/src/agents/bob.md

@@ -22,8 +22,7 @@ tools:
   list_background_tasks: true
   background_output: true
   background_cancel: true
-  verify_manual: true
-  lsp_goto_definition: true
+    lsp_goto_definition: true
   lsp_find_references: true
   lsp_symbols: true
   lsp_diagnostics: true
@@ -53,7 +52,6 @@ Implementation and orchestration agent.
 - list_background_tasks - Use to check status of running background tasks
 - background_output - Use to collect results from completed background tasks
 - background_cancel - Use to cancel running background tasks
-- verify_manual - Use to verify MANUAL completion and compliance
 
 ---
 
@@ -86,7 +84,7 @@ Implement MANUAL-defined tasks exactly and route work to verification and shippi
 ## MANUAL Validation
 
 **MANUAL**: manuals/MANUAL-[date]-[feature].md
-**Validation Status**: ✅ VALID / ❌ INVALID
+**Validation Status**: YES VALID / NO INVALID
 
 **Required Sections**:
 - [ ] Executive Summary
@@ -174,7 +172,7 @@ DB-001 → BE-001 → FE-001 → TEST-001
 
 #### Step 1: Announce Layer Start
 ```markdown
-### 📊 Layer: [Layer Name]
+###  Layer: [Layer Name]
 **Started**: [YYYY-MM-DD HH:MM]
 **Tasks to Execute**: [N]
 **Dependencies Met**: [Yes/No]
@@ -192,31 +190,31 @@ DB-001 → BE-001 → FE-001 → TEST-001
 
 **Log Format**:
 ```markdown
-### ✅ Task: [TASK-ID] - [Description]
+### YES Task: [TASK-ID] - [Description]
 **Completed**: [YYYY-MM-DD HH:MM]
 **Files Modified**:
 - `[file1.ts]`: [What changed]
 - `[file2.ts]`: [What changed]
 **Implementation Notes**: [Any relevant details]
-**Idempotency Verified**: ✓
+**Idempotency Verified**: YES
 ```
 
 **On Task Failure**:
 ```markdown
-### ❌ Task Failed: [TASK-ID] - [Description]
+### NO Task Failed: [TASK-ID] - [Description]
 **Failed**: [YYYY-MM-DD HH:MM]
 **Error**: [Exact error message]
 **Files Affected**: [List of files]
 **Attempted Approach**: [What was tried]
 
-⚠️ LAYER EXECUTION HALTED - Awaiting intervention
+WARNING LAYER EXECUTION HALTED - Awaiting intervention
 ```
 
 **STOP execution immediately on task failure.**
 
 #### Step 3: Mark Layer Complete
 ```markdown
-### ✅ Layer Complete: [Layer Name]
+### YES Layer Complete: [Layer Name]
 **Completed**: [YYYY-MM-DD HH:MM]
 **Tasks Completed**: [N/N]
 **Files Modified**: [Total count]
@@ -247,18 +245,18 @@ background_output(task_id="[task_id_from_delegate]")
 
 **If PASS**:
 ```markdown
-### 🔍 Layer Verification: PASS
+### [SEARCH] Layer Verification: PASS
 **Layer**: [Layer Name]
 **Verified**: [YYYY-MM-DD HH:MM]
 **Reviewer**: bob-rev
 **Issues Found**: None
 
-✅ Proceed to next layer
+YES Proceed to next layer
 ```
 
 **If FAIL**:
 ```markdown
-### 🔍 Layer Verification: FAIL
+### [SEARCH] Layer Verification: FAIL
 **Layer**: [Layer Name]
 **Verified**: [YYYY-MM-DD HH:MM]
 **Reviewer**: bob-rev
@@ -268,7 +266,7 @@ background_output(task_id="[task_id_from_delegate]")
 1. [Issue 1] - [File:line]
 2. [Issue 2] - [File:line]
 
-⚠️ LAYER REQUIRES FIXES - Awaiting intervention
+WARNING LAYER REQUIRES FIXES - Awaiting intervention
 ```
 
 **On Layer Verification FAIL**:

package/src/agents/trace.md

@@ -76,7 +76,7 @@ When invoked, you receive:
 
 **Issue**: [Issue description or TASK-ID]
 **MANUAL**: manuals/MANUAL-[date]-[feature].md
-**Input Status**: ✅ VALID / ❌ INVALID
+**Input Status**: YES VALID / NO INVALID
 
 **Validation Checklist**:
 - [ ] MANUAL path exists and is readable
@@ -322,7 +322,7 @@ Use `edit` tool to apply minimal changes:
 You MUST update the MANUAL's Debug Logs section:
 
 ```markdown
-## 🐛 Debug Logs
+## [BUG] Debug Logs
 
 ### Trace Session: [YYYY-MM-DD HH:MM]
 **Trace Agent**: trace

package/src/skills/api-patterns/SKILL.md

@@ -35,11 +35,11 @@ description: API design principles and decision-making. REST vs GraphQL vs tRPC
 ### Decision Matrix
 | Factor | REST | GraphQL | tRPC | gRPC |
 |--------|-------|----------|-------|-------|
-| Simplicity | ✅ High | ⚠️ Medium | ✅ High | ⚠️ Medium |
-| Type Safety | ❌ Low | ⚠️ Medium | ✅ High | ✅ High |
-| Performance | ⚠️ Medium | ⚠️ Medium | ✅ High | ✅ High |
-| Ecosystem | ✅ Large | ✅ Large | ⚠️ Growing | ✅ Large |
-| Caching | ✅ Easy | ❌ Hard | ❌ Hard | ⚠️ Medium |
+| Simplicity | YES High | WARNING Medium | YES High | WARNING Medium |
+| Type Safety | NO Low | WARNING Medium | YES High | YES High |
+| Performance | WARNING Medium | WARNING Medium | YES High | YES High |
+| Ecosystem | YES Large | YES Large | WARNING Growing | YES Large |
+| Caching | YES Easy | NO Hard | NO Hard | WARNING Medium |
 ```
 
 ---
@@ -50,20 +50,20 @@ description: API design principles and decision-making. REST vs GraphQL vs tRPC
 
 | Rule | Example |
 |------|---------|
-| **Use nouns, not verbs** | ✅ `/users`, ❌ `/getUsers` |
-| **Plural nouns** | ✅ `/users`, ❌ `/user` |
-| **Nest resources** | ✅ `/users/123/posts`, ❌ `/posts?user=123` |
-| **Lowercase with hyphens** | ✅ `/user-preferences`, ❌ `/userPreferences` |
+| **Use nouns, not verbs** | YES `/users`, NO `/getUsers` |
+| **Plural nouns** | YES `/users`, NO `/user` |
+| **Nest resources** | YES `/users/123/posts`, NO `/posts?user=123` |
+| **Lowercase with hyphens** | YES `/user-preferences`, NO `/userPreferences` |
 
 ### HTTP Methods
 
 | Method | Use | Safe | Idempotent |
 |--------|-----|-------|------------|
-| **GET** | Read resources | ✅ Yes | ✅ Yes |
-| **POST** | Create resource | ❌ No | ❌ No |
-| **PUT** | Replace resource | ❌ No | ✅ Yes |
-| **PATCH** | Partial update | ❌ No | ❌ No |
-| **DELETE** | Delete resource | ❌ No | ✅ Yes |
+| **GET** | Read resources | YES Yes | YES Yes |
+| **POST** | Create resource | NO No | NO No |
+| **PUT** | Replace resource | NO No | YES Yes |
+| **PATCH** | Partial update | NO No | NO No |
+| **DELETE** | Delete resource | NO No | YES Yes |
 
 ### Status Codes
 
@@ -304,7 +304,7 @@ This skill is used by **alice (architect)** agent during PLAN phase and **bob-en
 
 Add API section to MANUAL:
 ```markdown
-## 🏗️ Architecture Analysis
+## [ARCH] Architecture Analysis
 
 ### API Design
 

package/src/skills/architecture/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 > "Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
 
-## 🎯 Selective Reading Rule
+## [TARGET] Selective Reading Rule
 
 **Read ONLY files relevant to the request!** Check the content map, find what you need.
 
@@ -24,7 +24,7 @@ metadata:
 
 ---
 
-## 🔗 Related Skills
+## [LINK] Related Skills
 
 | Skill | Use For |
 |-------|---------|
@@ -149,7 +149,7 @@ Before finalizing architecture:
 
 ## Anti-Patterns
 
-| ❌ Don't | ✅ Do |
+| NO Don't | YES Do |
 |----------|-------|
 | Start with microservices | Start with monolith, split when needed |
 | Use complex patterns because "cool" | Use simplest solution that works |
@@ -168,7 +168,7 @@ This skill is used by **alice (architect)** agent during PLAN phase.
 
 Add architecture section to MANUAL:
 ```markdown
-## 🏗️ Architecture Analysis
+## [ARCH] Architecture Analysis
 
 ### Project Classification
 - **Type:** [MVP / SaaS / Enterprise / Internal Tool]