Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
177 changes: 177 additions & 0 deletions .claude/skills/docs-research/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,177 @@
---
name: docs-research
description: "Locates and summarizes content across the Mendix documentation repository. Use when the user needs to find where a topic is documented or needs information from the docs."
---

# Docs Research

Locate, read, and summarize content across 4,500+ Markdown files in the Mendix documentation repository.

## Workflow

1. Identify relevant topic(s) from the topic map below or by searching.
2. Locate source files using the methods in Finding Content. When a question spans multiple topics, read files in parallel.
3. Read the file(s) and extract passages relevant to the user's question.
4. Respond using the output format below.
5. Cite sources — End your response with a **Citations** section listing every source you consulted. This step is mandatory — never omit it.

## Finding Content

| Goal | Method |
|------|--------|
| URL → source file | `bash .claude/scripts/resolve-doc-url.sh "/refguide/security/"` |
| Find by filename | `glob "content/en/docs/**/*offline*.md"` |
| Search body text | `grep "offline-first" --include="*.md" --path="content/en/docs/"` |
| Find images | `glob "static/attachments/refguide/**/*.png"` |
| Resolve a link target | Check `url:` in the target file's front matter |

## Output Format

1. **Direct answer** — Begin with a concise answer to the user's question.
2. **Supporting details** — Provide relevant details, quoting key passages where helpful.
3. **Citations** (required) — You MUST end your response with a list of source links. Never omit this section.

If no relevant content is found, state that clearly and do not speculate.

### Citation Format

Cite each source as a markdown link using the page's `title` and `url` front matter fields:

```
[Page Title](https://docs.mendix.com{url})
```

For example, a page with `title: "Security"` and `url: /refguide/security/` is cited as:

```
[Security](https://docs.mendix.com/refguide/security/)
```

## Topic Map

### Studio Pro Reference (`refguide/`)

| Topic | Path | URL |
|-------|------|-----|
| App Modeling | `refguide/modeling/` | `/refguide/modeling/` |
| Pages & UI | `refguide/modeling/pages/` | `/refguide/pages/` |
| Domain Model | `refguide/modeling/domain-model/` | `/refguide/domain-model/` |
| Application Logic | `refguide/modeling/application-logic/` | `/refguide/application-logic/` |
| Security | `refguide/modeling/security/` | `/refguide/security/` |
| Integration (REST, OData) | `refguide/modeling/integration/` | `/refguide/integration/` |
| XPath | `refguide/modeling/xpath/` | `/refguide/xpath/` |
| Resources | `refguide/modeling/resources/` | `/refguide/resources/` |
| Consistency Errors | `refguide/modeling/consistency-errors/` | `/refguide/consistency-errors/` |
| Menus & Studio Pro UI | `refguide/modeling/menus/` | `/refguide/menus/` |
| AI Assistance (Maia) | `refguide/modeling/mendix-ai-assistance/` | `/refguide/mendix-ai-assistance/` |
| App Explorer | `refguide/modeling/app-explorer/` | `/refguide/app-explorer/` |
| Import/Export | `refguide/modeling/import-and-export/` | `/refguide/import-and-export/` |
| Best Practices | `refguide/modeling/best-practices/` | `/refguide/modeling-best-practices/` |
| Runtime | `refguide/runtime/` | `/refguide/runtime/` |
| Java Programming | `refguide/java-programming/` | `/refguide/java-programming/` |
| Version Control | `refguide/version-control/` | `/refguide/version-control/` |
| Installation | `refguide/installation/` | `/refguide/installation/` |
| Testing | `refguide/testing/` | `/refguide/testing/` |

### Mobile Development (`refguide/mobile/`)

| Topic | URL |
|-------|-----|
| Getting Started | `/refguide/mobile/getting-started-with-mobile/` |
| Intro to Technologies | `/refguide/mobile/introduction-to-mobile-technologies/` |
| Building Efficient Apps | `/refguide/mobile/building-efficient-mobile-apps/` |
| Mobile UI Design | `/refguide/mobile/designing-mobile-user-interfaces/` |
| Mobile Capabilities | `/refguide/mobile/using-mobile-capabilities/` |
| Build, Test, Distribute | `/refguide/mobile/distributing-mobile-apps/` |
| PWA Wrapper | `/refguide/mobile/pwa-wrapper/` |
| Mobile Best Practices | `/refguide/mobile/best-practices/` |

### How-Tos (`howto/`)

| Topic | URL |
|-------|-----|
| Data Models | `/howto/data-models/` |
| Front End (UI/UX) | `/howto/front-end/` |
| Securing Your Data | `/howto/security/` |
| Extensibility | `/howto/extensibility/` |

### Deployment (`deployment/`)

| Topic | URL |
|-------|-----|
| General | `/developerportal/deploy/general/` |
| Mendix Cloud | `/developerportal/deploy/mendix-cloud-deploy/` |
| Docker | `/developerportal/deploy/docker/` |
| Azure | `/developerportal/deploy/mendix-on-azure/` |
| Kubernetes / Private Cloud | `/developerportal/deploy/private-cloud/` |
| SAP BTP | `/developerportal/deploy/sap-cloud-platform/` |
| On-Premises | `/developerportal/deploy/on-premises-design/` |

### Developer Portal (`developerportal/`)

| Topic | URL |
|-------|-----|
| General | `/developerportal/general/` |
| App Insights | `/developerportal/app-insights/` |
| Project Management | `/developerportal/project-management/` |
| Repository / Team Server | `/developerportal/repository/` |
| Settings | `/developerportal/general-settings/` |

### Control Center (`control-center/`)

| Topic | URL |
|-------|-----|
| Apps | `/control-center/apps/` |
| Company | `/control-center/company/` |
| Content Curation | `/control-center/content-curation/` |
| Entitlements | `/control-center/entitlements/` |
| Marketplace | `/control-center/marketplace/` |
| People | `/control-center/people/` |
| Security | `/control-center/security/` |

### Marketplace (`marketplace/`)

| Topic | URL |
|-------|-----|
| Overview | `/appstore/overview/` |
| Using Content | `/appstore/use-content/` |
| Creating Content | `/appstore/creating-content/` |
| Uploading Content | `/appstore/submit-content/` |
| GenAI Capabilities | `/appstore/modules/genai/` |
| Platform-Supported Content | `/appstore/platform-supported-content/` |
| Partner Solutions | `/appstore/partner-solutions/` |

### Other Sections

| Section | URL |
|---------|-----|
| Catalog | `/catalog/` |
| APIs & SDK | `/apidocs-mxsdk/` |
| Release Notes | `/releasenotes/` |
| Quickstarts | `/quickstarts/` |
| Support | `/support/` |
| Private Platform | `/private-mendix-platform/` |
| Mendix Portal | `/portal/` |
| Community Tools / Style Guide | `/community-tools/` |
| Partners (AWS, SAP, Siemens, Snowflake) | `/partners/<name>/` |
| Workstation | `/workstation/` |

### Older Versions

`refguide10/`, `refguide9/`, `refguide8/`, `howto10/`, `howto9/`, `howto8/` — same structure as current, for Studio Pro 10, 9, and 8.

## Style Guide Location

`content/en/docs/community-tools/contribute-to-mendix-docs/style-guide/`:

- `grammar-formatting.md` — Grammar and formatting rules
- `terminology.md` — Term conventions
- `product-naming-guide.md` — Product names

## Conventions

- `_index.md` = section landing page
- `url` field: starts/ends with `/`, lowercase, hyphens only
- Images: `{{< figure src="/attachments/..." alt="..." >}}`
- Links: use `url` value (e.g., `[Security](/refguide/security/)`)
- All paths relative to `content/en/docs/`
135 changes: 135 additions & 0 deletions .claude/skills/evalguide-research/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,135 @@
---
name: evalguide-research
description: "Fetches and summarizes content from the Mendix Evaluation Guide to answer questions about platform capabilities, architecture, security, deployment, and governance."
user-invocable: true
disable-model-invocation: false
---

# Mendix Evaluation Guide Research

Fetch and summarize content from the Mendix Evaluation Guide at `https://www.mendix.com/evaluation-guide/`.

## Workflow

1. Identify relevant topic(s) from the topic map below.
2. Use WebFetch to fetch the full page(s). When a question spans multiple topics, fetch pages in parallel.
3. Read the entire fetched content to find passages relevant to the user's question.
4. Respond using the output format below.
5. Cite sources — End your response with a **Citations** section listing every source you consulted. This step is mandatory — never omit it.

If the topic map does not cover the user's question, report that no relevant content was found in the Evaluation Guide.

## Output Format

1. **Direct answer** — Begin with a concise answer to the user's question.
2. **Supporting details** — Provide relevant details, quoting key passages where helpful.
3. **Citations** (required) — You MUST end your response with a list of source links. Never omit this section.

If no relevant content is found, state that clearly and do not speculate.

### Citation Format

Cite each source as a markdown link using the page title and its full URL:

```
[Page Title](https://www.mendix.com/evaluation-guide/...)
```

For example:

```
[Runtime Security](https://www.mendix.com/evaluation-guide/security/runtime-security/)
```

## Topic Map

All URLs are relative to `https://www.mendix.com`. Prepend the base URL when fetching.

### Overview

| Topic | URL |
|-------|-----|
| Welcome to Mendix | /evaluation-guide/what-is-mendix/ |
| What You Can Build | /evaluation-guide/what-can-i-build/ |
| Why Choose Mendix | /evaluation-guide/mendix-difference/ |
| Industry Analysts | /evaluation-guide/gartner-forrester-mendix/ |
| Digital Execution Practice | /evaluation-guide/digital-execution-practice/ |

### Software Development Life Cycle

| Topic | URL |
|-------|-----|
| SDLC Overview | /evaluation-guide/app-lifecycle/ |
| Ideate | /evaluation-guide/app-lifecycle/ideate/ |
| Prioritize | /evaluation-guide/app-lifecycle/prioritize/ |
| Plan | /evaluation-guide/app-lifecycle/plan/ |
| Develop | /evaluation-guide/app-lifecycle/develop/ |
| Deploy | /evaluation-guide/app-lifecycle/deploy/ |
| Operate | /evaluation-guide/app-lifecycle/operate/ |
| Evaluate | /evaluation-guide/app-lifecycle/evaluate/ |

### Deployment

| Topic | URL |
|-------|-----|
| Deployment Overview | /evaluation-guide/deployment/ |
| Deployment Flexibility | /evaluation-guide/deployment/flexibility/ |
| Mendix Cloud Deployments | /evaluation-guide/deployment/mendix-cloud/ |
| Private Cloud Deployments | /evaluation-guide/deployment/private-cloud/ |
| Partner Cloud Deployments | /evaluation-guide/deployment/partner-cloud/ |

### Architecture

| Topic | URL |
|-------|-----|
| Architecture Overview | /evaluation-guide/architecture/ |
| Architecture Principles | /evaluation-guide/architecture/architecture-principles/ |
| Platform Architecture | /evaluation-guide/architecture/platform-architecture/ |
| Cloud Architecture | /evaluation-guide/architecture/cloud-architecture/ |
| Runtime Architecture | /evaluation-guide/architecture/runtime-architecture/ |
| Twelve-Factor Architecture | /evaluation-guide/architecture/twelve-factor-architecture/ |
| Openness & Extensibility | /evaluation-guide/architecture/openness-extensibility/ |

### Security

| Topic | URL |
|-------|-----|
| Security Overview | /evaluation-guide/security/ |
| Introduction to Mendix Security | /evaluation-guide/security/introduction-to-mendix-security/ |
| Organization & Compliance | /evaluation-guide/security/organization-compliance/ |
| Platform Security | /evaluation-guide/security/platform-security/ |
| Security Model | /evaluation-guide/security/security-model/ |
| Runtime Security | /evaluation-guide/security/runtime-security/ |
| Cloud Security | /evaluation-guide/security/cloud-security/ |
| Secure Development Lifecycle | /evaluation-guide/security/secure-development-lifecycle/ |
| Integrated Monitoring and Logging | /evaluation-guide/security/integrated-monitoring-and-logging/ |
| Data Security | /evaluation-guide/security/data-security/ |
| Governance, Risk, and Compliance | /evaluation-guide/security/governance-risk-and-compliance/ |

### Governance

| Topic | URL |
|-------|-----|
| Governance Overview | /evaluation-guide/governance/ |
| Investment Control | /evaluation-guide/governance/investment-control/ |
| Risk Control | /evaluation-guide/governance/risk-control/ |

### Strategic Partnerships

| Topic | URL |
|-------|-----|
| Strategic Partners Overview | /evaluation-guide/strategic-partners/ |
| AWS | /evaluation-guide/strategic-partners/aws/ |
| SAP | /evaluation-guide/strategic-partners/sap/ |
| Snowflake | /evaluation-guide/strategic-partners/snowflake/ |

### Getting Started

| Topic | URL |
|-------|-----|
| Getting Started Overview | /evaluation-guide/evaluation-learning/ |
| Try Mendix for Free | /evaluation-guide/evaluation-learning/try-mendix-for-free/ |
| Learning | /evaluation-guide/evaluation-learning/certification-talent/ |
| Company Onboarding | /evaluation-guide/evaluation-learning/company-onboarding/ |
| Community | /evaluation-guide/evaluation-learning/community/ |
| Support | /evaluation-guide/evaluation-learning/support/ |
Loading
Loading