Skip to content

docs(skills,mcp): LeanIX bridge references and agent-facing docs#2828

Merged
davydkov merged 8 commits into
mainfrom
docs/leanix-bridge-skills-mcp-agents
Apr 10, 2026
Merged

docs(skills,mcp): LeanIX bridge references and agent-facing docs#2828
davydkov merged 8 commits into
mainfrom
docs/leanix-bridge-skills-mcp-agents

Conversation

@sraphaz

@sraphaz sraphaz commented Apr 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

This PR contains documentation and agent-skill updates only:

  • AGENTS.md: agent-oriented pointers for the repo and LeanIX bridge workflow.
  • packages/mcp/README.md: clarify MCP vs LeanIX bridge and Draw.io --profile leanix.
  • skills/likec4-dsl/: SKILL.md plus references bridge-leanix-drawio.md and cli.md.

Includes changeset: .changeset/leanix-bridge-skills-mcp-docs.md.

A separate PR covers @likec4/config, @likec4/generators, and @likec4/leanix-bridge code/test changes (no file overlap). Either PR can merge first.

Motivation

Keeps docs and skills in their own PR so reviewers do not mix them with schema, mapping, and generator test changes.

Verification

This PR changes Markdown only (AGENTS.md, packages/mcp/README.md, skills/likec4-dsl/). There are no diagram app or docs-site UI changes in this diff.

  • pnpm test is still a reasonable local sanity check for the monorepo (optional for a pure-doc PR, but recommended if your branch is not up to date with main).
  • Playwright E2E viewports (pnpm test:e2e, mobile/tablet/desktop) are N/A for validating this documentation-only diff; use them only if you want broader unrelated regression coverage.

Per CONTRIBUTING, if you do run tests, prefer a clean tree (pnpm clean before pnpm test if you hit stale ignored *.js under packages/*/src/ — see .gitignore).

Checklist

  • I've thoroughly read the latest contribution guidelines.
  • I've rebased my branch onto main before creating this PR.
  • My commit messages follow conventional spec
  • I've added tests to cover my changes (if applicable). (N/A — documentation and skill text only.)
  • I've verified that all new and existing tests have passed locally for mobile, tablet, and desktop screen sizes. (N/A — no UI/diagram changes; use pnpm test:e2e only if you want full Playwright coverage unrelated to this diff.)
  • My change requires documentation updates.
  • I've updated the documentation accordingly.

@changeset-bot

changeset-bot Bot commented Apr 2, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: bb69f1b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 21 packages
Name Type
@likec4/mcp Patch
likec4 Patch
@likec4/docs-astro Patch
likec4-vscode Patch
@likec4/playground Patch
@likec4/style-preset Patch
@likec4/styles Patch
@likec4/config Patch
@likec4/core Patch
@likec4/diagram Patch
@likec4/generators Patch
@likec4/language-server Patch
@likec4/language-services Patch
@likec4/layouts Patch
@likec4/leanix-bridge Patch
@likec4/log Patch
@likec4/lsp Patch
@likec4/react Patch
@likec4/tsconfig Patch
@likec4/vite-plugin Patch
@likec4/vscode-preview Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitai Bot commented Apr 2, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 8fef880b-f6c2-4280-b634-6c1c012c37b2

📥 Commits

Reviewing files that changed from the base of the PR and between 3435503 and bb69f1b.

📒 Files selected for processing (1)
  • skills/likec4-dsl/SKILL.md
✅ Files skipped from review due to trivial changes (1)
  • skills/likec4-dsl/SKILL.md

📝 Walkthrough

Walkthrough

This pull request updates documentation to add LeanIX/Draw.io bridge guidance, clarify MCP server responsibilities, and extend the LikeC4 DSL agent skill docs with a new bridge reference and LeanIX-specific CLI workflows.

Changes

Cohort / File(s) Summary
Changeset & Repo Index
/.changeset/leanix-bridge-skills-mcp-docs.md, AGENTS.md
Added a changeset marking patch documentation updates; updated AGENTS.md to reference skills/ (LikeC4 DSL), the MCP server README, and the LeanIX/Draw.io bridge README and skill reference.
MCP Server Docs
packages/mcp/README.md
Updated MCP transport spec date and clarified MCP tools expose the resolved LikeC4 model but do not generate LeanIX bridge artifacts, run LeanIX sync, or export Draw.io; pointed to CLI and bridge docs.
LikeC4 Agent Skill Docs
skills/likec4-dsl/SKILL.md, skills/likec4-dsl/references/bridge-leanix-drawio.md, skills/likec4-dsl/references/cli.md
Added a reference linking agent tasks to LeanIX bridge guidance; new bridge-leanix-drawio.md documents Draw.io leanix profile, bridge-managed attributes, round-trip mapping, CLI workflows, and config validation; CLI docs extended with LeanIX-specific commands and links to the new reference.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested reviewers

  • davydkov
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically summarizes the main change: documentation updates for LeanIX bridge references and agent-facing documentation across skills and MCP packages.
Description check ✅ Passed The description is thorough and complete, covering summary, motivation, verification steps, and a detailed checklist with appropriate N/A markings for documentation-only changes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/leanix-bridge-skills-mcp-agents

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Comment thread skills/likec4-dsl/SKILL.md Outdated
---
name: likec4-dsl
description: Use when working with `.c4`/`.likec4` files or LikeC4 CLI/config questions where exact DSL/CLI syntax is required, especially for strict command/snippet-first answers, validate/export flags, predicates `*`/`_`/`**`, deployment snippets, dynamic views, or relationship extension matching.
description: Use when working with `.c4`/`.likec4` files or LikeC4 CLI/config questions where exact DSL/CLI syntax is required, especially for strict command/snippet-first answers, validate/export flags, predicates `*`/`_`/`**`, deployment snippets, dynamic views, or relationship extension matching. LeanIX bridge or drawio `--profile leanix` (sync, artifacts, bridge-managed cells) → `references/bridge-leanix-drawio.md`.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Don't think we need it in description, mentioning it in Reference Index should be enough

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Greatful for the feedback! Agreed on that — updated accordingly: lean description for routing, LeanIX/drawio details only via the Reference Index + references/bridge-leanix-drawio.md. Thanks!

@davydkov davydkov merged commit 75fa6d2 into main Apr 10, 2026
16 checks passed
@davydkov davydkov deleted the docs/leanix-bridge-skills-mcp-agents branch April 10, 2026 09:24
@likec4-ci likec4-ci Bot mentioned this pull request Apr 9, 2026
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