feat: Add Alquimia AI integration by exengstfeld · Pull Request #2734 · github/spec-kit

exengstfeld · 2026-05-28T15:07:54Z

Description

Add Alquimia AI integration https://www.alquimia.ai/

Testing

[ x ] Tested locally with uv run specify --help
[ x ] Ran existing tests with uv sync && uv run pytest
[ x ] Tested with a sample project (if applicable)

AI Disclosure

[ x ] I did not use AI assistance for this contribution
[ ] I did use AI assistance (describe below)

…ow.yml

Copilot

Pull request overview

Adds a new built-in Alquimia AI integration to Spec Kit, enabling projects to install and use Alquimia’s skills-based command layout alongside existing integrations.

Changes:

Introduces AlquimiaAIIntegration (skills layout, context file, skill post-processing for Alquimia-specific frontmatter and argument hints).
Registers the new integration and adds it to the built-in integration catalog.
Adds a comprehensive integration test suite and updates the speckit workflow compatibility hints to include alquimia.

Show a summary per file

File	Description
workflows/speckit/workflow.yml	Adds `alquimia` to the workflow’s advisory integration compatibility list.
tests/integrations/test_integration_alquimia.py	New test suite covering registration, setup outputs, context-file behavior (incl. BOM), and skill post-processing behavior.
src/specify_cli/integrations/alquimia_ai/init.py	Implements the Alquimia skills integration and skill file post-processing logic.
src/specify_cli/integrations/init.py	Imports and registers the new built-in integration.
integrations/catalog.json	Adds the new integration entry to the built-in catalog.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Files reviewed: 5/5 changed files
Comments generated: 4

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 5/5 changed files
Comments generated: 2

mnriem

Please address Copilot feedback. If not applicable, please explain why

exengstfeld · 2026-06-04T02:57:54Z

Please address Copilot feedback. If not applicable, please explain why

PR ready for review :)

Copilot

Copilot's findings

Files reviewed: 5/5 changed files
Comments generated: 2

mnriem · 2026-06-04T14:55:35Z

Please address Copilot feedback

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 5/5 changed files
Comments generated: 4

mnriem · 2026-06-17T13:31:56Z

Please address Copilot feedback and resolve conflicts and pull in upstream/main

Copilot

Copilot's findings

Files reviewed: 5/5 changed files
Comments generated: 1

    # -- Imports (alphabetical) -------------------------------------------
    from .agy import AgyIntegration
+    from .alquimia_ai import AlquimiaAIIntegration
    from .amp import AmpIntegration


mnriem · 2026-06-23T12:48:30Z

Please address Copilot feedback

Copilot

Copilot's findings

Files reviewed: 5/5 changed files
Comments generated: 3

mnriem · 2026-06-24T18:48:03Z

Please address Copilot feedback

Copilot

Review details

Files reviewed: 5/5 changed files
Comments generated: 2
Review effort level: Low

mnriem · 2026-06-26T17:15:07Z

Please address Copilot feedback and test & lint errors

Copilot

Review details

Files reviewed: 5/5 changed files
Comments generated: 4
Review effort level: Low

+from pathlib import Path
+from typing import Any
+
+import yaml


+    def _render_skill(
+        self, template_name: str, frontmatter: dict[str, Any], body: str
+    ) -> str:
+        """Render a processed command template as an Alquimia skill."""
+        skill_name = f"speckit-{template_name.replace('.', '-')}"
+        description = frontmatter.get(
+            "description",
+            f"Spec-kit workflow command: {template_name}",
+        )
+        skill_frontmatter = self._build_skill_fm(
+            skill_name, description, f"templates/commands/{template_name}.md"
+        )
+        frontmatter_text = yaml.safe_dump(skill_frontmatter, sort_keys=False).strip()
+        return f"---\n{frontmatter_text}\n---\n\n{body.strip()}\n"
+
+    def _build_skill_fm(self, name: str, description: str, source: str) -> dict:
+        from specify_cli.agents import CommandRegistrar
+
+        return CommandRegistrar.build_skill_frontmatter(
+            self.key, name, description, source
+        )
+


+      "version": "1.0.0",
+      "description": "Alquimia AI CLI integration",
+      "author": "spec-kit-core",
+      "repository": "https://github.com/github/spec-kit",
+      "tags": ["alquimia"]


+        assert b"<!-- SPECKIT" not in remaining
+        assert b"# ALQUIMIA.md" in remaining
+
+    def test_ai_flag_auto_promotes_and_enables_skills(self, tmp_path):


mnriem · 2026-06-30T11:56:10Z

Please address Copilot feedback. If not applicable please explain why. And please resolve test & lint errors

Eric Engstfeld added 4 commits May 27, 2026 16:03

Add alquimia-ai as new integration: https://alquimia.ai

767b301

Fix test cases for alquimia-ai integration. Add alquimia-ai to workfl…

ebaf5c7

…ow.yml

Add install url to alquimia-ai integration

49c4a88

Renamed alquimia-ai to alquimia (cli native denomination)

f3d60f0

exengstfeld requested a review from mnriem as a code owner May 28, 2026 15:07

mnriem requested a review from Copilot May 28, 2026 16:14

Copilot started reviewing on behalf of mnriem May 28, 2026 16:14 View session

Copilot AI reviewed May 28, 2026

View reviewed changes

Comment thread src/specify_cli/integrations/__init__.py

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py Outdated

Comment thread tests/integrations/test_integration_alquimia.py

Comment thread integrations/catalog.json Outdated

This was referenced May 28, 2026

[aw] Add Community Preset from Issue Submission failed #2751

Closed

[aw] Add Community Extension from Issue Submission failed #2752

Closed

exengstfeld and others added 4 commits May 28, 2026 19:47

Fix alquimia integration catalog updated_at date

f670ec2

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Fix alquima ai registration order

a9ba17b

Fix unit tests for alquimia integration

f9f2c80

Minor fix in alquimia integration

6a62fe1

mnriem requested a review from Copilot May 30, 2026 12:16

Copilot started reviewing on behalf of mnriem May 30, 2026 12:16 View session

Copilot AI reviewed May 30, 2026

View reviewed changes

Comment thread tests/integrations/test_integration_alquimia.py Outdated

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py Outdated

mnriem requested changes Jun 1, 2026

View reviewed changes

exengstfeld force-pushed the main branch from 492a111 to 6a62fe1 Compare June 4, 2026 02:49

Eric Engstfeld and others added 2 commits June 3, 2026 23:52

Fix typos and copilot findings

be08912

Merge branch 'main' into alquimia-integration-merge-conflicts-resolution

890fecc

mnriem requested a review from Copilot June 4, 2026 12:46

Copilot started reviewing on behalf of mnriem June 4, 2026 12:46 View session

Copilot AI reviewed Jun 4, 2026

View reviewed changes

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py Outdated

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py

exengstfeld and others added 2 commits June 10, 2026 16:24

Potential fix for pull request finding

6aa954b

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Merge branch 'main' into alquimia-integration-merge-conflicts-resolution

27edc1f

mnriem requested a review from Copilot June 10, 2026 21:07

Copilot started reviewing on behalf of mnriem June 10, 2026 21:07 View session

mnriem requested a review from Copilot June 17, 2026 12:38

Copilot started reviewing on behalf of mnriem June 17, 2026 12:38 View session

Copilot AI reviewed Jun 17, 2026

View reviewed changes

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py Outdated

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py Outdated

Comment thread src/specify_cli/integrations/alquimia_ai/__init__.py

Comment thread integrations/catalog.json Outdated

jawwad-ali mentioned this pull request Jun 21, 2026

feat: add Firebender integration (Android Studio / IntelliJ) #3077

Merged

5 tasks

Eric Engstfeld added 3 commits June 22, 2026 20:42

Update tests cases and lint formatting

316a416

Final fixes

fa9cb39

Update catalog updated timestamp

b5132ec

mnriem requested a review from Copilot June 23, 2026 12:01

Copilot started reviewing on behalf of mnriem June 23, 2026 12:02 View session

Copilot AI reviewed Jun 23, 2026

View reviewed changes

Comment thread src/specify_cli/integrations/__init__.py

Comment on lines 49 to 52

# -- Imports (alphabetical) -------------------------------------------

from .agy import AgyIntegration

from .alquimia_ai import AlquimiaAIIntegration

from .amp import AmpIntegration

Eric Engstfeld added 2 commits June 23, 2026 23:54

Rename alquimia_ai to alquimia module integration

82b70a6

Update catalog integrations timestamp

885ec32

mnriem requested a review from Copilot June 24, 2026 16:07

Copilot started reviewing on behalf of mnriem June 24, 2026 16:08 View session

Copilot AI reviewed Jun 24, 2026

View reviewed changes

Comment thread src/specify_cli/integrations/alquimia/__init__.py Outdated

Comment thread integrations/catalog.json Outdated

Comment thread integrations/catalog.json Outdated

Eric Engstfeld added 3 commits June 25, 2026 17:57

Make cli optional for alquimiia integration

3fccbc0

resolve review comments

0d97234

Fix conflicts

b5e4c8d

mnriem requested a review from Copilot June 26, 2026 14:22

Copilot started reviewing on behalf of mnriem June 26, 2026 14:22 View session

Copilot AI reviewed Jun 26, 2026

View reviewed changes

Comment thread workflows/speckit/workflow.yml Outdated

Comment thread integrations/catalog.json Outdated

Fix copilot review

b9cc97c

mnriem requested a review from Copilot June 30, 2026 11:22

Copilot started reviewing on behalf of mnriem June 30, 2026 11:22 View session

Copilot AI reviewed Jun 30, 2026

View reviewed changes

Uh oh!

Conversation

exengstfeld commented May 28, 2026

Description

Testing

AI Disclosure

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

mnriem left a comment

Choose a reason for hiding this comment

Uh oh!

exengstfeld commented Jun 4, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

mnriem commented Jun 4, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnriem commented Jun 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

mnriem commented Jun 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnriem commented Jun 24, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Review details

Uh oh!

Uh oh!

Uh oh!

mnriem commented Jun 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Review details

Uh oh!

mnriem commented Jun 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

mnriem commented Jun 26, 2026 •

edited

Loading