Spec-Kit: Constitutional Development Framework

Version: 0.0.1

What is Plaesy Spec-Kit?

Plaesy Spec-Kit is a state-of-the-art AI prompt framework featuring true workflow automation from idea to production-ready code. It provides zero-ambiguity prompts with anti-hallucination protocols that enforce disciplined development through mandatory full automation—ensuring quality, security, and maintainability without manual intervention.

Quick Start

Install & Initialize

Linux/macOS:

# Install Plaesy Spec-Kit
curl -s https://raw.githubusercontent.com/plaesy/spec-kit/main/scripts/bash/install.sh | bash

# Initialize new project (interactive AI selection)
plaesy init my-awesome-app

# Or initialize in current directory with specific AI
plaesy init . --ai claude_code

Windows (PowerShell):

# Install Plaesy Spec-Kit
iwr -useb https://raw.githubusercontent.com/plaesy/spec-kit/main/scripts/powershell/install.ps1 | iex

# Initialize new project (interactive AI selection)
plaesy init my-awesome-app

# Or initialize in current directory with specific AI
plaesy init . -AI claude_code

Using any AI assistant with optimized prompts:

# Complete automation from idea to production-ready code
/start Build a privacy-first photo organizer that automatically groups images by event, location, and people

# AI will automatically execute ALL phases:
# 1. Project Analysis → 2. Technical Research → 3. Specification Generation
# 4. Implementation → 5. Quality Review → 6. Performance Optimization
# 7. Bug Resolution → 8. Completion Report with next steps

# Resume work anytime - executes remaining phases automatically
/continue

For Existing Projects: Documentation & Assessment

Before adding features to existing codebases, assess and document the project:

# Comprehensive project assessment
Chat: "/assess @tw ./legacy-application"

# Security-focused assessment
Chat: "/assess @security ./production-system"

# Architecture assessment for new feature planning
Chat: "/assess @architecture ./microservices-platform"

The /assess command generates complete project documentation, analysis, and AI-powered insights with autonomous implementation capabilities.

Essential Commands

# Linux/macOS CLI
plaesy init                    # Interactive AI selection in current directory
plaesy init <directory>        # Interactive AI selection in specified directory
plaesy init <directory> --ai <platform>    # Use specific AI platform in directory
plaesy analyze                 # Analyze current project structure and generate documentation
plaesy test                    # Run comprehensive test suite (NEW!)
plaesy clean                   # Clean current directory
plaesy upgrade                 # Upgrade framework
plaesy status                  # Check installation status and system information
plaesy repair                  # Fix missing components and scripts
plaesy uninstall               # Remove Plaesy Spec-Kit completely

# Windows PowerShell CLI
plaesy init              # Interactive AI selection in current directory
plaesy init <directory>  # Interactive AI selection in specified directory
plaesy init <directory> -AI <platform>    # Use specific AI platform in directory
plaesy analyze           # Analyze current project structure and generate documentation
plaesy clean <directory> # Clean specified directory (default: current)
plaesy upgrade           # Upgrade framework
plaesy status            # Check installation status and system information
plaesy repair            # Fix missing components and scripts
plaesy uninstall         # Remove Plaesy Spec-Kit completely

Popular AI Platforms

• claude_code - Claude Code by Anthropic
• cursor_ai - Cursor AI Assistant
• github_copilot - GitHub Copilot
• windsurf_ai - Windsurf AI

And 6+ other platforms available - see full list in documentation

AI Assistant Workflow Commands

/start <description>     # Begin new development workflow
/assess [role] [path]    # Unified project assessment
/continue                # Resume and complete remaining phases
/implement               # Begin implementation phase with TDD
/optimize                # Performance optimization
/fix                     # Bug resolution
/clarify                 # Requirements clarification
/save                    # Save current context and new knowledge
/research                # Research specific topics
/flow                    # Workflow management

Documentation

The Plaesy documentation system is organized hierarchically:

README.md                    # This file - Quick start guide
└── docs/README.md          # 🎯 **MAIN DOCUMENTATION HUB** - Complete overview
    ├── scripts/             # Automation scripts
    ├── prompts/             # AI-optimized prompts
    ├── templates/           # Project templates
    ├── instructions/        # Technology guides
    ├── chatmodes/           # AI role configurations
    └── checklists/          # Quality frameworks

🔧 Framework Components

Component	Purpose	Quick Access
Scripts	Development automation scripts	docs/scripts/
Prompts	AI-optimized prompts	docs/prompts/
Instructions	Technology-specific guides	docs/instructions/
Templates	Project structure templates	docs/templates/
Chat Modes	AI role configurations	docs/chatmodes/
Checklists	Quality frameworks	docs/checklists/

---

Version Information

Current Version: 0.0.1

Getting Version Information

# Check current version
cat VERSION

# Or use Plaesy CLI (when available)
plaesy --version

---