Skip to content

@W-22578499 : Update Template Skill #113

Open
shivam-sf wants to merge 15 commits into
mulesoft:masterfrom
shivam-sf:W-22578493/update-create-project-skill
Open

@W-22578499 : Update Template Skill #113
shivam-sf wants to merge 15 commits into
mulesoft:masterfrom
shivam-sf:W-22578493/update-create-project-skill

Conversation

@shivam-sf

@shivam-sf shivam-sf commented May 29, 2026

Copy link
Copy Markdown
Contributor

Summary

Folds the standalone create-project-template skill into build-mule-integration as a conditional sub-skill loaded via references/template-project-creation.md. Template-based project creation (Exchange template, local .jar) is now a branch within build-mule-integration at Step 1b instead of a separate top-level skill.

Why

  • Single skill entry point — agents no longer have to choose between create-project-template and build-mule-integration.
  • The sub-skill prose (~480 lines) only enters context when the user actually wants a template; existing-project work doesn't pay for it.
  • Step 1b is built into the workflow, so the agent always asks for new projects (skipped for "modify existing flow" requests).

Changes

build-mule-integration/

  • SKILL.md — added Step 1b (Project Source Decision) between Steps 1 and 2; added scripts/search_templates.sh to the bundled-scripts table; added --skip-environment to the Step 8 dx mule project create example for scratch projects.
  • references/template-project-creation.md (new) — sub-skill with the full Exchange (E1–E4) and Local (L1–L4) flows, decision matrix, flow-switching rules, dx:mule:project:create schema, search_templates.sh reference, success-report format, error-handling guide.
  • scripts/search_templates.sh (moved from create-project-template/scripts/) — Exchange template search (parallel public + private, dedup, rank, top-10 enrichment).

create-project-template/

  • Deleted. Workflow now lives in build-mule-integration/references/template-project-creation.md.

Versioning

  • SKILL.md metadata version: 1.1.01.2.1.
  • package.json / package-lock.json: bumped to 1.2.1.
  • CHANGELOG.md: new [1.2.1] entry above master's [1.1.1].

Verification

  • Directory structure: template-project-creation.md and search_templates.sh present under build-mule-integration/; create-project-template/ removed.
  • npm pack --dry-run from skills/mule-development/ includes both new files; no create-project-template/ paths.
  • grep -r "create-project-template" skills/mule-development/ returns zero matches.
  • Merge conflict against master's [1.1.1] resolved cleanly; both changelog entries preserved.

shivam-sf added 4 commits May 27, 2026 15:42
…ll (#1)

After successful project creation, always run `code --add <projectPath>`
to add the project to the current VS Code workspace. Failures are
silently ignored so the workflow continues regardless.
…create CLI (#3)

Replace all references to the `create_mule_project` MCP tool with the
Anypoint CLI command `dx:mule:project:create`. The skill now instructs
the agent to run CLI commands directly via Bash instead of calling an
MCP server tool.

- Update frontmatter description and compatibility
- Replace all `create_mule_project` references with `dx:mule:project:create`
- Remove `mule-mcp-server` dependency
- Add concrete CLI invocation examples for Exchange, Local, and Scratch flows
- Update schema reference with actual CLI flags and usage patterns
…late skill (#4)

Before calling dx:mule:project:create, the agent must resolve the latest
runtime version and compatible JDK by running dx:mule:runtime:list. This
ensures projects are created with the current supported runtime instead
of a hardcoded default.
@shivam-sf shivam-sf marked this pull request as ready for review June 2, 2026 09:48
@shivam-sf shivam-sf marked this pull request as draft June 2, 2026 09:48
shivam-sf added 6 commits June 3, 2026 17:42
Add Step 1b to build-mule-integration that asks the project source
question (Exchange/Local/Scratch) when creating a new project. If user
picks a template, the agent reads references/template-project-creation.md
which contains the full Exchange (E1-E4) and Local (L1-L4) template
flows. Scratch projects continue to Step 8 as before.

- Create references/template-project-creation.md with full template
  workflow (Exchange + Local flows, confirmation gates, validation)
- Copy search_templates.sh to build-mule-integration/scripts/
- Add Step 1b decision gate to SKILL.md
- Add search_templates.sh to bundled scripts table
- Bump version to 1.2.0
Scratch projects don't need environment resolution, so pass
--skip-environment to avoid an unnecessary API call.
Its workflow now lives in build-mule-integration/references/template-project-creation.md
as a conditional sub-file. Bumps package version to 1.1.0.
@shivam-sf shivam-sf changed the title @W-22578493 : Update Template Skill @W-22578499 : Update Template Skill Jun 4, 2026
shivam-sf added 2 commits June 4, 2026 17:14
Master added PDK skills as 1.1.0. Our template removal is now 1.2.0.
@shivam-sf shivam-sf marked this pull request as ready for review June 10, 2026 06:28
Master added [1.1.1] (v12.0.0 sync). Our template sub-skill work
becomes [1.2.1] sitting above it. Skill metadata version bumped from
1.2.0 to 1.2.1; package.json + package-lock.json aligned.
…gent-evaluation lab

Pulls forward the skill content tested via mule-dx-agent-evaluation
(template-eval-only pilot run) where it scored well across the realistic
template-creation paths.

Skill changes:
- Step 1b options reordered so 'I want to generate from scratch without a
  template.' is the first option (default-safe).
- Steps E5 / L5 continue-or-stop checkpoints added at the end of the
  Exchange and Local sub-flows. Agent always asks the user whether to
  proceed to connector discovery + flow generation or stop after template
  setup.
- Local template format relaxed from .jar-only to .jar or .zip (the CLI
  already accepts both via --template-file).
- Absolute-path / 'no relative ../scripts/...' rule for invoking bundled
  scripts, plus a 'why scripts instead of inline bash' rationale based on
  production-run failure analysis (resolved GAVs lost across Bash tool
  calls).
- Phase 2 step ranges renumbered (Steps 8-17 from 8-18); flow XML
  generation cross-references corrected (Steps 10/12 instead of 11/13);
  pre-mvn validation script reference added to the troubleshooting
  cheatsheet.

Versioning:
- skill metadata: 1.2.1 -> 1.3.0
- package.json + package-lock.json: 1.2.1 -> 1.3.0
- CHANGELOG entry added.
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.

2 participants