sam-agents 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sam-agents
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# SAM - Smart Agent Manager
+
+[![npm version](https://img.shields.io/npm/v/@sam-agents/sam.svg)](https://www.npmjs.com/package/@sam-agents/sam)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/npm/dm/@sam-agents/sam.svg)](https://www.npmjs.com/package/@sam-agents/sam)
+
+**Autonomous TDD agent system for Claude Code and Cursor.**
+
+SAM orchestrates a team of specialized AI agents that transform your PRD into working, tested code using strict Test-Driven Development (RED-GREEN-REFACTOR).
+
+## Quick Start
+
+```bash
+# For Claude Code (default)
+npx @sam-agents/sam
+
+# For Cursor
+npx @sam-agents/sam --platform cursor
+
+# For all platforms
+npx @sam-agents/sam --platform all
+```
+
+## Supported Platforms
+
+| Platform | Install Command | Skill Format |
+|----------|-----------------|--------------|
+| **Claude Code** | `npx @sam-agents/sam` | `/sam:` commands |
+| **Cursor** | `npx @sam-agents/sam --platform cursor` | `@agent` mentions |
+
+## Why SAM?
+
+| Feature | SAM | Traditional AI Coding |
+|---------|-----|----------------------|
+| **TDD-First** | Tests written before code | Code first, tests maybe |
+| **BYOA** | Use your own AI subscription | Pay per API call (5-10x cost) |
+| **Transparency** | Watch agents work in real-time | Black box |
+| **Autonomous** | Minimal intervention after PRD | Constant hand-holding |
+| **Multi-Platform** | Claude Code + Cursor | Single platform lock-in |
+
+## Available Agents
+
+| Agent | Claude Code | Cursor | Role |
+|-------|-------------|--------|------|
+| **SAM** | `/sam:core:agents:sam` | `@sam` | Orchestrator |
+| **Atlas** | `/sam:sam:agents:atlas` | `@atlas` | System Architect |
+| **Titan** | `/sam:sam:agents:titan` | `@titan` | Test Architect (RED) |
+| **Dyna** | `/sam:sam:agents:dyna` | `@dyna` | Developer (GREEN) |
+| **Argus** | `/sam:sam:agents:argus` | `@argus` | Code Reviewer (REFACTOR) |
+| **Sage** | `/sam:sam:agents:sage` | `@sage` | Technical Writer |
+| **Iris** | `/sam:sam:agents:iris` | `@iris` | UX Designer |
+
+## The TDD Pipeline
+
+**Claude Code:** `/sam:core:workflows:autonomous-tdd`
+**Cursor:** `@sam-tdd`
+
+1. **Validate PRD** - Atlas + Iris review requirements
+2. **Generate Stories** - Break down into epics and user stories
+3. **TDD Loop** - For each story:
+   - **RED**: Titan writes failing tests
+   - **GREEN**: Dyna writes minimal code to pass
+   - **REFACTOR**: Argus improves code quality
+4. **Complete** - Sage generates documentation
+
+## What Gets Installed
+
+```
+your-project/
+├── _sam/                      # Agent definitions (shared)
+│   ├── agents/                # Individual agent configs
+│   └── core/workflows/        # TDD pipeline workflow
+├── .claude/commands/sam/      # Claude Code skills (--platform claude)
+└── .cursor/rules/             # Cursor rules (--platform cursor)
+```
+
+## Requirements
+
+- Node.js 16+
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) or [Cursor](https://cursor.com)
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.
+
+---
+
+Built with AI. Powered by TDD.

package/bin/cli.js

@@ -0,0 +1,320 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+
+const PLATFORMS = ['claude', 'cursor', 'all'];
+
+function log(message, color = RESET) {
+  console.log(`${color}${message}${RESET}`);
+}
+
+function copyRecursive(src, dest) {
+  const stats = fs.statSync(src);
+
+  if (stats.isDirectory()) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+
+    const files = fs.readdirSync(src);
+    for (const file of files) {
+      copyRecursive(path.join(src, file), path.join(dest, file));
+    }
+  } else {
+    const destDir = path.dirname(dest);
+    if (!fs.existsSync(destDir)) {
+      fs.mkdirSync(destDir, { recursive: true });
+    }
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function countFiles(dir) {
+  let count = 0;
+  const items = fs.readdirSync(dir);
+  for (const item of items) {
+    const fullPath = path.join(dir, item);
+    if (fs.statSync(fullPath).isDirectory()) {
+      count += countFiles(fullPath);
+    } else {
+      count++;
+    }
+  }
+  return count;
+}
+
+function showHelp() {
+  log('\n' + BOLD + '  SAM - Smart Agent Manager' + RESET);
+  log('  Autonomous TDD Agent System\n', CYAN);
+  log('  Usage: npx @sam-agents/sam [options] [target-directory]\n');
+  log('  Options:');
+  log('    --platform <name>  Target platform: claude, cursor, all');
+  log('    --help, -h         Show this help message');
+  log('    --version, -v      Show version number\n');
+  log('  Examples:');
+  log('    npx @sam-agents/sam                    Interactive mode');
+  log('    npx @sam-agents/sam --platform cursor  Install for Cursor');
+  log('    npx @sam-agents/sam --platform all     Install for all platforms');
+  log('    npx @sam-agents/sam ./myapp            Install in ./myapp directory\n');
+  log('  Supported Platforms:');
+  log('    claude  - Claude Code CLI (.claude/commands/)');
+  log('    cursor  - Cursor IDE (.cursor/rules/)\n');
+}
+
+function generateCursorRules(samDir, targetDir) {
+  const cursorDir = path.join(targetDir, '.cursor', 'rules');
+
+  if (!fs.existsSync(cursorDir)) {
+    fs.mkdirSync(cursorDir, { recursive: true });
+  }
+
+  const agents = [
+    { name: 'sam', file: 'core/agents/sam-master.md', display: 'SAM Orchestrator' },
+    { name: 'atlas', file: 'agents/architect.md', display: 'Atlas - System Architect' },
+    { name: 'dyna', file: 'agents/dev.md', display: 'Dyna - Developer' },
+    { name: 'titan', file: 'agents/test.md', display: 'Titan - Test Architect' },
+    { name: 'argus', file: 'agents/reviewer.md', display: 'Argus - Code Reviewer' },
+    { name: 'sage', file: 'agents/tech-writer.md', display: 'Sage - Technical Writer' },
+    { name: 'iris', file: 'agents/ux-designer.md', display: 'Iris - UX Designer' }
+  ];
+
+  let rulesCount = 0;
+
+  for (const agent of agents) {
+    const agentPath = path.join(samDir, agent.file);
+    if (fs.existsSync(agentPath)) {
+      const content = fs.readFileSync(agentPath, 'utf8');
+
+      const ruleContent = `---
+description: ${agent.display} - SAM Agent for TDD development
+globs: ["**/*"]
+alwaysApply: false
+---
+
+# ${agent.display}
+
+When the user mentions "@${agent.name}" or asks for ${agent.display.toLowerCase()}, adopt this persona:
+
+${content}
+
+## Invocation
+To use this agent, the user should mention @${agent.name} in their message.
+`;
+
+      fs.writeFileSync(path.join(cursorDir, `sam-${agent.name}.mdc`), ruleContent);
+      rulesCount++;
+    }
+  }
+
+  const workflowRule = `---
+description: SAM Autonomous TDD Workflow - Full pipeline from PRD to tested code
+globs: ["**/*"]
+alwaysApply: false
+---
+
+# SAM Autonomous TDD Workflow
+
+When the user mentions "@sam-tdd" or asks for the TDD workflow, execute this pipeline:
+
+## Overview
+SAM orchestrates a team of AI agents to transform a PRD into working, tested code using strict TDD.
+
+## The Pipeline
+
+### Phase 1: Validate PRD
+- @atlas reviews technical feasibility
+- @iris validates UX requirements
+
+### Phase 2: Generate Stories
+- Break PRD into epics and user stories
+- Create detailed acceptance criteria
+
+### Phase 3: TDD Loop (for each story)
+1. **RED**: @titan writes failing tests based on acceptance criteria
+2. **GREEN**: @dyna writes minimal code to make tests pass
+3. **REFACTOR**: @argus reviews and improves code quality
+
+### Phase 4: Complete
+- @sage generates documentation
+- Final review and handoff
+
+## Usage
+Mention @sam-tdd with a PRD or feature description to start the pipeline.
+
+## Agent Commands
+- @sam - Orchestrator
+- @atlas - Architect (PRD validation, technical design)
+- @titan - Test Architect (RED phase - write failing tests)
+- @dyna - Developer (GREEN phase - make tests pass)
+- @argus - Code Reviewer (REFACTOR phase)
+- @sage - Technical Writer (documentation)
+- @iris - UX Designer (UX validation)
+`;
+
+  fs.writeFileSync(path.join(cursorDir, 'sam-workflow.mdc'), workflowRule);
+  rulesCount++;
+
+  return rulesCount;
+}
+
+async function promptPlatform() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    log('\n' + BOLD + '  SAM - Smart Agent Manager' + RESET);
+    log('  Autonomous TDD Agent System\n', CYAN);
+    log('  Select your IDE/Platform:\n');
+    log('    1) Claude Code  ' + DIM + '(.claude/commands/)' + RESET);
+    log('    2) Cursor       ' + DIM + '(.cursor/rules/)' + RESET);
+    log('    3) Both         ' + DIM + '(install for all platforms)' + RESET);
+    log('');
+
+    rl.question('  Enter choice [1-3]: ', (answer) => {
+      rl.close();
+      const choice = answer.trim();
+
+      if (choice === '1' || choice.toLowerCase() === 'claude') {
+        resolve('claude');
+      } else if (choice === '2' || choice.toLowerCase() === 'cursor') {
+        resolve('cursor');
+      } else if (choice === '3' || choice.toLowerCase() === 'both' || choice.toLowerCase() === 'all') {
+        resolve('all');
+      } else if (choice === '') {
+        // Default to claude
+        resolve('claude');
+      } else {
+        log('\n  Invalid choice. Defaulting to Claude Code.\n', YELLOW);
+        resolve('claude');
+      }
+    });
+  });
+}
+
+function install(platform, targetDir) {
+  const templatesDir = path.join(__dirname, '..', 'templates');
+
+  if (!fs.existsSync(templatesDir)) {
+    log('Error: Templates directory not found.', RED);
+    process.exit(1);
+  }
+
+  const samDir = path.join(targetDir, '_sam');
+
+  log(`\n  Platform: ${platform}`, CYAN);
+  log(`  Installing to: ${targetDir}\n`, CYAN);
+
+  // Always copy _sam folder
+  const samTemplateDir = path.join(templatesDir, '_sam');
+  if (fs.existsSync(samTemplateDir)) {
+    copyRecursive(samTemplateDir, samDir);
+    const samFileCount = countFiles(samDir);
+    log(`  ✓ Copied _sam/ (${samFileCount} files)`, GREEN);
+  }
+
+  // Install Claude Code integration
+  if (platform === 'claude' || platform === 'all') {
+    const claudeCommandsDir = path.join(targetDir, '.claude', 'commands', 'sam');
+    const claudeTemplateDir = path.join(templatesDir, '.claude', 'commands', 'sam');
+    if (fs.existsSync(claudeTemplateDir)) {
+      copyRecursive(claudeTemplateDir, claudeCommandsDir);
+      const claudeFileCount = countFiles(claudeCommandsDir);
+      log(`  ✓ Copied .claude/commands/sam/ (${claudeFileCount} files)`, GREEN);
+    }
+  }
+
+  // Install Cursor integration
+  if (platform === 'cursor' || platform === 'all') {
+    const cursorRulesCount = generateCursorRules(samDir, targetDir);
+    log(`  ✓ Generated .cursor/rules/ (${cursorRulesCount} files)`, GREEN);
+  }
+
+  log('\n' + BOLD + '  Installation complete!' + RESET + '\n');
+
+  if (platform === 'claude' || platform === 'all') {
+    log('  Claude Code Commands:', CYAN);
+    log('    /sam:core:agents:sam          - SAM Orchestrator');
+    log('    /sam:sam:agents:atlas         - Atlas (Architect)');
+    log('    /sam:sam:agents:dyna          - Dyna (Developer)');
+    log('    /sam:sam:agents:titan         - Titan (Test Architect)');
+    log('    /sam:sam:agents:argus         - Argus (Code Reviewer)');
+    log('    /sam:sam:agents:sage          - Sage (Tech Writer)');
+    log('    /sam:sam:agents:iris          - Iris (UX Designer)');
+    log('    /sam:core:workflows:autonomous-tdd - Full TDD Pipeline\n');
+  }
+
+  if (platform === 'cursor' || platform === 'all') {
+    log('  Cursor Commands (use @ mentions):', CYAN);
+    log('    @sam       - SAM Orchestrator');
+    log('    @atlas     - Atlas (Architect)');
+    log('    @dyna      - Dyna (Developer)');
+    log('    @titan     - Titan (Test Architect)');
+    log('    @argus     - Argus (Code Reviewer)');
+    log('    @sage      - Sage (Tech Writer)');
+    log('    @iris      - Iris (UX Designer)');
+    log('    @sam-tdd   - Full TDD Pipeline\n');
+  }
+
+  if (platform === 'claude' || platform === 'all') {
+    log('  Restart Claude Code to load the new skills.', YELLOW);
+  }
+  if (platform === 'cursor' || platform === 'all') {
+    log('  Cursor will auto-detect rules in .cursor/rules/', YELLOW);
+  }
+  log('');
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Handle flags
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
+  }
+
+  if (args.includes('--version') || args.includes('-v')) {
+    const pkg = require('../package.json');
+    log(`@sam-agents/sam v${pkg.version}`);
+    return;
+  }
+
+  // Check if platform is specified
+  const platformIdx = args.indexOf('--platform');
+  let platform = null;
+
+  if (platformIdx !== -1 && args[platformIdx + 1]) {
+    platform = args[platformIdx + 1].toLowerCase();
+    if (!PLATFORMS.includes(platform)) {
+      log(`\nError: Unknown platform "${platform}". Use: ${PLATFORMS.join(', ')}`, RED);
+      process.exit(1);
+    }
+  }
+
+  // Get target directory (skip flags)
+  const targetDir = args.find(arg => !arg.startsWith('--') && arg !== platform) || process.cwd();
+
+  // If no platform specified, prompt interactively
+  if (!platform) {
+    platform = await promptPlatform();
+  } else {
+    log('\n' + BOLD + '  SAM - Smart Agent Manager' + RESET);
+    log('  Autonomous TDD Agent System', CYAN);
+  }
+
+  install(platform, targetDir);
+}
+
+main();

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "sam-agents",
+  "version": "0.1.0",
+  "description": "SAM (Smart Agent Manager) - Autonomous TDD agent system for Claude Code and Cursor",
+  "bin": {
+    "sam-agents": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "cursor",
+    "ai-agents",
+    "tdd",
+    "autonomous",
+    "code-generation",
+    "testing",
+    "developer-tools"
+  ],
+  "author": "SAM Agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sam-agents/sam.git"
+  },
+  "homepage": "https://github.com/sam-agents/sam#readme",
+  "bugs": {
+    "url": "https://github.com/sam-agents/sam/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/templates/.claude/commands/sam/core/agents/sam.md

@@ -0,0 +1,6 @@
+---
+name: 'sam'
+description: 'SAM - Smart Agent Manager orchestrator for autonomous TDD pipelines'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/core/agents/sam-master.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/core/workflows/autonomous-tdd.md

@@ -0,0 +1,6 @@
+---
+name: 'autonomous-tdd'
+description: 'SAM Autonomous TDD Pipeline - Transforms PRD into working, tested code using RED-GREEN-REFACTOR methodology'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/core/workflows/autonomous-tdd/workflow.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/sam/agents/argus.md

@@ -0,0 +1,6 @@
+---
+name: 'argus'
+description: 'Argus - Code Reviewer for quality assurance (REFACTOR phase)'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/agents/reviewer.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/sam/agents/atlas.md

@@ -0,0 +1,6 @@
+---
+name: 'atlas'
+description: 'Atlas - System Architect for technical design and PRD validation'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/agents/architect.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/sam/agents/dyna.md

@@ -0,0 +1,6 @@
+---
+name: 'dyna'
+description: 'Dyna - Developer agent for TDD implementation (GREEN phase)'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/agents/dev.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/sam/agents/iris.md

@@ -0,0 +1,6 @@
+---
+name: 'iris'
+description: 'Iris - UX Designer for user experience validation'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/agents/ux-designer.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/sam/agents/sage.md

@@ -0,0 +1,6 @@
+---
+name: 'sage'
+description: 'Sage - Technical Writer for documentation generation'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/agents/tech-writer.md, READ its entire contents and follow its directions exactly!

package/templates/.claude/commands/sam/sam/agents/titan.md

@@ -0,0 +1,6 @@
+---
+name: 'titan'
+description: 'Titan - Test Architect for writing failing tests (RED phase)'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @_sam/agents/test.md, READ its entire contents and follow its directions exactly!

package/templates/_sam/_config/agent-manifest.csv

@@ -0,0 +1,8 @@
+name,displayName,title,icon,role,identity,communicationStyle,principles,module,path
+"sam","SAM","Smart Agent Manager - Orchestrator","🤖","Master Orchestrator + Pipeline Controller","SAM is the master orchestrator for autonomous development pipelines. Coordinates specialized agents (Atlas, Dyna, Titan, Argus, Sage, Iris) through TDD cycles, manages state, and ensures quality gates are enforced.","Direct and systematic, focused on pipeline execution and agent coordination. Presents clear status updates and orchestrates workflows efficiently.","- Orchestrate agents through RED-GREEN-REFACTOR cycles without human intervention - Enforce quality gates: tests must fail before impl, pass after - Track state meticulously in pipeline-status.yaml - Escalate only when max retries exceeded","core","_sam/core/agents/sam-master.md"
+"architect","Atlas","System Architect","🏗️","System Architect + Technical Design Leader","Senior architect with expertise in distributed systems, cloud infrastructure, and API design. Validates PRDs for technical feasibility and designs scalable solutions.","Speaks in calm, pragmatic tones, balancing 'what could be' with 'what should be.'","- Validate PRD technical feasibility before development begins - Design simple solutions that scale when needed - Every technical decision must connect to business value - Identify risks and dependencies early","sam","_sam/agents/architect.md"
+"dev","Dyna","Developer Agent","💻","Senior Software Engineer","Executes story implementation with strict TDD adherence. Writes minimum code to make failing tests pass, following RED-GREEN-REFACTOR discipline.","Ultra-succinct. Speaks in file paths and test results. No fluff, all precision.","- Never write implementation code until failing tests exist - Write minimum code to make tests pass (GREEN phase) - All existing tests must remain green - Follow project-context.md guidance when available - Mark task complete only when ALL tests pass","sam","_sam/agents/dev.md"
+"test","Titan","Test Architect","🧪","Master Test Architect","Test architect specializing in writing failing acceptance tests BEFORE implementation. Enforces TDD RED phase with comprehensive test coverage.","Speaks in test assertions and coverage metrics. Risk-focused, quality-obsessed.","- Write failing tests FIRST - this is non-negotiable (RED phase) - Tests must fail for the right reasons - missing implementation - Cover edge cases, error conditions, and happy paths - Acceptance tests validate story AC, unit tests validate code behavior - Never mark RED phase complete if tests pass","sam","_sam/agents/test.md"
+"reviewer","Argus","Code Reviewer","🔍","Senior Code Reviewer + Quality Guardian","Adversarial code reviewer who finds 3-10 specific issues in every review. Challenges code quality, test coverage, security, and architecture compliance.","Direct and critical. Finds problems others miss. Never says 'looks good' without thorough analysis.","- Find minimum 3 issues in every review - no free passes - Check: correctness, tests, security, performance, maintainability - Verify all tests pass after suggested fixes - Auto-fix when possible, document when not - REFACTOR phase: improve code while keeping tests green","sam","_sam/agents/reviewer.md"
+"tech-writer","Sage","Technical Writer","📚","Technical Documentation Specialist","Creates clear, comprehensive documentation for implemented features. Transforms code and tests into accessible documentation.","Patient educator who explains complex concepts simply. Uses examples that clarify.","- Documentation is teaching - help users accomplish tasks - Generate docs AFTER implementation is complete and reviewed - Include code examples, API references, and usage guides - Keep docs in sync with actual implementation","sam","_sam/agents/tech-writer.md"
+"ux-designer","Iris","UX Designer","🎨","User Experience Designer","Validates UI/UX aspects of stories. Ensures implementations serve genuine user needs with intuitive experiences.","Empathetic advocate focused on user needs. Paints pictures with user stories.","- Every UI decision must serve genuine user needs - Validate against acceptance criteria for UX requirements - Flag usability concerns before implementation locks in - Balance aesthetics with accessibility","sam","_sam/agents/ux-designer.md"

package/templates/_sam/_config/agents/sam-architect.customize.yaml

@@ -0,0 +1,13 @@
+# Atlas - System Architect Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/agents/sam-dev.customize.yaml

@@ -0,0 +1,13 @@
+# Dyna - Developer Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/agents/sam-reviewer.customize.yaml

@@ -0,0 +1,13 @@
+# Argus - Code Reviewer Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/agents/sam-sam.customize.yaml

@@ -0,0 +1,13 @@
+# SAM - Orchestrator Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/agents/sam-tech-writer.customize.yaml

@@ -0,0 +1,13 @@
+# Sage - Technical Writer Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/agents/sam-test.customize.yaml

@@ -0,0 +1,13 @@
+# Titan - Test Architect Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/agents/sam-ux-designer.customize.yaml

@@ -0,0 +1,13 @@
+# Iris - UX Designer Customization
+agent:
+  metadata:
+    name: ""
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+critical_actions: []
+memories: []
+menu: []
+prompts: []

package/templates/_sam/_config/ides/claude-code.yaml

@@ -0,0 +1,6 @@
+ide: claude-code
+configured_date: 2026-01-28T00:00:00.000Z
+last_updated: 2026-01-28T00:00:00.000Z
+configuration:
+  subagentChoices: null
+  installLocation: null

package/templates/_sam/_config/manifest.yaml

@@ -0,0 +1,13 @@
+# SAM - Smart Agent Manager
+# Skill Package Manifest for Claude Code
+# Version: 1.0.0
+
+installation:
+  version: 1.0.0
+  installDate: 2026-01-28T00:00:00.000Z
+  lastUpdated: 2026-01-28T00:00:00.000Z
+modules:
+  - core
+  - sam
+ides:
+  - claude-code