fix: implement preset 'replaces' field to remove superseded commands (v0.1.3)

Preset commands with 'replaces' field now properly remove the replaced
command files from all agent directories before writing new commands.

- Add remove_replaced_commands() method to CommandRegistrar
- Update _register_commands() in presets.py to process replaces field
- Add missing replaces: speckit.constitution to preset.yml

This ensures clean command namespace with only adlc.spec.* commands
and spec.* aliases, removing the confusing speckit.* duplicates.

Author: kanfil

CHANGELOG.md

@@ -7,6 +7,19 @@ All notable changes to the Specify CLI and templates are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to to [Semantic Versioning](https://semver.org/spec/v2.0.0/).
 
+## [0.1.3] - 2026-03-15
+
+### Fixed
+
+- **Preset `replaces` field now implemented**: Commands with `replaces` in preset.yml now properly remove the replaced command files from agent directories
+  - Example: `adlc.spec.specify` with `replaces: "speckit.specify"` now removes `speckit.specify.md` before creating the new command
+  - Ensures clean command namespace with only `adlc.spec.*` commands and `spec.*` aliases
+- **`adlc.spec.constitution`**: Added missing `replaces: "speckit.constitution"` to replace core command
+
+### Added
+
+- **`remove_replaced_commands()`**: New method in `CommandRegistrar` class (`agents.py`) to remove command files across all detected agent directories
+
 ## [0.1.1] - 2026-03-14
 
 ### Added

presets/agentic-sdlc/preset.yml

@@ -109,8 +109,9 @@ provides:
     - type: "command"
       name: "adlc.spec.constitution"
       file: "commands/adlc.spec.constitution.md"
-      description: "Create/update project constitution (fork only)"
+      description: "Create/update project constitution (fork enhanced)"
       aliases: ["spec.constitution"]
+      replaces: "speckit.constitution"
 
 tags:
   - "governance"

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentic-sdlc-specify-cli"
-version = "0.1.1"
+version = "0.1.3"
 description = "Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
 requires-python = ">=3.11"
 dependencies = [

src/specify_cli/agents.py

@@ -425,3 +425,50 @@ def unregister_commands(
                     )
                     if prompt_file.exists():
                         prompt_file.unlink()
+
+    def remove_replaced_commands(
+        self, replaced_commands: List[str], project_root: Path
+    ) -> Dict[str, List[str]]:
+        """Remove command files that are being replaced by a preset.
+
+        Scans all detected agent directories and removes command files
+        matching the names in replaced_commands.
+
+        Args:
+            replaced_commands: List of command names to remove (e.g. ["speckit.specify"])
+            project_root: Path to project root
+
+        Returns:
+            Dictionary mapping agent names to lists of removed command names
+        """
+        removed = {}
+
+        for agent_name, agent_config in self.AGENT_CONFIGS.items():
+            agent_dir = project_root / agent_config["dir"].split("/")[0]
+
+            if not agent_dir.exists():
+                continue
+
+            commands_dir = project_root / agent_config["dir"]
+            if not commands_dir.exists():
+                continue
+
+            removed_for_agent = []
+            for cmd_name in replaced_commands:
+                cmd_file = commands_dir / f"{cmd_name}{agent_config['extension']}"
+                if cmd_file.exists():
+                    cmd_file.unlink()
+                    removed_for_agent.append(cmd_name)
+
+                # Also remove Copilot prompt files
+                if agent_name == "copilot":
+                    prompt_file = (
+                        project_root / ".github" / "prompts" / f"{cmd_name}.prompt.md"
+                    )
+                    if prompt_file.exists():
+                        prompt_file.unlink()
+
+            if removed_for_agent:
+                removed[agent_name] = removed_for_agent
+
+        return removed