[Extension]: Add Full-stack multi-agent specification pipeline with VS Code extension control, automated Kanban/Jira sync, and React monitoring dashboard.

[abir-ommezzine]

Extension ID

agentdocx-speckit

Extension Name

AgentDocx

Version

1.0.0

Description

Full-stack multi-agent specification pipeline with VS Code extension control, automated Kanban/Jira sync, and React monitoring dashboard.

Author

Abir Ommezzine and Ahmed Aziz Ammar

Repository URL

https://github.com/abir-ommezzine/extension-github-spec-kit

Download URL

https://github.com/abir-ommezzine/extension-github-spec-kit/archive/refs/tags/v0.0.3.zip

License

MIT

Homepage (optional)

No response

Documentation URL (optional)

No response

Changelog URL (optional)

No response

Required Spec Kit Version

=0.1.0

Required Tools (optional)

Number of Commands

0

Number of Hooks (optional)

0

Tags

issue-tracking, jira, automation, workflow, pipeline, agents

Key Features

• Automated multi-agent pipeline for generating, enriching, and validating software architecture specifications.
• Transforms raw Markdown documents into structured, versioned, and certified PDF deliverables with generated diagrams.
• Real-time React dashboard for pipeline monitoring, performance KPIs, and document management.
• Automated Kanban task synchronization driven by GitHub Copilot runtime tracking (tasks.md and runtime state).
• Built-in VS Code extension control panel for seamless server, watcher, and frontend management.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on:

• Windows 11 with VS Code & Spec Kit v0.1.0
• Python 3.10+ (FastAPI, LangGraph) & Node.js (React Dashboard)
• Local PostgreSQL database instance

Test project:

• Repository: abir-ommezzine/extension-github-spec-kit
• Tested using a local child project testbed linked via workspace junction (mklink /J) with active Copilot runtime tracking.

Test scenarios:

1. Installed the VS Code extension package (.vsix) successfully and verified output logs (AgentDocx Server & AgentDocx Watcher).
2. Configured the environment (.env with PostgreSQL and LLM provider like Ollama/NVIDIA NIM).
3. Verified the multi-agent specification pipeline: automated parsing, summary, glossary, diagram generation, and final PDF versioning in /outputs/.
4. Tested real-time Kanban task synchronization by tracking GitHub Copilot updates via .task_runtime/current-task.json and specs/tasks.md.

Example Usage

# Install the extension via Spec Kit CLI
specify extension add agentdocx-speckit --from https://github.com/abir-ommezzine/extension-github-spec-kit/archive/refs/tags/v0.0.3.zip

# Alternatively, install the pre-compiled VS Code extension (.vsix) from the GitHub releases page:
# 1. Open your project workspace in VS Code
# 2. Press Ctrl+Shift+P -> Run "Start FastAPI Server" , "Start Spec Watcher" and "Start react frontend"
# 3. Open the React frontend dashboard (http://localhost:5000) or check output logs via View -> Output
# 4. Drop or modify spec files in your specs/ folder to automatically trigger the multi-agent pipeline

Proposed Catalog Entry

{
  "agentdocx-speckit": {
    "name": "AgentDocx",
    "id": "agentdocx-speckit",
    "description": "Multi-agent specification pipeline with VS Code control, live Kanban sync, and React dashboard.",
    "author": "abir-ommezzine", "ahmed200346"
    "version": "1.0.0",
    "download_url": "https://github.com/abir-ommezzine/extension-github-spec-kit/archive/refs/tags/v0.0.3.zip",
    "repository": "https://github.com/abir-ommezzine/extension-github-spec-kit",
    "homepage": "https://github.com/abir-ommezzine/extension-github-spec-kit",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.1.0"
    },
    "provides": {
      "commands": 0
    },
    "tags": [
      "ai",
      "agents",
      "pipeline",
      "specification",
      "kanban",
      "vscode"
    ]
  }
}

Additional Context

https://drive.google.com/file/d/1cVYRDNH-2eazQyqZTIzZMGDY3r3EVKEA/view?usp=drive_link
this is a link to the demo ( it was recorded before adding the ability of launching frontend to the vs extension)

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[github-actions]

❌ Validation Failed

Thank you for submitting the AgentDocx extension! Unfortunately, the submission has the following issues that need to be resolved before it can be added to the community catalog.

---

Failed Checks

1. Version / Download URL mismatch

• Submitted version: 1.0.0
• Download URL tag: v0.0.3 (https://github.com/abir-ommezzine/extension-github-spec-kit/archive/refs/tags/v0.0.3.zip)

The download URL must point to a release tag that matches the submitted version. These two values do not agree.

How to fix: Either:

• Update the Version field to match the tag in the download URL (e.g., change version to 0.0.3 and URL to .../refs/tags/v0.0.3.zip), or
• Create a new GitHub release with tag v1.0.0 and update the download URL to https://github.com/abir-ommezzine/extension-github-spec-kit/archive/refs/tags/v1.0.0.zip

2. No GitHub release matching submitted version 1.0.0

The repository has the following releases:

• v0.0.3 (named "Extension v1.0.3")
• ExtensionAgentDocxV2 (named "Extension v1.0.2")
• ExtensionAgentDocx (named "Extension v1.0.0")

None of these release tags match the submitted version 1.0.0. Release tags should use the format v<version> (e.g., v1.0.0).

How to fix: Create a new GitHub release with tag v1.0.0 (or align your version field with an existing tag such as 0.0.3).

---

Passed Checks

• ✅ Extension ID agentdocx-speckit follows the required format (^[a-z][a-z0-9-]*$)
• ✅ Repository is publicly accessible
• ✅ extension.yml manifest is present
• ✅ README.md is present
• ✅ LICENSE file is present
• ✅ All submission checklist items are checked
• ✅ Version format 1.0.0 follows semver (X.Y.Z)

---

Please edit the issue with corrected values and a maintainer will re-trigger validation. If you have questions, feel free to ask in this issue.

Posted on behalf of @mnriem by GitHub Copilot (model: claude-sonnet-4.6, autonomous)

Generated by 🧩 Add Community Extension from Issue Submission for issue #4171 · 71.6 AIC · ⌖ 10.8 AIC · ⊞ 35.3K · ◷

[mnriem]

@abir-ommezzine Please address feedback