fix(templates): tighten constitution sync scope

Propagate dollar-style invocation prefixes when installing into projects without a default integration, and restrict constitution synchronization to Spec Kit-managed templates and commands.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 02f9e138-da58-4a60-93b9-eae659d2aa19

Author: BenBtg

src/specify_cli/integrations/_install_commands.py

@@ -6,6 +6,7 @@
 import typer
 
 from .._console import console
+from .._invocation_style import is_dollar_skills_agent
 from .._utils import _display_project_path
 from ..integration_runtime import (
     invoke_separator_for_integration as _invoke_separator_for_integration,
@@ -130,6 +131,14 @@ def integration_install(
             infra_integration, current, infra_key, infra_parsed,
             project_root=project_root,
         ),
+        invoke_prefix=(
+            "$"
+            if is_dollar_skills_agent(
+                infra_key,
+                infra_integration.is_skills_mode(infra_parsed, project_root),
+            )
+            else "/"
+        ),
     )
     if os.name != "nt":
         from .. import ensure_executable_scripts

templates/commands/constitution.md

@@ -20,8 +20,8 @@ This command updates project governance only. It may modify:
 
 - `.specify/memory/constitution.md`
 - dependent templates under `.specify/templates/`
-- installed Spec Kit command files and runtime guidance documents when required to keep
-  them consistent with the amended constitution
+- installed Spec Kit command files when required to keep them consistent with the
+  amended constitution
 
 It **MUST NOT** create or modify application source code, feature specifications, plans,
 tasks, tests, or other implementation artifacts.
@@ -105,7 +105,6 @@ Follow this execution flow:
    - Read `.specify/templates/spec-template.md` for scope/requirements alignment—update if constitution adds/removes mandatory sections or constraints.
    - Read `.specify/templates/tasks-template.md` and ensure task categorization reflects new or removed principle-driven task types (e.g., observability, versioning, testing discipline).
    - Read each installed Spec Kit command file for your agent (including this one) — named `speckit.*` or `speckit-*` (dot or hyphen depending on the agent), or laid out as `speckit-<name>/SKILL.md` for skills-based integrations, e.g. in `.github/agents/`, `.github/skills/`, `.claude/skills/`, or your agent's equivalent commands directory — to verify no outdated references (CLAUDE-only or other agent-specific names) remain when generic guidance is required.
-   - Read any runtime guidance docs (e.g., `README.md`, `docs/quickstart.md`, or agent-specific guidance files if present). Update references to principles changed.
 
 5. Produce a Sync Impact Report (prepend as an HTML comment at top of the constitution file after update):
    - Version change: old → new

tests/integrations/test_integration_generic.py

@@ -215,6 +215,8 @@ def test_constitution_command_rejects_implementation_scope(self, tmp_path):
         assert "## Scope Guard" in content
         assert "MUST NOT" in content
         assert "application source code" in content
+        assert "runtime guidance documents" not in content
+        assert "README.md" not in content
         assert "Do not execute it during this command." in content
         assert "Never invoke a suggested follow-up command automatically." in content
         assert "/speckit.specify <intent>" in content

tests/integrations/test_integration_subcommand.py

@@ -1256,6 +1256,24 @@ def test_install_bare_project_gets_shared_infra(self, tmp_path):
         assert "/speckit-specify" in script_content
         assert "/speckit.specify" not in script_content
 
+    def test_install_dollar_skill_into_bare_project_gets_native_shared_refs(
+        self, tmp_path
+    ):
+        """A dollar-style integration supplies its prefix without a default."""
+        project = tmp_path / "bare-codex"
+        project.mkdir()
+        (project / ".specify").mkdir()
+
+        result = _run_in_project(
+            project, ["integration", "install", "codex", "--script", "sh"]
+        )
+
+        assert result.exit_code == 0, result.output
+        plan = project / ".specify" / "templates" / "plan-template.md"
+        plan_content = plan.read_text(encoding="utf-8")
+        assert "$speckit-plan" in plan_content
+        assert "/speckit-plan" not in plan_content
+
     def test_install_defers_extension_commands_until_use(self, tmp_path):
         """Installing a second integration does not register enabled extensions.