kiro-scaffold

Kiro Scaffold Plugin for Claude Code

A comprehensive Claude Code plugin for creating spec-driven software projects using kiro.dev methodology with typix integration, nickel contracts, and TDD workflows.

Overview

This plugin enables you to scaffold projects with:

• 📋 Spec-Driven Development: Requirements, design, and tasks defined before implementation
• 🔒 Type Safety: Nickel language contracts mirroring your repository structure
• ✅ TDD Workflows: Test-Driven Development with RED-to-GREEN best practices
• 🛠️ Nix Integration: Reproducible development environments via typix
• 📚 Comprehensive Documentation: CLAUDE.md and .aidocs for context-aware AI assistance
• 🎯 Scoped Implementation: Break down projects into manageable, well-specified scopes
• 📖 Context7 Integration: Up-to-date library documentation via MCP server
• 🔐 Workflow Enforcement: Automated hooks ensure specs, tests, and contracts are complete

Features

Slash Commands

• /kiro-new - Create a new spec-driven project (interactive or headless mode)
• /kiro-spec - Update or regenerate specification files
• /kiro-scope - Create scoped implementation areas with decomposed specs
• /kiro-eval - Evaluate project quality and standards compliance

Specialized Agents

• Kiro Architect - Interactive project design through Q&A
• Kiro Evaluator - Quality assessment and standards validation
• TDD Coach - Test-Driven Development guidance

Autonomous Skills

• Kiro Project Scaffolder - Automatically activates when creating spec-driven projects
• TDD Workflow Guide - Automatically guides through RED-to-GREEN development

MCP Servers

• Context7 - Up-to-date, version-specific documentation for libraries and frameworks
• Nushell (mcp-server-nu) - Execute Nushell scripts for enhanced markdown parsing and structured data handling

Workflow Hooks

• Spec Validation - Blocks code changes without complete specifications
• TDD Enforcement - Requires tests before implementation
• Contract Validation - Type-checks nickel contracts before commits
• Documentation Sync - Reminds to update docs after significant changes

Installation

Quick Install

# Add the marketplace
/plugin marketplace add <your-marketplace-url>

# Install the plugin
/plugin install kiro-scaffold

Manual Installation

1. Clone this repository:

   git clone https://github.com/yourusername/kiro-scaffold.git
   

2. Create a local marketplace:

   cd /path/to/your/marketplaces
   mkdir -p kiro-plugins
   cd kiro-plugins
   

3. Create marketplace.json:

   {
     "name": "kiro-plugins",
     "plugins": {
       "kiro-scaffold": {
         "source": "path:/path/to/kiro-scaffold"
       }
     }
   }
   

4. Add and install:

   /plugin marketplace add /path/to/kiro-plugins
   /plugin install kiro-scaffold@kiro-plugins
   

Quick Start

Create Your First Kiro Project

Interactive Mode (Recommended for first-time use):

/kiro-new my-api-service

Claude will guide you through a Q&A to understand your requirements and generate a complete project scaffold.

Headless Mode (Autonomous inference):

/kiro-new my-api-service --mode=headless --description="A REST API for user authentication with JWT tokens, PostgreSQL database, and Redis caching"

Claude will analyze your description and generate an appropriate scaffold.

Generated Project Structure

my-api-service/
├── .git/                      # Initialized repository
├── CLAUDE.md                  # AI assistant context
├── README.md                  # Project documentation
├── flake.nix                  # Nix environment with typix
├── .aidocs/                   # Reference documentation
│   ├── kiro/                 # kiro.dev methodology
│   ├── typix/                # typix/typist integration
│   └── nickel/               # nickel language reference
├── .kiro/                     # Master specifications
│   ├── steering/             # Project direction
│   └── spec/
│       ├── requirements.md   # What to build
│       ├── design.md         # How to build it
│       └── tasks.md          # Implementation tasks
├── .contracts/                # Nickel type definitions
│   └── (mirrors src/ structure)
└── src/                       # Source code
    └── (scoped implementation areas)

Implementing a Feature with TDD

1. Create a scoped implementation area:

   /kiro-scope src/auth --from-task=AUTH-001 --description="JWT authentication"
   

2. Claude will guide you through:

   • Creating test assertions
   • Writing failing tests (RED)
   • Implementing minimal code (GREEN)
   • Refactoring safely

3. Update specs as you go:

   /kiro-spec --scope=src/auth
   

Evaluate Project Quality

# Terminal report
/kiro-eval