Skip to content

docs: add Copilot CLI native integration research#161

Open
abeltrano wants to merge 3 commits intomainfrom
abeltrano/copilot-cli-integration-research
Open

docs: add Copilot CLI native integration research#161
abeltrano wants to merge 3 commits intomainfrom
abeltrano/copilot-cli-integration-research

Conversation

@abeltrano
Copy link
Copy Markdown
Collaborator

Summary

Adds a comprehensive research document evaluating how to integrate PromptKit natively into GitHub Copilot CLI, and updates the roadmap to reflect this new integration path.

Closes #160

Changes

New: docs/copilot-cli-integration-research.md

Research document covering seven Copilot CLI extension points for PromptKit integration:

Strategy Mechanism Key Benefit
A Skills /promptkit invocation, auto-detection
B Custom Agents Isolated context, infer: true auto-delegation
C MCP Server Deterministic assembly, cross-client
D Plugins One-command install, bundles everything
E Custom Instructions Zero-infrastructure lightweight option
F Hooks Output validation, guardrails, telemetry
G LSP Configs Enhanced code intelligence for analysis templates

Recommends a plugin-first approach bundling a skill (invocation), MCP server (deterministic assembly), agents (interactive templates), hooks (guardrails), and LSP configs (code intelligence).

Updated: docs/roadmap.md

Added "Copilot CLI Native Integration" as a new roadmap item alongside the existing Copilot Extension item. The two are presented as complementary — CLI integration targets terminal workflows, while the Copilot Extension targets Copilot Chat across web/IDE/CLI surfaces.

Add comprehensive research document evaluating seven GitHub Copilot CLI
extension points (skills, custom agents, MCP server, plugins, hooks,
LSP configs, custom instructions) for native PromptKit integration.

Update roadmap to add Copilot CLI Native Integration as a complementary
path alongside the existing Copilot Extension item.

Closes #160

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 1, 2026 17:46
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation exploring native integration options for PromptKit inside GitHub Copilot CLI, and updates the project roadmap to track this new integration path.

Changes:

  • Added a comprehensive research doc enumerating Copilot CLI extension points and integration strategies.
  • Updated the roadmap with a new “Copilot CLI Native Integration” initiative and example usage.
  • Documented a recommended “plugin-first” approach combining skills + MCP + agents + hooks + LSP configs.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
docs/roadmap.md Adds a new roadmap item describing the Copilot CLI native integration direction and linking to the research doc.
docs/copilot-cli-integration-research.md New long-form research document detailing possible integration mechanisms and a recommended architecture.

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md
Comment thread docs/copilot-cli-integration-research.md
- Fix link text to match href (remove misleading docs/ prefix)
- Change fenced code block from bare prompt to labeled sh block

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Member

@Alan-Jowett Alan-Jowett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice research — the comparison matrix and the plugin-first recommendation are solid. A few questions / suggestions inline.

Comment thread docs/copilot-cli-integration-research.md Outdated
Comment thread docs/copilot-cli-integration-research.md Outdated
Comment thread docs/copilot-cli-integration-research.md
Comment thread docs/copilot-cli-integration-research.md Outdated
Comment thread docs/copilot-cli-integration-research.md Outdated
Comment thread docs/copilot-cli-integration-research.md Outdated
Comment thread docs/copilot-cli-integration-research.md
Comment thread docs/copilot-cli-integration-research.md Outdated
…edback

- Add 'Implementation status (May 2026 update)' callout listing shipped strategies (Skills, Custom Agents partial, Custom Instructions) and remaining (MCP, Plugin, Hooks, LSP).

- Bump per-template agents from P2 to P1 in Core Plugin Components, with sonde case study justification.

- Make MCP mandatory: drop the 'fallback to direct file read' branch from the architecture diagram and Open Questions.

- Add 'Key UX Gap to Prototype' subsection enumerating three candidate 'adopt assembled prompt as working instructions' mechanisms and recommending temp-file + read as the first prototype.

- Promote promptkit_get_interactive_context from Open Questions to a Design Recommendation.

Addresses review feedback from @Alan-Jowett on PR #161.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 7, 2026 03:14
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

Comment thread docs/roadmap.md
within terminal-based workflows.

```sh
/promptkit investigate this bug — segfault in packet_handler.c
Comment on lines +743 to +749
> [sonde case study](./case-studies/sonde-protocol-evolution.md) shows that
> pre-composed coder/reviewer/validator workflows — personas and protocols
> baked in — are where PromptKit delivers the most value in practice. A
> `promptkit-investigator.agent.md` that hard-wires `systems-engineer` +
> `root-cause-analysis` + `memory-safety-c` is immediately useful with
> **no manifest lookup and no assembly round-trip**, which is where most
> of the per-invocation latency and friction live today.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Research: Copilot CLI native integration strategies

3 participants