set-copilot: Skill for Claude Code

Write Spec — Profile-Driven Specification Generator

Guide the user through writing a detailed project specification. The spec is the most important input to the orchestration pipeline — spec quality directly determines output quality.

Key principles:

• Requirements describe WHAT, not HOW (no code blocks, no file paths)
• Every requirement gets a REQ-ID and at least one WHEN/THEN scenario
• Modular output for projects with 3+ features (main + per-feature files)
• Profile-driven: web projects get data model, seed, auth sections; others get core only

Workflow

Phase 0: Project Context Detection + Profile Loading

Before asking questions, detect the project type and load spec sections:

# Detect project type and tech stack
ls package.json pyproject.toml Cargo.toml go.mod Makefile docker-compose.yml 2>/dev/null
cat package.json 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); print('Name:', d.get('name','')); deps=list(d.get('dependencies',{}).keys()); print('Deps:', ', '.join(deps[:15]))" 2>/dev/null
ls prisma/schema.prisma 2>/dev/null && echo "Prisma detected"
ls docs/*.make docs/design.make docs/design-system.md 2>/dev/null && echo "Design files detected"

Load profile sections:

python3 -c "
from set_orch.profile_loader import resolve_profile
import json
p = resolve_profile('.')
sections = [{'id':s.id,'title':s.title,'description':s.description,'required':s.required,'phase':s.phase,'output_path':s.output_path,'prompt_hint':s.prompt_hint} for s in p.spec_sections()]
print(json.dumps(sections, indent=2))
" 2>/dev/null

If profile loading fails (set-core not installed as package), use these fallback core sections:

• overview (phase 1) — Project name, purpose, tech stack
• requirements (phase 5) — Main features with REQ-IDs and scenarios
• orchestrator_directives (phase 10) — Parallel hints, review gates
• verification_checklist (phase 11) — Auto-generated from requirements

If the tech stack is unfamiliar, use the Agent tool (Explore subagent) to investigate before proceeding.