Skip to content

[DRAFT] Integrate spec-driven development workflow#2213

Draft
leonardomendix wants to merge 1 commit into
mainfrom
chore/openspec-v1
Draft

[DRAFT] Integrate spec-driven development workflow#2213
leonardomendix wants to merge 1 commit into
mainfrom
chore/openspec-v1

Conversation

@leonardomendix
Copy link
Copy Markdown
Collaborator

Pull request type

No code changes (changes to documentation, CI, metadata, etc.)


Description

Sets up OpenSpec for spec-driven widget development. Introduces per-widget openspec directories alongside a custom mendix-widget schema and tool-agnostic agent rules.

What's included:

  • config.yaml — monorepo-level context (Mendix API patterns, tech stack, per-artifact rules)
  • mendix-widget — custom schema with 4 Mendix-aware artifact templates (proposal, spec, design, tasks) and correct dependency order
  • spec.md — shared widget development conventions as a formal spec (ActionValue guard, XML alignment, semver, Atlas UI, testing)
  • mendix-widget.md — concise, tool-agnostic coding rules for any AI coding assistant
  • Pilot widgets initialized: datagrid-web, combobox-web, gallery-web — each with config.yaml, brownfield baseline specs/spec.md, and per-widget AGENTS.md
  • @fission-ai/openspec added to root devDependencies

Agent files updated:

  • AGENTS.md — OpenSpec workflow section with per-widget init convention
  • CLAUDE.mdspec.md + schema auto-loaded


## API Guards

- ALWAYS check `actionValue.canExecute` before calling `execute()`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We have a utility function that does this, maybe we could refer that too.

Copy link
Copy Markdown
Collaborator

@iobuhov iobuhov left a comment

Choose a reason for hiding this comment

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

Main question - how openspec going to work per package?

Comment thread openspec/config.yaml
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think we should use default schema for now. This context is very widget specific and we probably should make a skill out of it.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think this file needs splitting. We probably should create ~/.agents/conventions as conventions is subject to change. We can use this spec as a pointer to our conventions files.

Comment thread openspec/README.md
/opsx:archive
```

## Structure
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Probably not final structure, so I would avoid this section for now.

@iobuhov
Copy link
Copy Markdown
Collaborator

iobuhov commented May 13, 2026

I like the idea of mendix-widget schema

@iobuhov
Copy link
Copy Markdown
Collaborator

iobuhov commented May 13, 2026

Main question - how openspec going to work per package?

We can use openspec cii to init each widget with (--tools none)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants