Add CoreEx Copilot plugin marketplace and onboarding skill#150
Draft
israels wants to merge 2 commits into
Draft
Conversation
Packages CoreEx agent and skills into a copilot plugin, adds marketplace metadata, and introduces the coreex-onboard skill with bundled .github templates plus guidance docs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Removes acquire-codebase-knowledge, aspire, and coreex-docs-sync from the distributed plugin and documents published vs internal-only skills in the plugin README. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR packages CoreEx Copilot assets (agent + skills + onboarding templates) into an installable plugin (plugins/coreex-agent-pack) and adds marketplace metadata (.github/plugin/marketplace.json) so the assets can be distributed and used to bootstrap CoreEx guidance in other repositories.
Changes:
- Added
coreex-agent-packplugin manifest + README, plus marketplace registration metadata. - Bundled the CoreEx Expert agent and multiple skills (including new
coreex-onboardandsolution-scaffolder). - Added onboarding templates under
skills/coreex-onboard/assets/templates/.github/to scaffold.githubguidance files into a target repo.
Reviewed changes
Copilot reviewed 21 out of 21 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| plugins/coreex-agent-pack/plugin.json | Defines plugin metadata, version, and entry points for agents/skills. |
| plugins/coreex-agent-pack/README.md | Documents intent, source-of-truth vs template copies, and future CI sync direction. |
| .github/plugin/marketplace.json | Registers the plugin in a marketplace metadata file. |
| plugins/coreex-agent-pack/agents/coreex-expert.agent.md | Adds the “CoreEx Expert” agent definition and operating guidance. |
| plugins/coreex-agent-pack/skills/coreex-onboard/SKILL.md | Adds onboarding skill documentation and behavior expectations (safe vs force). |
| plugins/coreex-agent-pack/skills/coreex-onboard/references/workflow.md | Defines the onboarding workflow phases and file-operation rules. |
| plugins/coreex-agent-pack/skills/coreex-onboard/references/checklists.md | Provides readiness/completion/safety checklists for onboarding. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/copilot-instructions.md | Template for repo-level Copilot instructions to be scaffolded into .github/. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/agents/coreex-expert.agent.md | Template for the CoreEx Expert agent to scaffold into .github/agents/. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-conventions.instructions.md | Template coding conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-contracts.instructions.md | Template contracts (DTO) conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-domain.instructions.md | Template domain-layer conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-application-services.instructions.md | Template application-service conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-validators.instructions.md | Template validator conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-repositories.instructions.md | Template repository/infrastructure conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-api-controllers.instructions.md | Template API controller conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-host-setup.instructions.md | Template Program.cs/host setup conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-event-subscribers.instructions.md | Template event subscriber conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-tests.instructions.md | Template testing conventions instruction file. |
| plugins/coreex-agent-pack/skills/coreex-onboard/assets/templates/.github/instructions/coreex-tooling.instructions.md | Template tooling/CodeGen/Database conventions instruction file. |
| plugins/coreex-agent-pack/skills/solution-scaffolder/SKILL.md | Adds solution shaping skill for post-onboarding scaffold/retrofit decisions. |
| plugins/coreex-agent-pack/skills/coreex-docs-sync/SKILL.md | Adds skill to sync/cache CoreEx docs and per-package agent guides locally. |
| plugins/coreex-agent-pack/skills/aspire/SKILL.md | Adds skill guidance for Aspire orchestration workflows. |
| plugins/coreex-agent-pack/skills/acquire-codebase-knowledge/SKILL.md | Adds skill for generating codebase documentation/onboarding artifacts. |
| 6. **Validate the scaffold.** Wire projects into the solution, then choose between shape validation and fully runnable local validation. | ||
| 7. **Summarize the result.** Show the derived inputs, commands, validations, and any deferred steps. | ||
|
|
||
| For step-by-step guidance, see [references/workflow.md](references/workflow.md). |
| ## When Not to Use | ||
|
|
||
| - You are debugging local runtime, container, Aspire, or package restore issues unrelated to project shaping. | ||
| - You still need to create the initial bootstrap repository; run `coreex-bootstrap` before this skill is used. |
| ## Prerequisite | ||
|
|
||
| Assume the repository is already in one of these states before this skill runs: | ||
| - a bootstrap-only shell created earlier by `coreex-bootstrap`; or |
| // Correct — no braces needed | ||
| if (product == null) return null; | ||
|
|
||
| // Correct — no braces needed - prefer muli-line bodies even when they fit on one line |
| 1. Check for the file under `.github/docs/coreex/` or `.github/docs/coreex/agents/` respectively. | ||
| 2. If found, use the local copy. Then read `.github/docs/coreex/.manifest` and check: | ||
| - `synced` date: if older than 30 days, recommend running `/coreex-docs-sync`. | ||
| - `4.0.0-preview-1`: scan `*.csproj`, `Directory.Packages.props`, and `Directory.Build.props` for the `CoreEx` package version; if it differs from the manifest, recommend running `/coreex-docs-sync`. |
| 1. Check for the file under `.github/docs/coreex/` or `.github/docs/coreex/agents/` respectively. | ||
| 2. If found, use the local copy. Then read `.github/docs/coreex/.manifest` and check: | ||
| - `synced` date: if older than 30 days, recommend running `/coreex-docs-sync`. | ||
| - `4.0.0-preview-1`: scan `*.csproj`, `Directory.Packages.props`, and `Directory.Build.props` for the `CoreEx` package version; if it differs from the manifest, recommend running `/coreex-docs-sync`. |
|
|
||
| | Folder | Contents | | ||
| |---|---| | ||
| | `.github/docs/coreex/` | 10 sample architecture docs (layers, patterns, each layer walkthrough, testing, tooling, Aspire) | |
|
|
||
| | Folder | Contents | | ||
| |---|---| | ||
| | `.github/docs/coreex/` | 10 sample architecture docs (layers, patterns, each layer walkthrough, testing, tooling, Aspire) | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
CoreEx AI assets were only available when copied manually into a repository. This change packages them as an installable Copilot plugin so an empty repo can bootstrap CoreEx guidance quickly and consistently.
What changed
plugins/coreex-agent-packwith manifest metadata..github/plugin/marketplace.jsonso the plugin can be distributed through a Copilot plugin marketplace.coreex-onboardskill that scaffolds CoreEx.githubguidance files into a target repository in safe mode by default..github/copilot-instructions.md.github/instructions/*.instructions.md.github/agents/coreex-expert.agent.mdNon-obvious details and tradeoffs
The onboarding templates are intentionally packaged inside the plugin so new repos can be bootstrapped after plugin install, but this introduces duplication with canonical root
.githubfiles. The README calls out the long-term plan: keep root.githubas source of truth and add CI sync to regenerate plugin templates and detect drift.Validation
plugin.json,marketplace.json).