proposal: rename SlashCommandConfigurator to WorkflowConfigurator

Fix semantic mismatch with diverse tool terminology (skills, prompts,
commands). Old names kept as deprecated aliases for compatibility.

Amp-Thread-ID: https://ampcode.com/threads/T-019b6a90-6107-755b-8087-942d9b5460ac

Author: jeanduplessis

openspec/changes/refactor-workflow-configurator-naming/proposal.md

@@ -0,0 +1,26 @@
+## Why
+
+The base class `SlashCommandConfigurator` has a semantic mismatch with the actual tool ecosystem. Different AI tools use different terminology for their integration files:
+- Claude/Cursor/Windsurf: "slash commands" or "workflows"
+- Amp: "skills" (`.agents/skills/`)
+- Codex/GitHub Copilot: "prompts"
+- Gemini: "commands" (TOML format)
+
+The current naming misleadingly implies these configurators only handle slash commands, when they actually configure "OpenSpec workflow operations" (proposal/apply/archive) across diverse tool formats.
+
+## What Changes
+
+- Rename `SlashCommandConfigurator` → `WorkflowConfigurator` in `src/core/configurators/slash/base.ts`
+- Rename `SlashCommandRegistry` → `WorkflowRegistry` in `src/core/configurators/slash/registry.ts`
+- Rename `SlashCommandTarget` → `WorkflowTarget` interface
+- Rename `SlashCommandId` → `WorkflowId` type in templates
+- Rename directory `src/core/configurators/slash/` → `src/core/configurators/workflow/`
+- Export old names as type aliases for backward compatibility
+- Update all configurator subclasses and consumers to use new names
+- Remove explanatory documentation workarounds added during Amp implementation
+
+## Impact
+
+- Affected specs: `cli-init`, `cli-update` (terminology in scenarios)
+- Affected code: All files in `src/core/configurators/slash/`, template exports, init/update command implementations
+- Breaking changes: None if aliases are maintained; internal refactor only

openspec/changes/refactor-workflow-configurator-naming/specs/cli-init/spec.md

@@ -0,0 +1,44 @@
+## MODIFIED Requirements
+
+### Requirement: Slash Command Configuration
+
+The init command SHALL generate workflow configuration files for supported editors using shared templates.
+
+#### Scenario: Generating workflow files for Claude Code
+
+- **WHEN** the user selects Claude Code during initialization
+- **THEN** create `.claude/commands/openspec/proposal.md`, `.claude/commands/openspec/apply.md`, and `.claude/commands/openspec/archive.md`
+- **AND** populate each file from shared templates so command text matches other tools
+- **AND** each template includes instructions for the relevant OpenSpec workflow stage
+
+#### Scenario: Generating workflow files for Amp
+
+- **WHEN** the user selects Amp during initialization
+- **THEN** create `.agents/skills/openspec-proposal/SKILL.md`, `.agents/skills/openspec-apply/SKILL.md`, and `.agents/skills/openspec-archive/SKILL.md`
+- **AND** populate each file with YAML frontmatter containing `name` and `description` fields
+- **AND** wrap the body in OpenSpec markers so `openspec update` can refresh the content
+- **AND** each template includes instructions for the relevant OpenSpec workflow stage
+
+#### Scenario: Generating workflow files for Codex
+
+- **WHEN** the user selects Codex during initialization
+- **THEN** create global prompt files at `~/.codex/prompts/openspec-proposal.md`, `~/.codex/prompts/openspec-apply.md`, and `~/.codex/prompts/openspec-archive.md` (or under `$CODEX_HOME/prompts` if set)
+- **AND** populate each file from shared templates that map the first numbered placeholder (`$1`) to the primary user input (e.g., change identifier or question text)
+- **AND** wrap the generated content in OpenSpec markers so `openspec update` can refresh the prompts without touching surrounding custom notes
+
+#### Scenario: Generating workflow files for GitHub Copilot
+
+- **WHEN** the user selects GitHub Copilot during initialization
+- **THEN** create `.github/prompts/openspec-proposal.prompt.md`, `.github/prompts/openspec-apply.prompt.md`, and `.github/prompts/openspec-archive.prompt.md`
+- **AND** populate each file with YAML frontmatter containing a `description` field that summarizes the workflow stage
+- **AND** include `$ARGUMENTS` placeholder to capture user input
+- **AND** wrap the shared template body with OpenSpec markers so `openspec update` can refresh the content
+- **AND** each template includes instructions for the relevant OpenSpec workflow stage
+
+#### Scenario: Generating workflow files for Gemini CLI
+
+- **WHEN** the user selects Gemini CLI during initialization
+- **THEN** create `.gemini/commands/openspec/proposal.toml`, `.gemini/commands/openspec/apply.toml`, and `.gemini/commands/openspec/archive.toml`
+- **AND** populate each file as TOML that sets a stage-specific `description = "<summary>"` and a multi-line `prompt = """` block with the shared OpenSpec template
+- **AND** wrap the OpenSpec managed markers (`<!-- OPENSPEC:START -->` / `<!-- OPENSPEC:END -->`) inside the `prompt` value so `openspec update` can safely refresh the body between markers without touching the TOML framing
+- **AND** ensure the workflow copy matches the existing proposal/apply/archive templates used by other tools

openspec/changes/refactor-workflow-configurator-naming/tasks.md

@@ -0,0 +1,30 @@
+## 1. Core renaming
+
+- [ ] 1.1 Rename `SlashCommandConfigurator` → `WorkflowConfigurator` in `src/core/configurators/slash/base.ts`
+- [ ] 1.2 Rename `SlashCommandTarget` → `WorkflowTarget` interface in `base.ts`
+- [ ] 1.3 Rename `SlashCommandRegistry` → `WorkflowRegistry` in `registry.ts`
+- [ ] 1.4 Rename `SlashCommandId` → `WorkflowId` in `src/core/templates/slash-command-templates.ts`
+- [ ] 1.5 Rename directory `src/core/configurators/slash/` → `src/core/configurators/workflow/`
+
+## 2. Compatibility aliases
+
+- [ ] 2.1 Export `SlashCommandConfigurator` as alias for `WorkflowConfigurator`
+- [ ] 2.2 Export `SlashCommandTarget` as alias for `WorkflowTarget`
+- [ ] 2.3 Export `SlashCommandRegistry` as alias for `WorkflowRegistry`
+- [ ] 2.4 Export `SlashCommandId` as alias for `WorkflowId`
+- [ ] 2.5 Add deprecation JSDoc comments to all aliases
+
+## 3. Update consumers
+
+- [ ] 3.1 Update all configurator subclasses to extend `WorkflowConfigurator`
+- [ ] 3.2 Update init command to use `WorkflowRegistry`
+- [ ] 3.3 Update update command to use `WorkflowRegistry`
+- [ ] 3.4 Update template exports in `src/core/templates/index.ts`
+- [ ] 3.5 Remove workaround documentation from `amp.ts` explaining the naming mismatch
+
+## 4. Tests and validation
+
+- [ ] 4.1 Update existing unit tests to use new names
+- [ ] 4.2 Verify backward compatibility by testing alias imports
+- [ ] 4.3 Run full test suite to ensure no regressions
+- [ ] 4.4 Run typecheck and lint