@atlashub/smartstack-cli 3.39.0 → 3.40.0

package/templates/skills/cc-agent/steps/step-01-design.md

@@ -1,186 +1,186 @@
----
-name: step-01-design
-description: Design agent - choose model, tools, permissions, skills to preload
-next_step: steps/step-02-generate.md
----
-
-# Step 1: Design Agent
-
-## MANDATORY EXECUTION RULES:
-- ALWAYS ask the user for design decisions (don't assume)
-- For UPDATE: show current values and ask what to change
-- Load reference docs for guidance
-- Tools should follow principle of least privilege
-
-## YOUR TASK:
-Guide the user through agent design decisions. Gather model, tools, permissions, skills, and system prompt content.
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Load References
-
-```
-Read: "references/agent-frontmatter.md"
-Read: "references/tools-reference.md"
-Read: "references/permission-modes.md"
-```
-
-### 2. Gather Description
-
-```yaml
-AskUserQuestion:
-  header: "Purpose"
-  question: "Describe what this agent does and WHEN Claude should delegate to it. Be specific - Claude uses this to decide delegation. Example: 'Expert code reviewer for PR analysis. Use when reviewing code changes for security, logic, or performance.'"
-```
-
-Store in {description}.
-
-### 3. Choose Model
-
-```yaml
-AskUserQuestion:
-  header: "Model"
-  question: "Which model should this agent use?"
-  options:
-    - label: "Haiku (Recommended for fast tasks)"
-      description: "Fast and cheap. Best for: search, scan, simple checks, read-only tasks."
-    - label: "Sonnet"
-      description: "Balanced. Best for: code generation, analysis, most tasks."
-    - label: "Opus"
-      description: "Most capable. Best for: complex reasoning, architecture, planning."
-    - label: "Inherit"
-      description: "Use parent's model. Best when you don't want to override."
-```
-
-### 4. Choose Tools
-
-```yaml
-AskUserQuestion:
-  header: "Tools"
-  question: "What tools does this agent need?"
-  options:
-    - label: "Read-only"
-      description: "Read, Grep, Glob - safe exploration only"
-    - label: "Read + Write"
-      description: "Read, Write, Edit, Grep, Glob - file modifications"
-    - label: "Full dev"
-      description: "Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch"
-    - label: "Custom"
-      description: "I'll specify the exact tool list"
-  multiSelect: false
-```
-
-If "Custom" selected, ask for comma-separated list.
-
-Map selections:
-- Read-only → "Read, Grep, Glob"
-- Read + Write → "Read, Write, Edit, Grep, Glob"
-- Full dev → "Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch"
-
-Also ask about disallowed tools:
-
-```yaml
-AskUserQuestion:
-  header: "Blocked"
-  question: "Should any tools be explicitly blocked? (Usually not needed)"
-  options:
-    - label: "None (Recommended)"
-      description: "Don't block any tools beyond the allowed list"
-    - label: "Block Bash"
-      description: "Prevent command execution"
-    - label: "Block Write/Edit"
-      description: "Read-only, no file modifications"
-    - label: "Custom"
-      description: "I'll specify tools to block"
-```
-
-### 5. Choose Permission Mode
-
-```yaml
-AskUserQuestion:
-  header: "Permissions"
-  question: "How should this agent handle permission prompts?"
-  options:
-    - label: "Default (Recommended)"
-      description: "Standard permission prompts for sensitive operations"
-    - label: "Accept Edits"
-      description: "Auto-accept file edits. Good for code generation agents."
-    - label: "Plan (read-only)"
-      description: "Read-only exploration mode. No modifications allowed."
-    - label: "Don't Ask"
-      description: "Auto-deny all permission prompts. For background tasks."
-```
-
-### 6. Choose Skills to Preload (optional)
-
-```yaml
-AskUserQuestion:
-  header: "Skills"
-  question: "Should any skills be preloaded into this agent? Preloaded skills inject their full content at startup."
-  options:
-    - label: "None (Recommended)"
-      description: "Agent operates without preloaded skills"
-    - label: "Select skills"
-      description: "I'll choose which skills to preload"
-```
-
-If "Select skills", list available skills and let user choose.
-
-### 7. Design System Prompt
-
-Ask the user to describe the agent's behavior:
-
-```yaml
-AskUserQuestion:
-  header: "Behavior"
-  question: "Describe the agent's behavior pattern. Choose a template or describe custom behavior."
-  options:
-    - label: "Explorer"
-      description: "Search codebase, read files, report findings. Workflow: Search → Read → Analyze → Report."
-    - label: "Modifier"
-      description: "Read code, make changes, validate. Workflow: Read → Edit → Validate → Report."
-    - label: "Validator"
-      description: "Check conventions, rules, quality. Workflow: Scan → Check → Report issues."
-    - label: "Custom"
-      description: "I'll describe the workflow and behavior"
-```
-
-If "Custom", ask for detailed description of:
-1. What the agent does when invoked
-2. The workflow steps (numbered)
-3. Key execution rules
-4. Output format
-
-### 8. Show Design Summary
-
-```
-Agent Design:
-
-| Field | Value |
-|-------|-------|
-| Name | {agent_name} |
-| Description | {description} (truncated) |
-| Model | {model} |
-| Tools | {tools} |
-| Blocked tools | {disallowed_tools} |
-| Permission mode | {permission_mode} |
-| Preloaded skills | {preloaded_skills} |
-| Behavior pattern | {pattern} |
-| Category | {category} |
-
-→ Generating agent file...
-```
-
----
-
-## SUCCESS METRICS:
-- All required fields gathered from user
-- Model choice appropriate for agent's purpose
-- Tools follow least privilege principle
-- Permission mode matches risk level
-- System prompt pattern identified
-
-## NEXT STEP:
-After design is confirmed, proceed directly to `./step-02-generate.md`
+---
+name: step-01-design
+description: Design agent - choose model, tools, permissions, skills to preload
+next_step: steps/step-02-generate.md
+---
+
+# Step 1: Design Agent
+
+## MANDATORY EXECUTION RULES:
+- ALWAYS ask the user for design decisions (don't assume)
+- For UPDATE: show current values and ask what to change
+- Load reference docs for guidance
+- Tools should follow principle of least privilege
+
+## YOUR TASK:
+Guide the user through agent design decisions. Gather model, tools, permissions, skills, and system prompt content.
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Load References
+
+```
+Read: "references/agent-frontmatter.md"
+Read: "references/tools-reference.md"
+Read: "references/permission-modes.md"
+```
+
+### 2. Gather Description
+
+```yaml
+AskUserQuestion:
+  header: "Purpose"
+  question: "Describe what this agent does and WHEN Claude should delegate to it. Be specific - Claude uses this to decide delegation. Example: 'Expert code reviewer for PR analysis. Use when reviewing code changes for security, logic, or performance.'"
+```
+
+Store in {description}.
+
+### 3. Choose Model
+
+```yaml
+AskUserQuestion:
+  header: "Model"
+  question: "Which model should this agent use?"
+  options:
+    - label: "Haiku (Recommended for fast tasks)"
+      description: "Fast and cheap. Best for: search, scan, simple checks, read-only tasks."
+    - label: "Sonnet"
+      description: "Balanced. Best for: code generation, analysis, most tasks."
+    - label: "Opus"
+      description: "Most capable. Best for: complex reasoning, architecture, planning."
+    - label: "Inherit"
+      description: "Use parent's model. Best when you don't want to override."
+```
+
+### 4. Choose Tools
+
+```yaml
+AskUserQuestion:
+  header: "Tools"
+  question: "What tools does this agent need?"
+  options:
+    - label: "Read-only"
+      description: "Read, Grep, Glob - safe exploration only"
+    - label: "Read + Write"
+      description: "Read, Write, Edit, Grep, Glob - file modifications"
+    - label: "Full dev"
+      description: "Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch"
+    - label: "Custom"
+      description: "I'll specify the exact tool list"
+  multiSelect: false
+```
+
+If "Custom" selected, ask for comma-separated list.
+
+Map selections:
+- Read-only → "Read, Grep, Glob"
+- Read + Write → "Read, Write, Edit, Grep, Glob"
+- Full dev → "Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch"
+
+Also ask about disallowed tools:
+
+```yaml
+AskUserQuestion:
+  header: "Blocked"
+  question: "Should any tools be explicitly blocked? (Usually not needed)"
+  options:
+    - label: "None (Recommended)"
+      description: "Don't block any tools beyond the allowed list"
+    - label: "Block Bash"
+      description: "Prevent command execution"
+    - label: "Block Write/Edit"
+      description: "Read-only, no file modifications"
+    - label: "Custom"
+      description: "I'll specify tools to block"
+```
+
+### 5. Choose Permission Mode
+
+```yaml
+AskUserQuestion:
+  header: "Permissions"
+  question: "How should this agent handle permission prompts?"
+  options:
+    - label: "Default (Recommended)"
+      description: "Standard permission prompts for sensitive operations"
+    - label: "Accept Edits"
+      description: "Auto-accept file edits. Good for code generation agents."
+    - label: "Plan (read-only)"
+      description: "Read-only exploration mode. No modifications allowed."
+    - label: "Don't Ask"
+      description: "Auto-deny all permission prompts. For background tasks."
+```
+
+### 6. Choose Skills to Preload (optional)
+
+```yaml
+AskUserQuestion:
+  header: "Skills"
+  question: "Should any skills be preloaded into this agent? Preloaded skills inject their full content at startup."
+  options:
+    - label: "None (Recommended)"
+      description: "Agent operates without preloaded skills"
+    - label: "Select skills"
+      description: "I'll choose which skills to preload"
+```
+
+If "Select skills", list available skills and let user choose.
+
+### 7. Design System Prompt
+
+Ask the user to describe the agent's behavior:
+
+```yaml
+AskUserQuestion:
+  header: "Behavior"
+  question: "Describe the agent's behavior pattern. Choose a template or describe custom behavior."
+  options:
+    - label: "Explorer"
+      description: "Search codebase, read files, report findings. Workflow: Search → Read → Analyze → Report."
+    - label: "Modifier"
+      description: "Read code, make changes, validate. Workflow: Read → Edit → Validate → Report."
+    - label: "Validator"
+      description: "Check conventions, rules, quality. Workflow: Scan → Check → Report issues."
+    - label: "Custom"
+      description: "I'll describe the workflow and behavior"
+```
+
+If "Custom", ask for detailed description of:
+1. What the agent does when invoked
+2. The workflow steps (numbered)
+3. Key execution rules
+4. Output format
+
+### 8. Show Design Summary
+
+```
+Agent Design:
+
+| Field | Value |
+|-------|-------|
+| Name | {agent_name} |
+| Description | {description} (truncated) |
+| Model | {model} |
+| Tools | {tools} |
+| Blocked tools | {disallowed_tools} |
+| Permission mode | {permission_mode} |
+| Preloaded skills | {preloaded_skills} |
+| Behavior pattern | {pattern} |
+| Category | {category} |
+
+→ Generating agent file...
+```
+
+---
+
+## SUCCESS METRICS:
+- All required fields gathered from user
+- Model choice appropriate for agent's purpose
+- Tools follow least privilege principle
+- Permission mode matches risk level
+- System prompt pattern identified
+
+## NEXT STEP:
+After design is confirmed, proceed directly to `./step-02-generate.md`

package/templates/skills/cc-agent/steps/step-02-generate.md

@@ -1,131 +1,131 @@
----
-name: step-02-generate
-description: Generate agent .md file from template based on design choices
-next_step: steps/step-03-validate.md
----
-
-# Step 2: Generate Agent File
-
-## MANDATORY EXECUTION RULES:
-- ALWAYS load the appropriate template from `templates/` directory
-- ALWAYS use the design choices from Step 1
-- For UPDATE: read existing agent first, then apply changes
-- Generate COMPLETE agent file (not a stub)
-
-## YOUR TASK:
-Generate the agent .md file based on the design choices gathered in Step 1.
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Load Template
-
-Based on agent configuration:
-
-```
-Standalone (no category)     → Read: "templates/agent-standalone.md"
-Categorized (with category)  → Read: "templates/agent-categorized.md"
-With preloaded skills        → Read: "templates/agent-with-skills.md"
-```
-
-### 2. Create Directory (if needed)
-
-```bash
-# For categorized agents
-mkdir -p {target_dir}/{category}/
-```
-
-### 3. Generate Frontmatter
-
-Build the YAML frontmatter from design choices:
-
-```yaml
----
-name: {agent_name}
-description: {description}
-```
-
-Add optional fields only if they differ from defaults:
-
-```yaml
-# Only if not inherit
-model: {model}
-
-# Only if explicitly specified
-tools: "{tools}"
-
-# Only if blocking specific tools
-disallowedTools: "{disallowed_tools}"
-
-# Only if not default
-permissionMode: {permission_mode}
-
-# Only if preloading skills
-skills:
-  - {skill_1}
-  - {skill_2}
-
-# Optional visual indicator
-color: {color}
-```
-
-Close frontmatter:
-```yaml
----
-```
-
-### 4. Generate System Prompt Content
-
-Based on the behavior pattern chosen in Step 1:
-
-See [references/agent-behavior-patterns.md](../references/agent-behavior-patterns.md) for the 4 behavior pattern templates:
-- **Explorer**: Search → Read → Analyze → Report (with file references)
-- **Modifier**: Read → Analyze → Edit → Validate → Report
-- **Validator**: Scan → Check → Report (with severity table: ERROR/WARN/INFO)
-- **Custom**: User-driven from Step 1 description
-
-### 5. Write Agent File
-
-Use Write tool to create the file at {target_path}.
-
-### 6. For UPDATE Subcommand
-
-If {subcommand} = "update":
-1. Read existing file at {target_path}
-2. Parse current frontmatter
-3. Apply only the requested changes (merge frontmatter, update content sections)
-4. Use Edit tool for targeted modifications
-5. Preserve custom content not being updated
-
-### 7. Confirm Generation
-
-```
-Generated: {target_path}
-
-Frontmatter:
-  name: {agent_name}
-  description: {description} (truncated)
-  model: {model}
-  tools: {tools}
-  permissionMode: {permission_mode}
-
-Content sections:
-  - Workflow ({step_count} steps)
-  - Execution Rules
-  - Output Format
-
-→ Validating agent...
-```
-
----
-
-## SUCCESS METRICS:
-- Agent .md file created at correct path
-- Frontmatter includes all required and chosen optional fields
-- System prompt is clear and actionable
-- Content follows the chosen behavior pattern
-- No placeholder text left unreplaced
-
-## NEXT STEP:
-Proceed directly to `./step-03-validate.md`
+---
+name: step-02-generate
+description: Generate agent .md file from template based on design choices
+next_step: steps/step-03-validate.md
+---
+
+# Step 2: Generate Agent File
+
+## MANDATORY EXECUTION RULES:
+- ALWAYS load the appropriate template from `templates/` directory
+- ALWAYS use the design choices from Step 1
+- For UPDATE: read existing agent first, then apply changes
+- Generate COMPLETE agent file (not a stub)
+
+## YOUR TASK:
+Generate the agent .md file based on the design choices gathered in Step 1.
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Load Template
+
+Based on agent configuration:
+
+```
+Standalone (no category)     → Read: "templates/agent-standalone.md"
+Categorized (with category)  → Read: "templates/agent-categorized.md"
+With preloaded skills        → Read: "templates/agent-with-skills.md"
+```
+
+### 2. Create Directory (if needed)
+
+```bash
+# For categorized agents
+mkdir -p {target_dir}/{category}/
+```
+
+### 3. Generate Frontmatter
+
+Build the YAML frontmatter from design choices:
+
+```yaml
+---
+name: {agent_name}
+description: {description}
+```
+
+Add optional fields only if they differ from defaults:
+
+```yaml
+# Only if not inherit
+model: {model}
+
+# Only if explicitly specified
+tools: "{tools}"
+
+# Only if blocking specific tools
+disallowedTools: "{disallowed_tools}"
+
+# Only if not default
+permissionMode: {permission_mode}
+
+# Only if preloading skills
+skills:
+  - {skill_1}
+  - {skill_2}
+
+# Optional visual indicator
+color: {color}
+```
+
+Close frontmatter:
+```yaml
+---
+```
+
+### 4. Generate System Prompt Content
+
+Based on the behavior pattern chosen in Step 1:
+
+See [references/agent-behavior-patterns.md](../references/agent-behavior-patterns.md) for the 4 behavior pattern templates:
+- **Explorer**: Search → Read → Analyze → Report (with file references)
+- **Modifier**: Read → Analyze → Edit → Validate → Report
+- **Validator**: Scan → Check → Report (with severity table: ERROR/WARN/INFO)
+- **Custom**: User-driven from Step 1 description
+
+### 5. Write Agent File
+
+Use Write tool to create the file at {target_path}.
+
+### 6. For UPDATE Subcommand
+
+If {subcommand} = "update":
+1. Read existing file at {target_path}
+2. Parse current frontmatter
+3. Apply only the requested changes (merge frontmatter, update content sections)
+4. Use Edit tool for targeted modifications
+5. Preserve custom content not being updated
+
+### 7. Confirm Generation
+
+```
+Generated: {target_path}
+
+Frontmatter:
+  name: {agent_name}
+  description: {description} (truncated)
+  model: {model}
+  tools: {tools}
+  permissionMode: {permission_mode}
+
+Content sections:
+  - Workflow ({step_count} steps)
+  - Execution Rules
+  - Output Format
+
+→ Validating agent...
+```
+
+---
+
+## SUCCESS METRICS:
+- Agent .md file created at correct path
+- Frontmatter includes all required and chosen optional fields
+- System prompt is clear and actionable
+- Content follows the chosen behavior pattern
+- No placeholder text left unreplaced
+
+## NEXT STEP:
+Proceed directly to `./step-03-validate.md`