A CLI that scaffolds spec-driven development workflows for AI coding agents. Supports Go, Rust, and Zig ecosystems with FRD-based or journey-based workflows.

promptkit generates AGENTS.md, instruction skills, Makefile, linter config, and helper scripts from templates — customized for your project, ecosystem, and the AI agents you use.

Prerequisites

• Go 1.22+ (to build from source)

Install

go install github.com/Sumatoshi-tech/prompts/cmd/promptkit@latest

Or build from source:

git clone https://github.com/Sumatoshi-tech/prompts.git
cd prompts
make install

Quick Start

# Interactive — prompts for ecosystem, workflow, module path, agents, etc.
promptkit init my-project

# Non-interactive Go project
promptkit init my-project \
  --non-interactive \
  --name "myapp" \
  --module "github.com/user/myapp" \
  --ai claude,cursor

# Rust project with journey workflow
promptkit init my-project \
  --non-interactive \
  --ecosystem rust \
  --workflow journey \
  --name "myapp" \
  --module "github.com/user/myapp" \
  --ai claude

This generates:

my-project/
  .promptkit.yaml          # Config — edit this, then run promptkit update
  AGENTS.md                # Agent personality and development workflow
  .golangci.yml            # Linter config (ecosystem-specific)
  Makefile                 # Build, test, lint targets
  .agents/instructions/   # Instruction sources + workflow templates (FRD or journey outline)
  .agents/skills/          # Agent Skills (cross-agent standard)
    implement/SKILL.md     # /implement — TDD + copy/fill FRD or journey template
    roadmap/SKILL.md       # /roadmap — Spec decomposition
    perf/SKILL.md          # /perf — Performance diagnosis

From there, one config file drives everything:

vim .promptkit.yaml    # Change thresholds, add agents, switch workflow
promptkit update       # Review diff, approve — done

Ecosystems

Ecosystem	Linter	Build System	Analysis Command
golang	golangci-lint v2	Makefile	go vet ./...
rust	Clippy + rustfmt	Makefile (cargo)	cargo clippy -- -D warnings
zig	—	Makefile (zig build)	zig build test

Set with --ecosystem at init time or ecosystem: in config.

Workflows

Two development methodologies are available:

• frd (default) — spec -> /roadmap -> /implement -> /perf. Each roadmap item: /implement fills specs/frds/FRD-{id}.md using .agents/instructions/instr-frd.md as the section outline (MoSCoW, stressors, test matrix).
• journey — same skills; each item uses .agents/instructions/instr-journey.md to author specs/journeys/JOURNEY-{id}.md (CJM, friction, UX assessment).

Set with --workflow at init time or workflow: in config. See Workflows for details.

Multi-Agent Support

Skills in .agents/skills/ work natively with Claude Code, Codex CLI, GitHub Copilot, and Cursor. For other agents, promptkit generates adapter files:

Agent	Generated Files
Claude Code	.agents/skills/ + .claude/commands/
Codex CLI	.agents/skills/ (reads AGENTS.md natively)
GitHub Copilot	.agents/skills/ + .github/copilot-instructions.md
Cursor	.agents/skills/ + .cursor/rules/agents.mdc
Gemini CLI	GEMINI.md + .gemini/commands/
Windsurf	.windsurfrules + .windsurf/workflows/

All agents receive identical instructions — same workflow, same quality gates, same TDD process.

promptkit init --ai claude,gemini,cursor .

Commands

Command	Description
promptkit init [dir]	Scaffold a new project (interactive or --non-interactive)
promptkit update	Re-render templates after config changes, with diff review
promptkit diff	Preview what update would change
promptkit status	Check if generated files are up to date (CI-friendly, exits 1 on drift)
promptkit doctor	Validate generated files for correctness
promptkit clean	Remove stale generated files
promptkit template list|render|extract|add|vars	Manage template overrides
promptkit config explain [key]	Show which files a config field affects

See Commands Reference for full flag documentation.

Configuration

All values live in .promptkit.yaml. Key fields:

version: 2
project_name: myapp
module_path: github.com/user/myapp
ecosystem: golang          # golang, rust, zig
workflow: frd              # frd, journey
agents: [claude, cursor]
quality:
  coverage_min: 85
  coverage_critical: 90

See Configuration Reference for all fields, validation rules, and migration.

Documentation

Document	Contents
Commands Reference	All commands, flags, and examples
Configuration Reference	Config fields, validation, migration
Workflows	FRD and journey workflow details
Templates	Template overrides, variables, skills reference
Architecture	Project structure, safety model, internals

License

Licensed under the Apache License 2.0.