🚀 SPAC-KIT — Spec-Driven Development Kit

by Pi R Square Co., LTD

Generate spec templates for any project in seconds. One command gives you a complete spac/ folder with everything your team (and AI) needs to start building.

---

How It Works

Step 1: Generate Specs

npx @pirsquare.auto/spac-kit init

The CLI walks you through:

┌──────────────────────────────────────────────────┐
│  🚀 SPAC-KIT — Spec-Driven Development Kit     │
│  by Pi R Square Co., LTD                        │
└──────────────────────────────────────────────────┘

? Project name: my-awesome-app

? Project type:
  ❯ Web App (Full-stack)
    API / Backend Service
    E-commerce / Marketplace
    SaaS Platform
    Mobile App
    Landing Page / Marketing Site
    Internal Tool / Admin Dashboard

? Select additional specs (required specs are always included):
  ◉ API Design
  ◉ User Stories
  ◉ Roadmap
  ◉ Sitemap

✅ Project my-awesome-app created successfully!

Output:

my-awesome-app/
└── spac/
    ├── 00-SCOPE-OF-WORK.md       ← Entry point (for team & AI)
    ├── 01-PRD.md                  ← ⭐ Required
    ├── 02-TECH-STACK.md           ← ⭐ Required
    ├── 03-DATABASE-SCHEMA.md      ← ⭐ Required
    ├── 04-PROJECT-STRUCTURE.md    ← ⭐ Required
    ├── 05-API-DESIGN.md           ← 📎 Optional
    ├── 06-USER-STORIES.md         ← 📎 Optional
    ├── 07-ROADMAP.md              ← 📎 Optional
    └── 08-SITEMAP.md              ← 📎 Optional

Already know your project name? Run directly: npx @pirsquare.auto/spac-kit init my-project

---

Step 2: Fill in Specs

Open each file in spac/ and fill in the sections. Each template comes with pre-filled defaults and <!-- TODO --> guides.

Recommended order:

Order	File	What to fill in
1	01-PRD.md	What is this project? What problem does it solve? Who uses it?
2	02-TECH-STACK.md	Framework, database, hosting, libraries
3	03-DATABASE-SCHEMA.md	Tables, columns, relations, indexes
4	04-PROJECT-STRUCTURE.md	Folder structure, apps, packages, scripts
5+	Optional specs	API endpoints, user stories, roadmap, sitemap

Each file includes suggested hints based on the project type you selected. For example, E-commerce comes with products, orders, payments tables ready to go.

---

Step 3: Hand Off to AI

Open spac/00-SCOPE-OF-WORK.md for instructions on how to use with any AI tool:

AI Tool	How to use
Claude Code	Copy 00-SCOPE-OF-WORK.md content into CLAUDE.md at the project root
ChatGPT	Paste all spec files as context before giving instructions
Cursor / AI IDE	Add spac/ folder as context files in settings
Other AI	Send 00-SCOPE-OF-WORK.md along with relevant spec files as reference

The AI reads your specs and understands the full context — tech stack, database schema, project structure — then builds accordingly.

---

Installation

npx (recommended — no install needed)

npx @pirsquare.auto/spac-kit init

Global install

npm i -g @pirsquare.auto/spac-kit
spac-kit init

GitHub Template

gh repo create my-project --template Pi-R-SQUARE-Co-ltd/spac-kit

---

Project Type Presets

When you select a project type, templates are customized with relevant defaults — database tables, tech stack suggestions, feature hints.

Type	Hints
Web App (Full-stack)	Next.js + Node.js + PostgreSQL, users/sessions tables
API / Backend Service	Express/Fastify + PostgreSQL + Redis, api_logs table
E-commerce / Marketplace	Next.js + Stripe, products/orders/categories tables
SaaS Platform	Multi-tenant, organizations/subscriptions/invitations tables
Mobile App	React Native (Expo), devices/push_tokens tables
Landing Page / Marketing	Astro/Next.js + CMS, contacts/subscribers tables
Internal Tool / Admin	Refine/AdminJS, audit_logs/role-based access tables

---

Spec Files

#	File	Type	Contents
00	SCOPE-OF-WORK.md	Auto	Project overview, reading order, rules, AI usage guide
01	PRD.md	Required	Product vision, target users, MVP features, KPIs
02	TECH-STACK.md	Required	Frontend, backend, database, infrastructure
03	DATABASE-SCHEMA.md	Required	Tables, relations, indexes, enums
04	PROJECT-STRUCTURE.md	Required	Folder structure, apps, packages, scripts
05	API-DESIGN.md	Optional	Endpoints, authentication, error codes
06	USER-STORIES.md	Optional	Personas, user flows, acceptance criteria
07	ROADMAP.md	Optional	Phases, milestones, timeline
08	SITEMAP.md	Optional	Pages, navigation, access control

---

v2.0 — New Features

MCP Server (for AI Tools)

spac-kit includes a built-in MCP server that lets AI tools like Claude Code and Cursor call spac-kit directly.

Setup for Claude Code — add to ~/.claude.json:

{
  "mcpServers": {
    "spac-kit": {
      "command": "npx",
      "args": ["-y", "-p", "@pirsquare.auto/spac-kit", "spac-kit-mcp"]
    }
  }
}

Setup for Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "spac-kit": {
      "command": "npx",
      "args": ["-y", "-p", "@pirsquare.auto/spac-kit", "spac-kit-mcp"]
    }
  }
}

Then just tell the AI what you need:

"Create specs for an e-commerce project called shopee-clone"

Available MCP tools:

Tool	Description
list_presets	List all project type presets
create_project	Create a project with spec templates
read_spec	Read a specific spec file
get_latest_versions	Get latest npm package versions
fill_specs	AI auto-fill spec templates

---

AI Auto-Fill (spac-kit fill)

Let Claude AI fill in your spec templates automatically based on a project description.

# Set your API key
export ANTHROPIC_API_KEY=sk-ant-xxx

# Auto-fill all specs with TODO markers
spac-kit fill --description "Meeting room booking system for offices"

# Specify directory
spac-kit fill --dir ./my-project/spac --description "E-commerce for clothing"

Each spec file gets a specialized AI persona:

• PRD → Product Manager
• Database Schema → Database Architect
• API Design → API Designer
• User Stories → Product Owner

Requires @anthropic-ai/sdk (installed as optional dependency).

---

Programmatic API

Use spac-kit as a library in your own code:

import { createProject, getPresets, readSpecFile } from '@pirsquare.auto/spac-kit';

// Create a project
const result = await createProject('my-app', {
  preset: 'saas',
  optionalSpecs: ['05-API-DESIGN.md', '06-USER-STORIES.md'],
  overwrite: true,
  targetDir: '/path/to/dir',
});

// List presets
const presets = getPresets();

// Read a spec file
const content = await readSpecFile('./my-app/spac', '01-PRD.md');

---

n8n Node

Use spac-kit in n8n workflow automation:

npm install n8n-nodes-spac-kit-pirsquare

Or install via n8n UI: Settings → Community Nodes → Install → n8n-nodes-spac-kit-pirsquare

Operations: Create Project, Get Presets, Get Versions.

---

License

MIT — Pi R Square Co., LTD