kiro-kit 0.1.0

package/dist/presets/_template/agents/ui-ux-designer.md

@@ -0,0 +1,47 @@
+---
+name: ui-ux-designer
+description: Use when you need UI/UX design work including interface designs, wireframes, design systems, responsive layouts, accessibility audits, or design documentation and review.
+---
+
+You are an elite UI/UX Designer with expertise in creating exceptional user interfaces and experiences. You specialize in interface design, design systems, responsive layouts, accessibility, and cross-platform consistency.
+
+You balance visual appeal with usability, ensuring every design decision serves the user.
+
+## Responsibilities
+
+- Create wireframes and high-fidelity mockups
+- Design and maintain design systems and tokens
+- Ensure accessibility compliance (WCAG 2.1 AA minimum)
+- Implement responsive, mobile-first layouts
+- Review existing interfaces for UX improvements
+- Document design decisions and guidelines
+
+## Process
+
+1. Understand user needs, business requirements, and constraints
+2. Review existing design guidelines in `docs/design-guidelines.md`
+3. Research relevant patterns and current design trends
+4. Create designs starting with mobile-first approach
+5. Validate accessibility (contrast ratios, touch targets, focus states)
+6. Document decisions and update design guidelines
+
+## Output Format
+
+- Design rationale: why this approach was chosen
+- Implementation notes: semantic HTML/CSS/JS guidance
+- Accessibility checklist: WCAG compliance status
+- Responsive breakpoints: mobile, tablet, desktop behavior
+- Design tokens: colors, spacing, typography values
+
+## Quality Standards
+
+- All designs must be responsive (320px+ mobile, 768px+ tablet, 1024px+ desktop)
+- Color contrast must meet WCAG 2.1 AA (4.5:1 normal text, 3:1 large text)
+- Touch targets minimum 44x44px on mobile
+- Animations must respect prefers-reduced-motion
+- Typography must maintain readability (1.5-1.6 line height for body)
+- Mobile-first: always start with mobile and scale up
+- Interactive elements need clear hover, focus, and active states
+- Maintain design system coherence across all touchpoints
+- Prioritize clarity and intuitive navigation over decoration
+- Document all design tokens for developer handoff

package/dist/presets/_template/commands/bootstrap.md

@@ -0,0 +1,15 @@
+---
+description: Bootstrap the project from scratch with dependencies and configuration
+inclusion: manual
+argument-hint: "[environment]"
+---
+
+## Arguments
+ENVIRONMENT: $1 (default: development)
+
+## Workflow
+1. Install dependencies
+2. Copy environment files from examples
+3. Run database migrations if applicable
+4. Verify setup with a build or compile check
+5. Report status

package/dist/presets/_template/commands/clean.md

@@ -0,0 +1,14 @@
+---
+description: Clean build artifacts, caches, and temporary files
+inclusion: manual
+argument-hint: "[scope]"
+---
+
+## Arguments
+SCOPE: $1 (default: all)
+
+## Workflow
+1. Remove build output directories (dist, build, .next, etc.)
+2. Clear package manager caches if scope includes deps
+3. Remove coverage reports and test artifacts
+4. Report cleaned paths

package/dist/presets/_template/commands/design/figma.md

@@ -0,0 +1,14 @@
+---
+description: Extract design tokens or components from a Figma file
+inclusion: manual
+argument-hint: "[figma-url]"
+---
+
+## Arguments
+FIGMA_URL: $1 (required)
+
+## Workflow
+1. Fetch design data from the provided Figma URL
+2. Extract colors, typography, spacing tokens
+3. Generate design token files in project format
+4. Report extracted components and tokens

package/dist/presets/_template/commands/design/system.md

@@ -0,0 +1,14 @@
+---
+description: Analyze or generate the project design system
+inclusion: manual
+argument-hint: "[action]"
+---
+
+## Arguments
+ACTION: $1 (default: analyze)
+
+## Workflow
+1. Scan existing components for design patterns
+2. Identify inconsistencies in spacing, colors, typography
+3. Generate or update design system documentation
+4. Suggest improvements for visual consistency

package/dist/presets/_template/commands/design/wireframe.md

@@ -0,0 +1,14 @@
+---
+description: Generate wireframe markup for a feature or page
+inclusion: manual
+argument-hint: "[feature-name]"
+---
+
+## Arguments
+FEATURE: $1 (required)
+
+## Workflow
+1. Analyze feature requirements
+2. Create wireframe layout in HTML/CSS
+3. Add annotation notes for developers
+4. Output wireframe file path

package/dist/presets/_template/commands/docs/architecture.md

@@ -0,0 +1,14 @@
+---
+description: Generate or update architecture documentation
+inclusion: manual
+argument-hint: "[format]"
+---
+
+## Arguments
+FORMAT: $1 (default: markdown)
+
+## Workflow
+1. Analyze project structure and module dependencies
+2. Identify architectural patterns in use
+3. Generate component diagram descriptions
+4. Output architecture document in specified format

package/dist/presets/_template/commands/docs/summarize.md

@@ -0,0 +1,14 @@
+---
+description: Analyze the codebase and generate a documentation summary
+inclusion: manual
+argument-hint: "[topic]"
+---
+
+## Arguments
+TOPIC: $1 (default: all)
+
+## Workflow
+1. Read existing documentation in docs/ directory
+2. Analyze codebase structure for the specified topic
+3. Generate summary report with coverage gaps
+4. Output summary to docs/ directory

package/dist/presets/_template/commands/docs/update.md

@@ -0,0 +1,14 @@
+---
+description: Update project documentation to match current codebase
+inclusion: manual
+argument-hint: "[scope]"
+---
+
+## Arguments
+SCOPE: $1 (default: all)
+
+## Workflow
+1. Detect recent code changes since last doc update
+2. Identify documentation that needs updating
+3. Update API docs, guides, and architecture docs
+4. Verify links and cross-references

package/dist/presets/_template/commands/fix/build.md

@@ -0,0 +1,14 @@
+---
+description: Diagnose and fix build errors
+inclusion: manual
+argument-hint: "[error-context]"
+---
+
+## Arguments
+CONTEXT: $1 (default: empty)
+
+## Workflow
+1. Run build and capture error output
+2. Analyze compilation or bundling errors
+3. Identify root cause (missing deps, type errors, config issues)
+4. Apply fixes and verify build succeeds

package/dist/presets/_template/commands/fix/lint.md

@@ -0,0 +1,13 @@
+---
+description: Auto-fix linting errors in the project
+inclusion: manual
+argument-hint: "[path]"
+---
+
+## Arguments
+PATH: $1 (default: src)
+
+## Workflow
+1. Run linter with auto-fix flag on specified path
+2. Report fixed issues
+3. List remaining issues that require manual intervention

package/dist/presets/_template/commands/fix/tests.md

@@ -0,0 +1,14 @@
+---
+description: Diagnose and fix failing tests
+inclusion: manual
+argument-hint: "[test-file]"
+---
+
+## Arguments
+TEST_FILE: $1 (default: all failing)
+
+## Workflow
+1. Run test suite and identify failures
+2. Analyze error messages and stack traces
+3. Investigate root cause of each failure
+4. Apply fixes and re-run to verify

package/dist/presets/_template/commands/git/branch.md

@@ -0,0 +1,15 @@
+---
+description: Create and switch to a new feature branch
+inclusion: manual
+argument-hint: "[branch-name]"
+---
+
+## Arguments
+BRANCH: $1 (required)
+
+## Workflow
+1. Ensure working tree is clean or stash changes
+2. Fetch latest from remote
+3. Create branch from main/master
+4. Switch to new branch
+5. Report branch creation

package/dist/presets/_template/commands/git/commit.md

@@ -0,0 +1,15 @@
+---
+description: Stage changes and create a conventional commit
+inclusion: manual
+argument-hint: "[type] [message]"
+---
+
+## Arguments
+TYPE: $1 (default: auto-detect)
+MESSAGE: $2 (default: auto-generate)
+
+## Workflow
+1. Stage relevant files (avoid unrelated changes)
+2. Generate conventional commit message (feat, fix, chore, etc.)
+3. Verify no secrets or env files are staged
+4. Create commit

package/dist/presets/_template/commands/git/pr.md

@@ -0,0 +1,14 @@
+---
+description: Create a pull request from current branch
+inclusion: manual
+argument-hint: "[target-branch]"
+---
+
+## Arguments
+TARGET: $1 (default: main)
+
+## Workflow
+1. Push current branch to remote
+2. Create pull request to target branch using gh CLI
+3. Include summary of changes in PR description
+4. Report PR URL

package/dist/presets/_template/commands/lint.md

@@ -0,0 +1,14 @@
+---
+description: Run linting across the project and report issues
+inclusion: manual
+argument-hint: "[path]"
+---
+
+## Arguments
+PATH: $1 (default: src)
+
+## Workflow
+1. Detect available linter (eslint, biome, ruff, golangci-lint)
+2. Run linter on the specified path
+3. Report errors and warnings with file locations
+4. Suggest auto-fix command if issues found

package/dist/presets/_template/commands/plan/feature.md

@@ -0,0 +1,15 @@
+---
+description: Create an implementation plan for a new feature
+inclusion: manual
+argument-hint: "[feature-name]"
+---
+
+## Arguments
+FEATURE: $1 (required)
+
+## Workflow
+1. Analyze requirements for the feature
+2. Research relevant technical approaches
+3. Break down into concrete implementation tasks
+4. Create plan document with phases and dependencies
+5. Output plan file path

package/dist/presets/_template/commands/plan/refactor.md

@@ -0,0 +1,15 @@
+---
+description: Plan a refactoring effort for a module or pattern
+inclusion: manual
+argument-hint: "[target]"
+---
+
+## Arguments
+TARGET: $1 (required)
+
+## Workflow
+1. Analyze current implementation of the target
+2. Identify code smells and improvement opportunities
+3. Plan refactoring steps with minimal disruption
+4. Define verification criteria (tests must pass)
+5. Output refactoring plan

package/dist/presets/_template/commands/release.md

@@ -0,0 +1,16 @@
+---
+description: Prepare and execute a release
+inclusion: manual
+argument-hint: "[version]"
+---
+
+## Arguments
+VERSION: $1 (default: patch)
+
+## Workflow
+1. Verify working tree is clean
+2. Run full test suite
+3. Bump version (patch, minor, major, or explicit semver)
+4. Update CHANGELOG.md with release notes
+5. Create git tag
+6. Push tag to trigger CI publish

package/dist/presets/_template/commands/review/code.md

@@ -0,0 +1,14 @@
+---
+description: Review code for quality, patterns, and potential issues
+inclusion: manual
+argument-hint: "[path-or-branch]"
+---
+
+## Arguments
+TARGET: $1 (default: staged changes)
+
+## Workflow
+1. Identify files to review (diff or path)
+2. Check for code quality issues and anti-patterns
+3. Verify error handling and edge cases
+4. Report findings with severity and suggestions

package/dist/presets/_template/commands/review/security.md

@@ -0,0 +1,14 @@
+---
+description: Review code for security vulnerabilities
+inclusion: manual
+argument-hint: "[path]"
+---
+
+## Arguments
+PATH: $1 (default: src)
+
+## Workflow
+1. Scan for common vulnerability patterns (injection, XSS, auth issues)
+2. Check dependency versions for known CVEs
+3. Verify secrets are not hardcoded
+4. Report findings with severity and remediation steps

package/dist/presets/_template/commands/scout/ext.md

@@ -0,0 +1,15 @@
+---
+description: Search codebase using external agentic tools
+inclusion: manual
+argument-hint: "[query] [scale]"
+---
+
+## Arguments
+QUERY: $1 (required)
+SCALE: $2 (default: 3)
+
+## Workflow
+1. Analyze query and divide codebase into search sections
+2. Launch external tools in parallel for each section
+3. Collect and deduplicate results
+4. Report organized file list with coverage notes

package/dist/presets/_template/commands/scout.md

@@ -0,0 +1,15 @@
+---
+description: Search the codebase for files relevant to a task
+inclusion: manual
+argument-hint: "[query] [scale]"
+---
+
+## Arguments
+QUERY: $1 (required)
+SCALE: $2 (default: 3)
+
+## Workflow
+1. Analyze the search query to identify relevant directories
+2. Search codebase in parallel for matching files
+3. Synthesize results into organized file list
+4. Report relevant files grouped by category

package/dist/presets/_template/commands/skill/add.md

@@ -0,0 +1,15 @@
+---
+description: Add a new skill or reference files to an existing skill
+inclusion: manual
+argument-hint: "[skill-name] [source]"
+---
+
+## Arguments
+SKILL: $1 (required)
+SOURCE: $2 (required)
+
+## Workflow
+1. Create skill directory if it does not exist
+2. Generate SKILL.md with front-matter from source
+3. Add reference files or scripts as needed
+4. Verify skill structure is valid

package/dist/presets/_template/commands/skill/create.md

@@ -0,0 +1,15 @@
+---
+description: Create a new skill from scratch
+inclusion: manual
+argument-hint: "[skill-name] [description]"
+---
+
+## Arguments
+SKILL: $1 (required)
+DESCRIPTION: $2 (required)
+
+## Workflow
+1. Create skill directory under skills/
+2. Generate SKILL.md with front-matter and body
+3. Create references/, scripts/, assets/ subdirectories
+4. Report created skill path

package/dist/presets/_template/commands/skill/optimize.md

@@ -0,0 +1,14 @@
+---
+description: Optimize an existing skill for token efficiency
+inclusion: manual
+argument-hint: "[skill-name]"
+---
+
+## Arguments
+SKILL: $1 (required)
+
+## Workflow
+1. Read current skill content and references
+2. Analyze token consumption and redundancy
+3. Propose optimizations (progressive disclosure, trimming)
+4. Apply changes after confirmation

package/dist/presets/_template/commands/test.md

@@ -0,0 +1,15 @@
+---
+description: Run the project test suite
+inclusion: manual
+argument-hint: "[scope] [flags]"
+---
+
+## Arguments
+SCOPE: $1 (default: all)
+FLAGS: $2 (default: empty)
+
+## Workflow
+1. Detect test runner (vitest, jest, pytest, go test, cargo test)
+2. Run tests for the specified scope
+3. Report pass/fail summary with coverage if available
+4. Highlight failing tests with error details

package/dist/presets/_template/docs/.gitkeep

@@ -0,0 +1 @@
+

package/dist/presets/_template/hooks/.env.example

@@ -0,0 +1,9 @@
+# Hook environment variables
+# Copy this file to .env and fill in your values.
+
+# Discord webhook URL for notifications
+DISCORD_WEBHOOK_URL=<your-discord-webhook-url>
+
+# Telegram bot token and chat ID for notifications
+TELEGRAM_BOT_TOKEN=<your-telegram-bot-token>
+TELEGRAM_CHAT_ID=<your-telegram-chat-id>

package/dist/presets/_template/hooks/README.md

@@ -0,0 +1,28 @@
+# Hooks
+
+Cross-platform hook scripts for Kiro IDE automation.
+
+## Available Hooks
+
+| Hook | Trigger | Description |
+|------|---------|-------------|
+| scout-block | PreToolUse | Blocks dangerous commands (rm -rf, drop database, etc.) |
+| modularization-hook | PostToolUse | Warns when files exceed 200 lines |
+| discord-notify | agentStop | Sends notification via Discord webhook |
+| telegram-notify | agentStop | Sends notification via Telegram bot |
+| pre-commit-lint | PreToolUse | Runs linter before commit |
+| git-status-tracker | PostToolUse | Logs git working tree status summary |
+
+## Platform Support
+
+Each hook has a primary `.js` (Node.js) version and platform-specific fallbacks:
+- `.js` - Cross-platform (requires Node.js)
+- `.sh` - Unix/macOS/Linux (bash)
+- `.ps1` - Windows (PowerShell)
+
+## Environment Variables
+
+Copy `hooks/.env.example` to `hooks/.env` and configure:
+- `DISCORD_WEBHOOK_URL` - Required for discord-notify
+- `TELEGRAM_BOT_TOKEN` - Required for telegram-notify
+- `TELEGRAM_CHAT_ID` - Required for telegram-notify

package/dist/presets/_template/hooks/discord-notify.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+// Sends a notification to Discord via webhook.
+// Requires DISCORD_WEBHOOK_URL in hooks/.env or environment.
+
+const https = require('https');
+
+const WEBHOOK_URL = process.env.DISCORD_WEBHOOK_URL || '';
+const message = process.argv.slice(2).join(' ') || 'Agent task completed.';
+
+if (!WEBHOOK_URL) {
+  process.stderr.write('[discord-notify] DISCORD_WEBHOOK_URL not set. Skipping.\n');
+  process.exit(0);
+}
+
+const url = new URL(WEBHOOK_URL);
+const payload = JSON.stringify({ content: message });
+
+const options = {
+  hostname: url.hostname,
+  path: url.pathname,
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload) },
+};
+
+const req = https.request(options, (res) => {
+  process.exit(res.statusCode >= 200 && res.statusCode < 300 ? 0 : 1);
+});
+
+req.on('error', () => process.exit(1));
+req.write(payload);
+req.end();

package/dist/presets/_template/hooks/discord-notify.ps1

@@ -0,0 +1,19 @@
+# Sends a notification to Discord via webhook.
+# Requires DISCORD_WEBHOOK_URL in environment.
+
+$Message = if ($args.Count -gt 0) { $args -join ' ' } else { 'Agent task completed.' }
+
+$WebhookUrl = $env:DISCORD_WEBHOOK_URL
+
+if (-not $WebhookUrl) {
+    Write-Error "[discord-notify] DISCORD_WEBHOOK_URL not set. Skipping."
+    exit 0
+}
+
+$Body = @{ content = $Message } | ConvertTo-Json
+try {
+    Invoke-RestMethod -Uri $WebhookUrl -Method Post -Body $Body -ContentType 'application/json'
+    exit 0
+} catch {
+    exit 1
+}

package/dist/presets/_template/hooks/discord-notify.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Sends a notification to Discord via webhook.
+# Requires DISCORD_WEBHOOK_URL in environment.
+
+MESSAGE="${*:-Agent task completed.}"
+
+if [ -z "$DISCORD_WEBHOOK_URL" ]; then
+  echo "[discord-notify] DISCORD_WEBHOOK_URL not set. Skipping." >&2
+  exit 0
+fi
+
+curl -s -o /dev/null -w "%{http_code}" \
+  -H "Content-Type: application/json" \
+  -d "{\"content\": \"$MESSAGE\"}" \
+  "$DISCORD_WEBHOOK_URL" | grep -q "^2" && exit 0 || exit 1

package/dist/presets/_template/hooks/git-status-tracker.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// Tracks git status changes and logs summary.
+// Useful as a PostToolUse or agentStop hook.
+
+const { execSync } = require('child_process');
+
+try {
+  const status = execSync('git status --porcelain', { encoding: 'utf8' }).trim();
+  if (!status) {
+    process.stdout.write('[git-status] Working tree clean.\n');
+    process.exit(0);
+  }
+
+  const lines = status.split('\n');
+  const added = lines.filter((l) => l.startsWith('A') || l.startsWith('?')).length;
+  const modified = lines.filter((l) => l.startsWith('M') || l.startsWith(' M')).length;
+  const deleted = lines.filter((l) => l.startsWith('D') || l.startsWith(' D')).length;
+
+  process.stdout.write(
+    `[git-status] ${lines.length} changes: +${added} ~${modified} -${deleted}\n`
+  );
+} catch (err) {
+  process.stderr.write('[git-status] Not a git repository or git unavailable.\n');
+}
+
+process.exit(0);

package/dist/presets/_template/hooks/modularization-hook.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// PostToolUse hook: warns when a file exceeds 200 lines.
+// Encourages splitting large files into smaller modules.
+
+const fs = require('fs');
+const path = require('path');
+
+const MAX_LINES = 200;
+const CODE_EXTENSIONS = ['.js', '.ts', '.jsx', '.tsx', '.py', '.go', '.rs', '.java'];
+
+const filePath = process.argv[2] || '';
+
+if (!filePath || !fs.existsSync(filePath)) {
+  process.exit(0);
+}
+
+const ext = path.extname(filePath).toLowerCase();
+if (!CODE_EXTENSIONS.includes(ext)) {
+  process.exit(0);
+}
+
+try {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lineCount = content.split('\n').length;
+
+  if (lineCount > MAX_LINES) {
+    process.stderr.write(
+      `[modularization] Warning: ${filePath} has ${lineCount} lines (max ${MAX_LINES}). Consider splitting.\n`
+    );
+    process.exit(1);
+  }
+} catch (err) {
+  // Silently ignore read errors
+}
+
+process.exit(0);

package/dist/presets/_template/hooks/pre-commit-lint.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// Pre-commit hook: runs linter on staged files.
+// Exits non-zero if lint fails, preventing commit.
+
+const { execSync } = require('child_process');
+
+try {
+  execSync('npm run lint --silent', { stdio: 'pipe' });
+  process.exit(0);
+} catch (err) {
+  process.stderr.write('[pre-commit-lint] Lint failed. Fix errors before committing.\n');
+  if (err.stdout) process.stderr.write(err.stdout.toString());
+  if (err.stderr) process.stderr.write(err.stderr.toString());
+  process.exit(1);
+}