aios-core 4.2.14 → 4.3.0

package/.aios-core/data/tool-search-validation.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+// =============================================================================
+// Tool Search Validation Script
+// =============================================================================
+// Validates that tool-registry.yaml keywords align with expected tool search
+// queries. This is a static validation — actual Tool Search latency and accuracy
+// are measured during interactive Claude Code sessions.
+//
+// Story: TOK-2 (AC: 5, 6, 7)
+// =============================================================================
+
+const fs = require('fs');
+const path = require('path');
+
+const REGISTRY_PATH = path.resolve(__dirname, 'tool-registry.yaml');
+
+// Test queries that should find specific tools (AC 7: 5+ test queries)
+const TEST_QUERIES = [
+  { query: 'search the web for information', expectedTool: 'exa', category: 'web-search' },
+  { query: 'browser screenshot automation', expectedTool: 'playwright', category: 'browser-automation' },
+  { query: 'scrape social media data', expectedTool: 'apify', category: 'web-scraping' },
+  { query: 'analyze code dependencies', expectedTool: 'code-graph', category: 'code-intelligence' },
+  { query: 'code analysis intelligence', expectedTool: 'nogic', category: 'code-intelligence' },
+  { query: 'look up library documentation', expectedTool: 'context7', category: 'documentation' },
+  { query: 'database query optimization', expectedTool: 'supabase', category: 'database' }
+];
+
+function parseKeywords(content) {
+  // Extract tool name → keywords mapping from YAML
+  const tools = {};
+  let currentTool = null;
+  let inKeywords = false;
+
+  for (const line of content.split('\n')) {
+    // Tool name (indented 2 spaces)
+    const toolMatch = line.match(/^ {2}([a-zA-Z0-9_-]+):$/);
+    if (toolMatch) {
+      currentTool = toolMatch[1];
+      tools[currentTool] = { keywords: [], category: null, tier: null, essential: null };
+      inKeywords = false;
+      continue;
+    }
+
+    if (!currentTool) continue;
+
+    // Category
+    const catMatch = line.match(/^\s+category:\s*(.+)/);
+    if (catMatch) {
+      tools[currentTool].category = catMatch[1].trim();
+      continue;
+    }
+
+    // Tier
+    const tierMatch = line.match(/^\s+tier:\s*(\d)/);
+    if (tierMatch) {
+      tools[currentTool].tier = parseInt(tierMatch[1]);
+      continue;
+    }
+
+    // Essential
+    const essentialMatch = line.match(/^\s+essential:\s*(true|false)/);
+    if (essentialMatch) {
+      tools[currentTool].essential = essentialMatch[1] === 'true';
+      continue;
+    }
+
+    // Keywords section
+    if (line.match(/^\s+keywords:/)) {
+      inKeywords = true;
+      continue;
+    }
+
+    // Keyword item
+    if (inKeywords) {
+      const kwMatch = line.match(/^\s+- (.+)/);
+      if (kwMatch) {
+        tools[currentTool].keywords.push(kwMatch[1].trim());
+      } else if (!line.match(/^\s*$/)) {
+        inKeywords = false;
+      }
+    }
+  }
+
+  return tools;
+}
+
+function matchQuery(query, tool) {
+  const queryWords = query.toLowerCase().split(/\s+/);
+  const keywords = tool.keywords.map(k => k.toLowerCase());
+  const category = (tool.category || '').toLowerCase();
+
+  let score = 0;
+  for (const word of queryWords) {
+    for (const keyword of keywords) {
+      if (keyword.includes(word) || word.includes(keyword)) {
+        score++;
+      }
+    }
+    if (category.includes(word)) {
+      score++;
+    }
+  }
+
+  return score;
+}
+
+function validate() {
+  const content = fs.readFileSync(REGISTRY_PATH, 'utf8');
+  const tools = parseKeywords(content);
+
+  console.log('=== Tool Search Validation ===\n');
+
+  let passed = 0;
+  let failed = 0;
+
+  for (const test of TEST_QUERIES) {
+    const scores = {};
+    for (const [name, tool] of Object.entries(tools)) {
+      if (tool.keywords.length > 0 || tool.category) {
+        scores[name] = matchQuery(test.query, tool);
+      }
+    }
+
+    // Sort by score descending
+    const ranked = Object.entries(scores)
+      .filter(([, score]) => score > 0)
+      .sort((a, b) => b[1] - a[1]);
+
+    const top3 = ranked.slice(0, 3).map(([name]) => name);
+    const found = top3.includes(test.expectedTool);
+
+    if (found) {
+      console.log(`✅ "${test.query}" → found '${test.expectedTool}' in top-3 [${top3.join(', ')}]`);
+      passed++;
+    } else {
+      console.log(`❌ "${test.query}" → expected '${test.expectedTool}' but got [${top3.join(', ')}]`);
+      failed++;
+    }
+  }
+
+  console.log(`\n--- Results: ${passed}/${TEST_QUERIES.length} passed, ${failed} failed ---`);
+
+  // Essential server validation
+  console.log('\n=== Essential Server Validation ===\n');
+  const tier3Tools = Object.entries(tools).filter(([, t]) => t.tier === 3);
+  const essential = tier3Tools.filter(([, t]) => t.essential === true);
+  const nonEssential = tier3Tools.filter(([, t]) => t.essential === false);
+
+  console.log(`Tier 3 tools: ${tier3Tools.length}`);
+  console.log(`  Essential (never disable): ${essential.map(([n]) => n).join(', ')}`);
+  console.log(`  Non-essential (can disable): ${nonEssential.map(([n]) => n).join(', ')}`);
+
+  if (essential.length === 0) {
+    console.log('⚠️  WARNING: No essential Tier 3 servers defined');
+  }
+
+  // 2-search-per-turn validation (AC 6)
+  console.log('\n=== Search Limit Guidance ===\n');
+  console.log('AC 6: Maximum 2 tool searches per turn');
+  console.log('Implementation: CLAUDE.md guidance section (not programmatic hard limit)');
+  console.log('Rationale: Claude Code manages Tool Search internally; guidance limits excessive use');
+
+  const allPassed = failed === 0;
+  console.log(`\n${allPassed ? '✅' : '❌'} Overall: ${allPassed ? 'PASS' : 'FAIL'}`);
+
+  return allPassed;
+}
+
+if (require.main === module) {
+  const result = validate();
+  process.exit(result ? 0 : 1);
+}
+
+module.exports = { validate };

package/.aios-core/development/agents/analyst/MEMORY.md

@@ -0,0 +1,33 @@
+# Analyst Agent Memory (Atlas)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Key Patterns
+- CommonJS (`require`/`module.exports`), NOT ES Modules
+- ES2022, Node.js 18+, 2-space indent, single quotes
+- Absolute imports always (never relative `../`)
+- kebab-case for files, PascalCase for components
+
+### Project Structure
+- `.aios-core/core/` — Core modules (synapse, session, code-intel, orchestration)
+- `.aios-core/development/` — Agents, tasks, templates, scripts
+- `docs/research/` — Research outputs (YYYY-MM-DD-slug format)
+- `docs/stories/` — Story files (active development)
+
+### Git Rules
+- NEVER push — delegate to @devops
+- Conventional commits: `feat:`, `fix:`, `docs:`, `test:`, `chore:`, `refactor:`
+
+### Research Conventions
+- Output dir: `docs/research/{YYYY-MM-DD}-{slug}/`
+- Use tech-search skill for deep research
+- Always include sources and methodology
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/architect/MEMORY.md

@@ -0,0 +1,39 @@
+# Architect Agent Memory (Aria)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Architecture Decisions
+- CLI First > Observability > UI (Constitution Article I)
+- Task-First: Tasks define WHAT, executors are interchangeable
+- Provider-agnostic code-intel layer (Code Graph MCP primary)
+- SYNAPSE 8-layer context engine (L0-L2 active, L3-L7 disabled per NOG-18)
+
+### Key Architectural Patterns
+- Tiered loading in UAP: Critical (80ms) → High (120ms) → Best-effort (180ms)
+- Circuit breaker for external providers (code-intel, MCP)
+- Atomic writes for file persistence (`atomicWriteSync`)
+- ideSync for cross-IDE agent distribution
+
+### Technology Stack
+- Node.js 18+, CommonJS, ES2022
+- Jest 30.2.0, ESLint, Prettier
+- Supabase (database), Vercel (hosting)
+
+### Delegation Rules
+- Database schema design → @data-engineer
+- Git push/PR → @devops
+- Implementation → @dev
+
+### Project Structure
+- `.aios-core/core/` — Engine modules
+- `docs/architecture/` — Architecture docs
+- `docs/prd/` — Sharded PRDs
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/data-engineer/MEMORY.md

@@ -0,0 +1,32 @@
+# Data Engineer Agent Memory (Dara)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Key Patterns
+- CommonJS (`require`/`module.exports`), NOT ES Modules
+- ES2022, Node.js 18+, 2-space indent, single quotes
+- Absolute imports always (never relative `../`)
+- kebab-case for files, PascalCase for components
+
+### Project Structure
+- `.aios-core/core/` — Core modules
+- `packages/db/` — Database packages (if applicable)
+- `tests/` — Test suites (mirrors source structure)
+
+### Git Rules
+- NEVER push — delegate to @devops
+- Conventional commits: `feat:`, `fix:`, `docs:`, `test:`
+
+### Database Conventions
+- Schema design follows architect decisions
+- RLS policies for row-level security
+- Migration scripts with rollback procedures
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/dev/MEMORY.md

@@ -0,0 +1,46 @@
+# Dev Agent Memory (Dex)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Key Patterns
+- CommonJS (`require`/`module.exports`), NOT ES Modules
+- ES2022, Node.js 18+, 2-space indent, single quotes
+- Absolute imports always (never relative `../`)
+- kebab-case for files, PascalCase for components
+- Jest 30.2.0 for testing, `npm test` to run
+
+### Project Structure
+- `.aios-core/core/` — Core modules (synapse, session, code-intel, orchestration)
+- `.aios-core/development/` — Agents, tasks, templates, scripts
+- `.aios-core/infrastructure/` — CI/CD, git detection, project-status
+- `tests/` — Test suites (mirrors source structure)
+- `docs/stories/` — Story files (active development)
+
+### Git Rules
+- NEVER push — delegate to @devops
+- Conventional commits: `feat:`, `fix:`, `docs:`, `test:`, `chore:`, `refactor:`
+- Reference story: `feat: implement feature [Story NOG-18]`
+
+### Common Gotchas
+- Windows paths: use forward slashes in code, bash shell not cmd
+- `fs.existsSync` for sync checks, `fs.promises` for async
+- atomicWriteSync from `.aios-core/core/synapse/utils/atomic-write` for safe file writes
+- CodeRabbit runs in WSL, not Windows directly
+
+### Story Workflow
+- Read task → Implement → Write tests → Validate → Mark checkbox [x]
+- ONLY update: checkboxes, Debug Log, Completion Notes, Change Log, File List
+- NEVER modify: Status, Story, AC, Dev Notes, Testing sections
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+- **NEVER push — delegate to @devops** | Source: dev, analyst, sm, data-engineer, ux, qa (6 agents) | Detected: 2026-02-22 | Status: Already elevated to `.claude/rules/agent-authority.md`
+- **CommonJS module system (require/module.exports)** | Source: dev, analyst, sm, data-engineer, ux, architect (6 agents) | Detected: 2026-02-22 | Status: Already in CLAUDE.md (Padroes de Codigo)
+- **Conventional commits format** | Source: dev, devops, analyst, sm, data-engineer, ux (6 agents) | Detected: 2026-02-22 | Status: Already in CLAUDE.md (Convencoes Git)
+- **kebab-case for files** | Source: dev, analyst, sm, data-engineer, ux (5 agents) | Detected: 2026-02-22 | Status: Already in CLAUDE.md (Padroes de Codigo)
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/dev.md

@@ -319,7 +319,7 @@ dependencies:
       max_iterations = 2
 
       WHILE iteration < max_iterations:
-        1. Run: wsl bash -c 'cd /mnt/c/.../@synkra/aios-core && ~/.local/bin/coderabbit --prompt-only -t uncommitted'
+        1. Run: wsl bash -c 'cd /mnt/c/.../aios-core && ~/.local/bin/coderabbit --prompt-only -t uncommitted'
         2. Parse output for CRITICAL issues
 
         IF no CRITICAL issues:

package/.aios-core/development/agents/devops/MEMORY.md

@@ -0,0 +1,39 @@
+# DevOps Agent Memory (Gage)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Exclusive Authority
+- ONLY agent authorized for `git push`, `gh pr create`, `gh pr merge`
+- ONLY agent for MCP infrastructure management
+- Pre-push quality gates are MANDATORY
+
+### Quality Gates (Pre-Push)
+1. `npm run lint` — ESLint must PASS
+2. `npm test` — Jest must PASS
+3. CodeRabbit review — 0 CRITICAL issues
+4. Story status = "Done" or "Ready for Review"
+5. No uncommitted changes, no merge conflicts
+
+### Git Conventions
+- Conventional Commits: `feat:`, `fix:`, `docs:`, `test:`, `chore:`
+- Branch patterns: `feat/*`, `fix/*`, `docs/*`
+- Semantic versioning: MAJOR.MINOR.PATCH
+
+### MCP Infrastructure
+- Docker MCP Gateway on port 8080
+- Servers: context7, desktop-commander, playwright, exa
+- Config: `~/.docker/mcp/catalogs/docker-mcp.yaml`
+- Known bug: Docker MCP secrets don't interpolate (use hardcoded values)
+
+### Repository Detection
+- Uses `repository-detector.js` for dynamic context
+- Framework-dev vs project-dev mode detection
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/devops.md

@@ -156,6 +156,13 @@ commands:
   - name: cleanup
     visibility: [full, quick]
     description: 'Identify and remove stale branches/files'
+  - name: triage-issues
+    visibility: [full, quick, key]
+    description: 'Analyze open GitHub issues, classify, prioritize, recommend next'
+  - name: resolve-issue
+    visibility: [full, quick, key]
+    args: '{issue_number}'
+    description: 'Investigate and resolve a GitHub issue end-to-end'
   - name: init-project-status
     visibility: [full]
     description: 'Initialize dynamic project status tracking (Story 6.1.2.4)'
@@ -180,6 +187,9 @@ commands:
   - name: setup-mcp-docker
     visibility: [full]
     description: 'Initial Docker MCP Toolkit configuration [Story 5.11]'
+  - name: health-check
+    visibility: [full, quick, key]
+    description: 'Run unified health diagnostic (aios doctor --json + governance interpretation)'
   - name: check-docs
     visibility: [full, quick]
     description: 'Verify documentation links integrity (broken, incorrect markings)'
@@ -239,8 +249,13 @@ dependencies:
     - list-mcps.md
     - remove-mcp.md
     - setup-mcp-docker.md
+    # Health Diagnostic (INS-4.8)
+    - health-check.yaml
     # Documentation Quality
     - check-docs-links.md
+    # GitHub Issues Management
+    - triage-github-issues.md
+    - resolve-github-issue.md
     # Worktree Management (Story 1.3-1.4)
     - create-worktree.md
     - list-worktrees.md
@@ -426,10 +441,16 @@ autoClaude:
 - `*detect-repo` - Detect repository context
 - `*cleanup` - Remove stale branches
 
+**GitHub Issues:**
+
+- `*triage-issues` - Analyze and prioritize open issues
+- `*resolve-issue {number}` - Investigate and resolve an issue end-to-end
+
 **Quality & Push:**
 
 - `*pre-push` - Run all quality gates
 - `*push` - Push changes after quality gates
+- `*health-check` - Run health diagnostic (15 checks + governance)
 
 **GitHub Operations:**
 
@@ -467,6 +488,7 @@ Type `*help` to see all commands.
 - CI/CD configuration (GitHub Actions)
 - Release management and versioning
 - Repository cleanup
+- Environment health diagnostics (`*health-check`)
 
 ### Prerequisites
 

package/.aios-core/development/agents/pm/MEMORY.md

@@ -0,0 +1,38 @@
+# PM Agent Memory (Morgan)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Responsibilities
+- PRD creation (greenfield + brownfield)
+- Epic creation and management
+- Product strategy and roadmap
+- Requirements gathering (spec pipeline)
+
+### Epic Orchestration
+- `*execute-epic` with `EPIC-{ID}-EXECUTION.yaml`
+- State tracked in `.aios/epic-{epicId}-state.yaml`
+- Wave-based parallel execution
+
+### Delegation
+- Story creation → @sm (`*draft`)
+- Course correction → @aios-master (`*correct-course`)
+- Deep research → @analyst (`*research`)
+
+### Bob Mode (user_profile=bob)
+- PM acts as orchestrator when `user_profile: bob`
+- Spawns other agents via TerminalSpawner
+- Session state persistence in `.aios/bob-session/`
+
+### Key Locations
+- PRD: `docs/prd/` (sharded)
+- Epics: `docs/stories/epics/`
+- Templates: `.aios-core/development/templates/`
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/po/MEMORY.md

@@ -0,0 +1,45 @@
+# PO Agent Memory (Pax)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Responsibilities
+- Story validation (`*validate-story-draft`) — 10-point checklist
+- Backlog management and prioritization
+- Story lifecycle: Draft → Ready transition (MUST update status)
+- Epic context tracking
+
+### Validation Checklist (10 Points)
+1. Clear title
+2. Complete description
+3. Testable AC (Given/When/Then)
+4. Defined scope (IN/OUT)
+5. Dependencies mapped
+6. Complexity estimate
+7. Business value
+8. Risks documented
+9. Criteria of Done
+10. PRD/Epic alignment
+
+### Story File Permissions
+- CAN edit: QA Results section (when reviewing)
+- MUST update: Status field (Draft → Ready on GO)
+- CANNOT modify: AC, Scope, Title, Dev Notes, Testing
+
+### Delegation
+- Story creation → @sm (`*draft`)
+- Epic creation → @pm (`*create-epic`)
+- Course correction → @aios-master
+
+### Key Locations
+- Stories: `docs/stories/`
+- Backlog: `docs/stories/backlog/`
+- Templates: `.aios-core/development/templates/story-tmpl.yaml`
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/qa/MEMORY.md

@@ -0,0 +1,42 @@
+# QA Agent Memory (Quinn)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Review Patterns
+- ONLY update "QA Results" section in story files
+- Gate decisions: PASS / CONCERNS / FAIL / WAIVED
+- CodeRabbit self-healing: max 3 iterations, CRITICAL+HIGH auto-fix
+
+### Test Infrastructure
+- `npm test` — Jest 30.2.0
+- `npm run lint` — ESLint
+- Tests location: `tests/` directory, mirrors source structure
+- Coverage: `npm run test:coverage`
+
+### Quality Checks (7-point)
+1. Code review (patterns, readability)
+2. Unit tests (coverage, passing)
+3. Acceptance criteria met
+4. No regressions
+5. Performance acceptable
+6. Security (OWASP basics)
+7. Documentation updated
+
+### Common Issues
+- Windows path separators in test assertions
+- CodeRabbit WSL execution: `wsl bash -c 'cd /mnt/c/... && ~/.local/bin/coderabbit ...'`
+- SYNAPSE metrics at `.synapse/metrics/`
+- Pipeline benchmarks at `tests/synapse/benchmarks/`
+
+### Git Rules
+- Read-only: `git status`, `git log`, `git diff`
+- NEVER commit or push
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/qa.md

@@ -266,7 +266,7 @@ dependencies:
       max_iterations = 3
 
       WHILE iteration < max_iterations:
-        1. Run: wsl bash -c 'cd /mnt/c/.../@synkra/aios-core && ~/.local/bin/coderabbit --prompt-only -t committed --base main'
+        1. Run: wsl bash -c 'cd /mnt/c/.../aios-core && ~/.local/bin/coderabbit --prompt-only -t committed --base main'
         2. Parse output for all severity levels
 
         critical_issues = filter(output, severity == "CRITICAL")

package/.aios-core/development/agents/sm/MEMORY.md

@@ -0,0 +1,31 @@
+# Scrum Master Agent Memory (River)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Key Patterns
+- CommonJS (`require`/`module.exports`), NOT ES Modules
+- ES2022, Node.js 18+, 2-space indent, single quotes
+- kebab-case for files, PascalCase for components
+
+### Project Structure
+- `docs/stories/epics/` — Epic directories with INDEX.md + stories
+- `.aios-core/development/templates/` — Story templates
+- `.aios-core/development/checklists/` — Draft checklists
+
+### Git Rules
+- NEVER push — delegate to @devops
+- Conventional commits: `docs:` for story creation
+
+### Story Conventions
+- Story naming: `story-{PREFIX}-{N}-{slug}.md`
+- Epic INDEX.md tracks all stories with status
+- Stories flow: Draft → Ready → InProgress → InReview → Done
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/agents/ux/MEMORY.md

@@ -0,0 +1,31 @@
+# UX Design Expert Agent Memory (Uma)
+
+## Active Patterns
+<!-- Current, verified patterns used by this agent -->
+
+### Key Patterns
+- CommonJS (`require`/`module.exports`), NOT ES Modules
+- ES2022, Node.js 18+, 2-space indent, single quotes
+- kebab-case for files, PascalCase for components
+
+### Project Structure
+- `.aios-core/core/` — Core modules
+- `docs/` — Documentation and design specs
+- `packages/` — Shared packages
+
+### Git Rules
+- NEVER push — delegate to @devops
+- Conventional commits: `docs:` for design specs, `feat:` for components
+
+### Design Conventions
+- Atomic Design principles (atoms → molecules → organisms → templates → pages)
+- Design tokens for consistent theming
+- WCAG 2.1 AA compliance target
+
+## Promotion Candidates
+<!-- Patterns seen across 3+ agents — candidates for CLAUDE.md or .claude/rules/ -->
+<!-- Format: - **{pattern}** | Source: {agent} | Detected: {YYYY-MM-DD} -->
+
+## Archived
+<!-- Patterns no longer relevant — kept for history -->
+<!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->

package/.aios-core/development/checklists/issue-triage-checklist.md

@@ -0,0 +1,35 @@
+# Issue Triage Checklist
+
+## Per-Issue Checklist
+
+For each issue being triaged, verify:
+
+### Classification
+- [ ] Issue has been read and understood
+- [ ] ONE `type:` label applied (bug/feature/enhancement/docs/test/chore)
+- [ ] ONE `priority:` label applied (P1/P2/P3/P4)
+- [ ] At least ONE `area:` label applied
+- [ ] `status: needs-triage` removed
+
+### Status Resolution
+- [ ] Status set to `status: confirmed` OR `status: needs-info`
+- [ ] If `status: needs-info` — comment posted asking for specific details
+- [ ] If duplicate — labeled `duplicate`, closed with reference to original issue
+
+### Community
+- [ ] Assessed for `community: good first issue` (clear scope, isolated, well-documented)
+- [ ] Assessed for `community: help wanted` (valid but team lacks bandwidth)
+
+### Quality
+- [ ] Issue has sufficient information to act on (or `status: needs-info` applied)
+- [ ] Related issues cross-referenced if applicable
+- [ ] No sensitive information in issue (API keys, credentials)
+
+## Session Checklist
+
+After completing a triage session:
+
+- [ ] All `status: needs-triage` issues reviewed
+- [ ] Triage report generated
+- [ ] Story GHIM-001 updated with triage count
+- [ ] High-priority issues (P1/P2) flagged for immediate attention