@atlashub/smartstack-cli 1.5.1 → 1.5.2

package/templates/commands/create/agent.md

@@ -1,138 +1,138 @@
----
-description: Create a SmartStack agent extension project
-argument-hint: <name> [description]
----
-
-# Create Agent Extension
-
-Scaffold a complete SmartStack **agent** extension project.
-
-## What is an Agent?
-
-An agent is a specialized execution unit:
-- Launched by commands for parallel execution
-- Focused on specific tasks (search, analysis, etc.)
-- Defined in markdown with YAML frontmatter
-- Optimized with model selection (haiku/sonnet/opus)
-
-## Arguments
-
-Parse from `$ARGUMENTS`:
-- **name** (required): Agent name in kebab-case
-- **description** (optional): What the agent does
-
-## Project Structure
-
-```
-smartstack-{name}/
-├── package.json
-├── tsconfig.json
-├── tsup.config.ts
-├── README.md
-├── .gitignore
-├── src/
-│   └── index.ts
-└── templates/
-    └── agents/
-        └── {name}.md          # Agent template
-```
-
-## Generated Agent Template
-
-Create `templates/agents/{name}.md`:
-
-```markdown
----
-name: {name}
-description: {description}
-color: yellow
-model: haiku
----
-
-# {PascalCaseName} Agent
-
-{description}
-
-## Purpose
-
-This agent specializes in:
-- [Primary capability 1]
-- [Primary capability 2]
-- [Primary capability 3]
-
-## Search Strategy
-
-### 1. Initial Discovery
-- Use `Glob` to find files matching patterns
-- Focus on: `**/*.{relevant-extensions}`
-
-### 2. Deep Analysis
-- Use `Grep` for specific code patterns
-- Look for: `pattern1`, `pattern2`
-
-### 3. Context Building
-- Use `Read` to examine key files
-- Extract: imports, exports, dependencies
-
-### 4. Synthesis
-- Compile findings
-- Identify patterns
-- Generate recommendations
-
-## Output Format
-
-**CRITICAL**: Output findings directly in response. NEVER create files.
-
-### Findings Report
-
-#### Relevant Files
-| File | Purpose | Key Patterns |
-|------|---------|--------------|
-| path/to/file | description | patterns found |
-
-#### Analysis
-[Detailed analysis of findings]
-
-#### Recommendations
-1. [First recommendation]
-2. [Second recommendation]
-3. [Third recommendation]
-
-## Tool Usage
-
-Preferred tools for this agent:
-- `Glob` - File discovery
-- `Grep` - Pattern search
-- `Read` - File content
-
-## Anti-Patterns
-
-- **NEVER** create markdown files
-- **NEVER** guess without evidence
-- **NEVER** skip verification
-- **ALWAYS** cite specific file paths
-
-## Priority
-
-Accuracy > Completeness > Speed
-```
-
-## Model Selection Guide
-
-| Use Case | Model | Reason |
-|----------|-------|--------|
-| Simple search | haiku | Fast, cheap |
-| Analysis | sonnet | Good balance |
-| Complex reasoning | opus | Best quality |
-
-## Workflow
-
-1. Parse name and description from `$ARGUMENTS`
-2. Validate name is kebab-case
-3. Create project directory
-4. Generate all files using Write tool
-5. Display success message
-
----
-
-User: $ARGUMENTS
+---
+description: Create a SmartStack agent extension project
+argument-hint: <name> [description]
+---
+
+# Create Agent Extension
+
+Scaffold a complete SmartStack **agent** extension project.
+
+## What is an Agent?
+
+An agent is a specialized execution unit:
+- Launched by commands for parallel execution
+- Focused on specific tasks (search, analysis, etc.)
+- Defined in markdown with YAML frontmatter
+- Optimized with model selection (haiku/sonnet/opus)
+
+## Arguments
+
+Parse from `$ARGUMENTS`:
+- **name** (required): Agent name in kebab-case
+- **description** (optional): What the agent does
+
+## Project Structure
+
+```
+smartstack-{name}/
+├── package.json
+├── tsconfig.json
+├── tsup.config.ts
+├── README.md
+├── .gitignore
+├── src/
+│   └── index.ts
+└── templates/
+    └── agents/
+        └── {name}.md          # Agent template
+```
+
+## Generated Agent Template
+
+Create `templates/agents/{name}.md`:
+
+```markdown
+---
+name: {name}
+description: {description}
+color: yellow
+model: haiku
+---
+
+# {PascalCaseName} Agent
+
+{description}
+
+## Purpose
+
+This agent specializes in:
+- [Primary capability 1]
+- [Primary capability 2]
+- [Primary capability 3]
+
+## Search Strategy
+
+### 1. Initial Discovery
+- Use `Glob` to find files matching patterns
+- Focus on: `**/*.{relevant-extensions}`
+
+### 2. Deep Analysis
+- Use `Grep` for specific code patterns
+- Look for: `pattern1`, `pattern2`
+
+### 3. Context Building
+- Use `Read` to examine key files
+- Extract: imports, exports, dependencies
+
+### 4. Synthesis
+- Compile findings
+- Identify patterns
+- Generate recommendations
+
+## Output Format
+
+**CRITICAL**: Output findings directly in response. NEVER create files.
+
+### Findings Report
+
+#### Relevant Files
+| File | Purpose | Key Patterns |
+|------|---------|--------------|
+| path/to/file | description | patterns found |
+
+#### Analysis
+[Detailed analysis of findings]
+
+#### Recommendations
+1. [First recommendation]
+2. [Second recommendation]
+3. [Third recommendation]
+
+## Tool Usage
+
+Preferred tools for this agent:
+- `Glob` - File discovery
+- `Grep` - Pattern search
+- `Read` - File content
+
+## Anti-Patterns
+
+- **NEVER** create markdown files
+- **NEVER** guess without evidence
+- **NEVER** skip verification
+- **ALWAYS** cite specific file paths
+
+## Priority
+
+Accuracy > Completeness > Speed
+```
+
+## Model Selection Guide
+
+| Use Case | Model | Reason |
+|----------|-------|--------|
+| Simple search | haiku | Fast, cheap |
+| Analysis | sonnet | Good balance |
+| Complex reasoning | opus | Best quality |
+
+## Workflow
+
+1. Parse name and description from `$ARGUMENTS`
+2. Validate name is kebab-case
+3. Create project directory
+4. Generate all files using Write tool
+5. Display success message
+
+---
+
+User: $ARGUMENTS

package/templates/commands/create/command.md

@@ -1,166 +1,166 @@
----
-description: Create a SmartStack command extension project
-argument-hint: <name> [description]
----
-
-# Create Command Extension
-
-Scaffold a complete SmartStack **command** extension project.
-
-## What is a Command?
-
-A command is a slash command that users invoke in Claude Code:
-- `/my-command <args>` - Executes the command with arguments
-- Defined in markdown with YAML frontmatter
-- Contains workflow, rules, and execution logic
-
-## Arguments
-
-Parse from `$ARGUMENTS`:
-- **name** (required): Command name in kebab-case
-- **description** (optional): What the command does
-
-## Project Structure
-
-```
-smartstack-{name}/
-├── package.json
-├── tsconfig.json
-├── tsup.config.ts
-├── README.md
-├── .gitignore
-├── src/
-│   └── index.ts
-└── templates/
-    └── commands/
-        └── {name}.md          # Main command template
-```
-
-## Generated Command Template
-
-Create `templates/commands/{name}.md`:
-
-```markdown
----
-description: {description}
-argument-hint: <task-description>
----
-
-# {PascalCaseName}
-
-{description}
-
-## Workflow
-
-### 1. UNDERSTAND
-- Parse user arguments: `$ARGUMENTS`
-- Identify the task scope
-- Gather necessary context
-
-### 2. ANALYZE
-- Explore relevant codebase areas
-- Identify patterns and constraints
-- Document findings
-
-### 3. PLAN
-- Design the approach
-- Consider edge cases
-- Validate against requirements
-
-### 4. EXECUTE
-- Implement step by step
-- Follow existing patterns
-- Write clean code
-
-### 5. VERIFY
-- Test the implementation
-- Ensure no regressions
-- Validate completeness
-
-## Execution Rules
-
-1. **ULTRA THINK** before each phase
-2. Use parallel agents when beneficial
-3. Document all decisions
-4. **MINIMAL CHANGES**: Only what's needed
-5. Test before declaring complete
-
-## Agent Usage
-
-For exploration, launch agents:
-- `explore-codebase` - Find relevant files
-- `websearch` - Research solutions
-
-## Priority
-
-Understanding > Correctness > Speed
-
----
-
-User: $ARGUMENTS
-```
-
-## Generated Files
-
-### package.json
-
-```json
-{
-  "name": "@smartstack/{name}",
-  "version": "1.0.0",
-  "description": "{description}",
-  "private": false,
-  "type": "module",
-  "main": "./dist/index.js",
-  "files": ["dist", "templates"],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  },
-  "peerDependencies": {
-    "@atlashub/smartstack-cli": ">=1.0.0"
-  }
-}
-```
-
-### src/index.ts
-
-```typescript
-import * as path from 'path';
-import * as fs from 'fs';
-
-export function getTemplatesPath(): string {
-  return path.join(__dirname, '..', 'templates');
-}
-
-export async function install(targetDir: string): Promise<void> {
-  const src = path.join(getTemplatesPath(), 'commands');
-  const dest = path.join(targetDir, 'commands');
-  // Copy command templates
-}
-
-export const metadata = {
-  name: '{name}',
-  version: '1.0.0',
-  description: '{description}',
-  type: 'command'
-};
-```
-
-## Workflow
-
-1. Parse name and description from `$ARGUMENTS`
-2. Validate name is kebab-case
-3. Create project directory
-4. Generate all files using Write tool
-5. Display success message with next steps
-
-## Validation
-
-- Name must match: `^[a-z][a-z0-9-]*$`
-- Directory must not exist
-- Description should be meaningful
-
----
-
-User: $ARGUMENTS
+---
+description: Create a SmartStack command extension project
+argument-hint: <name> [description]
+---
+
+# Create Command Extension
+
+Scaffold a complete SmartStack **command** extension project.
+
+## What is a Command?
+
+A command is a slash command that users invoke in Claude Code:
+- `/my-command <args>` - Executes the command with arguments
+- Defined in markdown with YAML frontmatter
+- Contains workflow, rules, and execution logic
+
+## Arguments
+
+Parse from `$ARGUMENTS`:
+- **name** (required): Command name in kebab-case
+- **description** (optional): What the command does
+
+## Project Structure
+
+```
+smartstack-{name}/
+├── package.json
+├── tsconfig.json
+├── tsup.config.ts
+├── README.md
+├── .gitignore
+├── src/
+│   └── index.ts
+└── templates/
+    └── commands/
+        └── {name}.md          # Main command template
+```
+
+## Generated Command Template
+
+Create `templates/commands/{name}.md`:
+
+```markdown
+---
+description: {description}
+argument-hint: <task-description>
+---
+
+# {PascalCaseName}
+
+{description}
+
+## Workflow
+
+### 1. UNDERSTAND
+- Parse user arguments: `$ARGUMENTS`
+- Identify the task scope
+- Gather necessary context
+
+### 2. ANALYZE
+- Explore relevant codebase areas
+- Identify patterns and constraints
+- Document findings
+
+### 3. PLAN
+- Design the approach
+- Consider edge cases
+- Validate against requirements
+
+### 4. EXECUTE
+- Implement step by step
+- Follow existing patterns
+- Write clean code
+
+### 5. VERIFY
+- Test the implementation
+- Ensure no regressions
+- Validate completeness
+
+## Execution Rules
+
+1. **ULTRA THINK** before each phase
+2. Use parallel agents when beneficial
+3. Document all decisions
+4. **MINIMAL CHANGES**: Only what's needed
+5. Test before declaring complete
+
+## Agent Usage
+
+For exploration, launch agents:
+- `explore-codebase` - Find relevant files
+- `websearch` - Research solutions
+
+## Priority
+
+Understanding > Correctness > Speed
+
+---
+
+User: $ARGUMENTS
+```
+
+## Generated Files
+
+### package.json
+
+```json
+{
+  "name": "@smartstack/{name}",
+  "version": "1.0.0",
+  "description": "{description}",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "files": ["dist", "templates"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "@atlashub/smartstack-cli": ">=1.0.0"
+  }
+}
+```
+
+### src/index.ts
+
+```typescript
+import * as path from 'path';
+import * as fs from 'fs';
+
+export function getTemplatesPath(): string {
+  return path.join(__dirname, '..', 'templates');
+}
+
+export async function install(targetDir: string): Promise<void> {
+  const src = path.join(getTemplatesPath(), 'commands');
+  const dest = path.join(targetDir, 'commands');
+  // Copy command templates
+}
+
+export const metadata = {
+  name: '{name}',
+  version: '1.0.0',
+  description: '{description}',
+  type: 'command'
+};
+```
+
+## Workflow
+
+1. Parse name and description from `$ARGUMENTS`
+2. Validate name is kebab-case
+3. Create project directory
+4. Generate all files using Write tool
+5. Display success message with next steps
+
+## Validation
+
+- Name must match: `^[a-z][a-z0-9-]*$`
+- Directory must not exist
+- Description should be meaningful
+
+---
+
+User: $ARGUMENTS