kiro-kit 0.1.0

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

@@ -0,0 +1,16 @@
+---
+description: Bootstrap the project from scratch with dependencies, database, and configuration
+inclusion: manual
+argument-hint: "[environment]"
+---
+
+## Arguments
+ENVIRONMENT: $1 (default: development)
+
+## Workflow
+1. Install dependencies with `pnpm install` or `npm install`
+2. Copy environment files from `.env.example` to `.env.local`
+3. Run database migrations (`npx prisma migrate dev` or `npx drizzle-kit push`)
+4. Generate database client (`npx prisma generate` if using Prisma)
+5. Verify setup with `next build` or `tsc --noEmit`
+6. Report status

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

@@ -0,0 +1,12 @@
+---
+description: Clean build artifacts, caches, and temporary files
+inclusion: manual
+---
+
+## Workflow
+1. Remove `node_modules/.cache`
+2. Remove `.next/` build directory
+3. Remove `dist/` output directory
+4. Remove coverage reports
+5. Optionally remove `node_modules/` if `--full` flag passed
+6. Report cleaned directories and freed space

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

@@ -0,0 +1,15 @@
+---
+description: Extract design tokens and component specs from Figma
+inclusion: manual
+argument-hint: "[figma-url]"
+---
+
+## Arguments
+FIGMA_URL: $1 (required)
+
+## Workflow
+1. Fetch design data from Figma URL
+2. Extract color tokens, typography, and spacing values
+3. Generate CSS custom properties or Tailwind config
+4. Document component specifications
+5. Report extracted tokens and suggested implementation

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

@@ -0,0 +1,11 @@
+---
+description: Generate or update the design system documentation
+inclusion: manual
+---
+
+## Workflow
+1. Analyze existing components and their visual patterns
+2. Extract color palette, typography scale, and spacing tokens
+3. Document component variants and states
+4. Generate design system documentation
+5. Report coverage and gaps

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

@@ -0,0 +1,15 @@
+---
+description: Create a wireframe layout for a page or feature
+inclusion: manual
+argument-hint: "[page-name]"
+---
+
+## Arguments
+PAGE: $1 (required)
+
+## Workflow
+1. Understand page requirements and user flows
+2. Design layout structure with content hierarchy
+3. Create wireframe using HTML/CSS or description
+4. Document responsive breakpoint behavior
+5. Report wireframe with annotations

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

@@ -0,0 +1,11 @@
+---
+description: Generate or update system architecture documentation
+inclusion: manual
+---
+
+## Workflow
+1. Analyze project structure and dependencies
+2. Identify architectural patterns in use
+3. Generate architecture diagram (Mermaid)
+4. Document data flow and component interactions
+5. Update docs/system-architecture.md

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

@@ -0,0 +1,15 @@
+---
+description: Analyze the codebase and generate documentation summary
+inclusion: manual
+argument-hint: "[focused-topics]"
+---
+
+## Arguments
+TOPICS: $1 (default: all)
+
+## Workflow
+1. Read existing documentation in `docs/` directory
+2. Analyze codebase structure and patterns
+3. Identify documentation gaps
+4. Generate summary report with recommendations
+5. Do NOT start implementing -- report only

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

@@ -0,0 +1,15 @@
+---
+description: Update documentation to reflect recent code changes
+inclusion: manual
+argument-hint: "[scope]"
+---
+
+## Arguments
+SCOPE: $1 (default: all)
+
+## Workflow
+1. Identify recent code changes via git log
+2. Cross-reference with existing documentation
+3. Update affected documentation sections
+4. Verify links and code examples still work
+5. Report updated files

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

@@ -0,0 +1,11 @@
+---
+description: Diagnose and fix build errors
+inclusion: manual
+---
+
+## Workflow
+1. Run build command and capture errors
+2. Analyze TypeScript errors, import issues, and config problems
+3. Fix identified issues
+4. Re-run build to verify
+5. Report resolution summary

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

@@ -0,0 +1,10 @@
+---
+description: Auto-fix linting errors across the project
+inclusion: manual
+---
+
+## Workflow
+1. Run ESLint with --fix flag
+2. Run Prettier with --write flag
+3. Report remaining unfixable issues
+4. Verify build still passes after fixes

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

@@ -0,0 +1,16 @@
+---
+description: Diagnose and fix failing tests
+inclusion: manual
+argument-hint: "[test-pattern]"
+---
+
+## Arguments
+PATTERN: $1 (default: failing tests)
+
+## Workflow
+1. Run test suite and identify failures
+2. Analyze error messages and stack traces
+3. Determine root cause (code bug vs test bug)
+4. Fix the identified issues
+5. Re-run tests to verify
+6. Report resolution summary

package/dist/presets/fullstack/commands/fullstack/api-route.md

@@ -0,0 +1,17 @@
+---
+description: Generate a new API route handler with validation and error handling
+inclusion: manual
+argument-hint: "[resource-name] [methods]"
+---
+
+## Arguments
+RESOURCE: $1 (required, e.g. "users", "products")
+METHODS: $2 (default: "GET,POST")
+
+## Workflow
+1. Create route file at `src/app/api/$1/route.ts`
+2. Add Zod validation schemas for request bodies
+3. Implement specified HTTP methods with proper error handling
+4. Add authentication middleware check
+5. Create corresponding service layer function
+6. Report created files and next steps

package/dist/presets/fullstack/commands/fullstack/component.md

@@ -0,0 +1,17 @@
+---
+description: Generate a React component with TypeScript types and test file
+inclusion: manual
+argument-hint: "[component-name] [type]"
+---
+
+## Arguments
+NAME: $1 (required, PascalCase)
+TYPE: $2 (default: "server", options: server, client)
+
+## Workflow
+1. Create component file at appropriate location
+2. Add TypeScript props interface
+3. Add `'use client'` directive if type is client
+4. Create colocated test file
+5. Export from barrel file if one exists
+6. Report created files

package/dist/presets/fullstack/commands/fullstack/deploy.md

@@ -0,0 +1,17 @@
+---
+description: Deploy the application to production or preview environment
+inclusion: manual
+argument-hint: "[environment]"
+---
+
+## Arguments
+ENVIRONMENT: $1 (default: preview, options: preview, production)
+
+## Workflow
+1. Run full test suite and verify passing
+2. Run build to verify no errors
+3. If preview: deploy to preview URL (Vercel preview, etc.)
+4. If production: verify branch is main, deploy with production flag
+5. Run database migrations if pending
+6. Verify deployment health check
+7. Report deployment URL and status

package/dist/presets/fullstack/commands/fullstack/migration.md

@@ -0,0 +1,16 @@
+---
+description: Create and run a database migration
+inclusion: manual
+argument-hint: "[migration-name]"
+---
+
+## Arguments
+NAME: $1 (required, descriptive name like "add-user-roles")
+
+## Workflow
+1. Detect ORM in use (Prisma or Drizzle)
+2. If Prisma: update schema.prisma, run `npx prisma migrate dev --name $1`
+3. If Drizzle: create migration file, run `npx drizzle-kit generate`
+4. Verify migration applies cleanly
+5. Generate updated client types
+6. Report migration status and any warnings

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

@@ -0,0 +1,15 @@
+---
+description: Create a new branch following naming conventions
+inclusion: manual
+argument-hint: "[type] [description]"
+---
+
+## Arguments
+TYPE: $1 (required: feature, fix, refactor, chore)
+DESCRIPTION: $2 (required)
+
+## Workflow
+1. Verify current branch is up to date
+2. Create branch with format: `$1/$2` (kebab-case)
+3. Switch to new branch
+4. Report branch name and base

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

@@ -0,0 +1,16 @@
+---
+description: Create a conventional commit with staged changes
+inclusion: manual
+argument-hint: "[type] [message]"
+---
+
+## Arguments
+TYPE: $1 (default: inferred from changes)
+MESSAGE: $2 (default: generated from diff)
+
+## Workflow
+1. Review staged changes
+2. Determine commit type (feat, fix, refactor, docs, chore)
+3. Generate descriptive commit message
+4. Create commit with conventional format
+5. Report commit hash and message

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

@@ -0,0 +1,16 @@
+---
+description: Create a pull request with conventional format
+inclusion: manual
+argument-hint: "[target-branch] [source-branch]"
+---
+
+## Arguments
+TARGET: $1 (default: main)
+SOURCE: $2 (default: current branch)
+
+## Workflow
+1. Verify working tree is clean
+2. Push current branch to remote
+3. Create PR with title from latest commit
+4. Add description with change summary
+5. Report PR URL

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

@@ -0,0 +1,11 @@
+---
+description: Run linting and formatting checks across the project
+inclusion: manual
+---
+
+## Workflow
+1. Run ESLint on source files: `npx eslint . --ext .ts,.tsx,.js,.jsx`
+2. Run Prettier check: `npx prettier --check .`
+3. Run TypeScript type check: `npx tsc --noEmit`
+4. Report results with error counts and fix suggestions
+5. If `--fix` flag passed, auto-fix what is possible

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

@@ -0,0 +1,15 @@
+---
+description: Create an implementation plan for a new feature
+inclusion: manual
+argument-hint: "[feature-description]"
+---
+
+## Arguments
+FEATURE: $1 (required)
+
+## Workflow
+1. Analyze feature requirements
+2. Research relevant patterns and libraries
+3. Decompose into phases with deliverables
+4. Identify risks and dependencies
+5. Output plan to `plans/` directory

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

@@ -0,0 +1,15 @@
+---
+description: Plan a refactoring effort with risk assessment
+inclusion: manual
+argument-hint: "[target-area]"
+---
+
+## Arguments
+TARGET: $1 (required)
+
+## Workflow
+1. Analyze current code structure and pain points
+2. Identify refactoring goals and constraints
+3. Plan incremental steps (each step must leave code working)
+4. Assess risk and identify test coverage gaps
+5. Output plan to `plans/` directory

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

@@ -0,0 +1,17 @@
+---
+description: Prepare and execute a release with version bump and changelog
+inclusion: manual
+argument-hint: "[version-type]"
+---
+
+## Arguments
+VERSION_TYPE: $1 (default: patch, options: major, minor, patch)
+
+## Workflow
+1. Verify working tree is clean
+2. Run full test suite
+3. Bump version in package.json
+4. Update CHANGELOG.md with new entries
+5. Create git commit and tag
+6. Push to remote with tags
+7. Report release summary

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

@@ -0,0 +1,15 @@
+---
+description: Review recent code changes for quality and correctness
+inclusion: manual
+argument-hint: "[file-or-branch]"
+---
+
+## Arguments
+TARGET: $1 (default: staged changes)
+
+## Workflow
+1. Identify files to review (staged, branch diff, or specific file)
+2. Analyze code quality, patterns, and potential issues
+3. Check TypeScript strictness and type safety
+4. Verify error handling and edge cases
+5. Report findings categorized by severity

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

@@ -0,0 +1,16 @@
+---
+description: Run a security review on the codebase
+inclusion: manual
+argument-hint: "[scope]"
+---
+
+## Arguments
+SCOPE: $1 (default: recent changes)
+
+## Workflow
+1. Check for hardcoded secrets and credentials
+2. Review authentication and authorization logic
+3. Check for injection vulnerabilities (SQL, XSS, CSRF)
+4. Verify input validation on all endpoints
+5. Check dependency vulnerabilities (`npm audit`)
+6. Report findings with severity and remediation steps

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

@@ -0,0 +1,17 @@
+---
+description: Scout codebase using external agentic tools for faster search
+inclusion: manual
+argument-hint: "[search-query] [scale]"
+---
+
+## Arguments
+QUERY: $1 (required)
+SCALE: $2 (default: 3)
+
+## Workflow
+1. Analyze search query and determine agent count
+2. Divide codebase into sections for parallel search
+3. Launch external tools (Gemini, OpenCode) in parallel
+4. Collect results within 3-minute timeout
+5. Synthesize and deduplicate findings
+6. Report organized file list

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

@@ -0,0 +1,16 @@
+---
+description: Scout the codebase for files relevant to a task
+inclusion: manual
+argument-hint: "[search-query] [scale]"
+---
+
+## Arguments
+QUERY: $1 (required)
+SCALE: $2 (default: 3)
+
+## Workflow
+1. Analyze the search query and identify key directories
+2. Divide codebase into logical sections for parallel searching
+3. Search each section for files matching the query
+4. Deduplicate and organize results by category
+5. Present file list with any coverage gaps noted

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

@@ -0,0 +1,16 @@
+---
+description: Add new reference files or scripts to a skill
+inclusion: manual
+argument-hint: "[skill-name] [reference-prompt]"
+---
+
+## Arguments
+SKILL: $1 (required)
+PROMPT: $2 (required)
+
+## Workflow
+1. Locate skill directory at `.kiro/skills/$1`
+2. Analyze the reference or script requirements
+3. Create appropriate files in the skill directory
+4. Update SKILL.md if needed
+5. Report added files

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

@@ -0,0 +1,16 @@
+---
+description: Create a new skill from scratch
+inclusion: manual
+argument-hint: "[skill-name] [description]"
+---
+
+## Arguments
+NAME: $1 (required)
+DESCRIPTION: $2 (required)
+
+## Workflow
+1. Create directory at `.kiro/skills/$1`
+2. Generate SKILL.md with front-matter and content
+3. Create references/ directory if detailed docs needed
+4. Verify skill structure is valid
+5. Report created files

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

@@ -0,0 +1,16 @@
+---
+description: Optimize an existing agent skill for better performance
+inclusion: manual
+argument-hint: "[skill-name] [prompt]"
+---
+
+## Arguments
+SKILL: $1 (required)
+PROMPT: $2 (default: empty)
+
+## Workflow
+1. Read current skill at `.kiro/skills/$1`
+2. Analyze token efficiency and coverage
+3. Propose optimization plan
+4. Ask user to review before implementing
+5. Apply approved changes

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

@@ -0,0 +1,15 @@
+---
+description: Run the test suite with coverage reporting
+inclusion: manual
+argument-hint: "[pattern]"
+---
+
+## Arguments
+PATTERN: $1 (default: all tests)
+
+## Workflow
+1. Run Vitest with coverage: `npx vitest run --coverage`
+2. If pattern provided, filter tests: `npx vitest run $1`
+3. Report test results summary (passed, failed, skipped)
+4. Report coverage metrics (lines, branches, functions)
+5. Highlight any failing tests with error details

package/dist/presets/fullstack/docs/code-standards.md

@@ -0,0 +1,74 @@
+# Code Standards
+
+## TypeScript
+
+- Strict mode enabled (`strict: true` in tsconfig)
+- No `any` types -- use `unknown` and narrow with type guards
+- Explicit return types on exported functions
+- Use `interface` for object shapes, `type` for unions/intersections
+- Share types between client and server via `src/types/`
+
+## React Components
+
+- Functional components only (no class components)
+- Server Components by default, Client Components only when needed
+- Props interface exported separately from component
+- Maximum 150 lines per component file
+- Colocate tests with components
+
+## Backend / API
+
+- Layered architecture: handler -> service -> repository
+- Validate all input with Zod at the handler layer
+- Return consistent error response format
+- Use parameterized queries (never string concatenation)
+- Keep route handlers thin -- delegate to service layer
+
+## File Organization
+
+```
+src/
+  app/                 Next.js routes (pages, layouts, API)
+  components/
+    ui/                Base UI primitives (shadcn/ui)
+    [feature]/         Feature-grouped components
+  server/
+    api/               tRPC routers or service layer
+    db/                Database schema and queries
+    auth/              Authentication configuration
+  hooks/               Custom React hooks
+  lib/                 Utilities, API clients, helpers
+  types/               Shared TypeScript definitions
+```
+
+## Naming
+
+- Files: kebab-case (`user-profile.tsx`, `api-client.ts`)
+- Components: PascalCase (`UserProfile`)
+- Hooks: camelCase with `use` prefix (`useAuth`)
+- API routes: kebab-case paths (`/api/user-settings`)
+- Database tables: snake_case (`user_profiles`)
+- Environment variables: UPPER_SNAKE_CASE (`DATABASE_URL`)
+
+## Testing
+
+- Vitest as test runner
+- React Testing Library for component tests
+- Test behavior, not implementation details
+- Playwright for E2E tests
+- Colocate test files with source
+
+## Error Handling
+
+- Error boundaries at route segment level
+- Try-catch for async operations with typed errors
+- Structured error responses from API routes
+- Log errors to monitoring service in production
+- Never swallow errors silently
+
+## Git Conventions
+
+- Conventional commits: `type(scope): description`
+- Branch naming: `feature/description`, `fix/description`
+- PR titles under 72 characters
+- Squash merge to main

package/dist/presets/fullstack/docs/project-roadmap.md

@@ -0,0 +1,78 @@
+# Project Roadmap
+
+## Current Phase: [Phase Name]
+
+**Status**: In Progress
+**Target**: [Date]
+
+## Phase 1: Foundation
+
+**Status**: Not Started
+**Priority**: High
+
+- [ ] Project setup (Next.js, TypeScript, Tailwind, ORM)
+- [ ] Database schema and initial migrations
+- [ ] Authentication and authorization
+- [ ] Core layout and navigation
+- [ ] CI/CD pipeline
+
+**Success Criteria**: App builds, deploys, authenticates users, and connects to database.
+
+## Phase 2: Core Features
+
+**Status**: Not Started
+**Priority**: High
+
+- [ ] [Feature 1] (frontend + API + database)
+- [ ] [Feature 2] (frontend + API + database)
+- [ ] [Feature 3] (frontend + API + database)
+- [ ] Error handling and monitoring
+- [ ] API documentation
+
+**Success Criteria**: Core user flows work end-to-end with data persistence.
+
+## Phase 3: Payments and Integrations
+
+**Status**: Not Started
+**Priority**: Medium
+
+- [ ] Payment integration (Stripe/Polar)
+- [ ] Subscription management
+- [ ] Webhook handling
+- [ ] Third-party API integrations
+- [ ] Email notifications
+
+**Success Criteria**: Users can subscribe, pay, and receive automated benefits.
+
+## Phase 4: Polish and Performance
+
+**Status**: Not Started
+**Priority**: Medium
+
+- [ ] Performance optimization (Core Web Vitals + API latency)
+- [ ] Accessibility audit and fixes
+- [ ] Caching strategy (Redis, ISR)
+- [ ] Loading and error state refinement
+- [ ] Security audit
+
+**Success Criteria**: Lighthouse 90+, API p95 under 200ms, no critical vulnerabilities.
+
+## Phase 5: Launch
+
+**Status**: Not Started
+**Priority**: High
+
+- [ ] Production deployment
+- [ ] Monitoring and alerting setup
+- [ ] Documentation finalization
+- [ ] User feedback collection
+- [ ] Post-launch fixes
+
+**Success Criteria**: Stable production deployment with monitoring.
+
+---
+
+## Changelog
+
+### [Unreleased]
+- Initial project setup