Ent Framework Programmer

ENT Framework Programmer

Overview

ENT Framework = Markdown-based Vue 2 + Quasar development where components are .md files that compile to Vue runtime. Core principle: Follow ENT patterns strictly - no rationalizations allowed.

When to Use

digraph when_flowchart {
    "Creating Vue components?" [shape=diamond];
    "User mentions ENT framework?" [shape=diamond];
    "Agent using Vue 3 patterns?" [shape=diamond];
    "Use this skill" [shape=box];
    "Use standard Vue docs" [shape=box];

    "Creating Vue components?" -> "User mentions ENT framework?" [label="yes"];
    "User mentions ENT framework?" -> "Use this skill" [label="yes"];
    "Agent using Vue 3 patterns?" -> "Use this skill" [label="yes"];
    "Creating Vue components?" -> "Use standard Vue docs" [label="no"];
    "Agent using Vue 3 patterns?" -> "Use this skill" [label="no"];
}

Load when:

• User requests "create ENT component/page/store/namespace"
• Agent violates ENT patterns (Vue 3, custom CSS, v-slot syntax)
• Working with .md files containing YAML frontmatter

Don't use for: Standard Vue/React projects

Core Pattern

Before (Wrong):

# ❌ Vue 3 Composition API
import { ref } from 'vue'
const count = ref(0)

# ❌ Custom CSS
.card { padding: 16px; }

# ❌ v-slot syntax
template(v-slot:header)

After (Correct):

# ✅ Vue 2 Options API
## data
{ count: 0 }

# ✅ Quasar utilities
q-card.q-pa-md

# ✅ ENT slot syntax
template(#header="{}")

Quick Reference

Implementation

Component Structure

# components/user-card.component.md
---
namespace: tm
component:
  enabled: true
  name: UserCard
  lang: pug
---

## props
```js
{
  user: {type: Object, required: true}
}

template

q-card.q-pa-md.bg-surface
  .text-h6.text-on-surface {{ user.name }}
  .text-body2.text-on-surface-dim {{ user.email }}

### Store Structure
```yaml
# stores/auth.store.md
---
namespace: tm
component:
  enabled: true
  name: AuthStore
  extends: base/BaseStore
store:
  enabled: true
  name: auth-store
---

## data
```js
{
  userId: null,
  isLogged: false
}

methods

{
  async loadUser() {
    const result = await this.callRestApi({
      func: 'loadUser',
      payload: {}
    })
    this.userId = result.id
    this.isLogged = true
  }
}

### Page Structure
```yaml
# pages/dashboard.page.md
---
namespace: tm
component:
  enabled: true
  name: DashboardPage
  lang: pug
page:
  enabled: true
  title: Dashboard
  route: tm/dashboard
---

Common Mistakes

❌ CRITICAL: Slot Syntax Violations

// ABSOLUTELY FORBIDDEN - COMPILATION WILL FAIL!
template(v-slot:header)     // 🚫 NEVER use v-slot: prefix
template(v-slot:actions)    // 🚫 NEVER use v-slot: prefix
template(v-slot:append)     // 🚫 NEVER use v-slot: prefix
template(#header)           // 🚫 Missing equals

// ✅ CORRECT - ONLY use #slotname with equals!
template(#header="{}")
template(#actions="")
template(#append="{}")

❌ Vue 3 vs Vue 2

// WRONG - Vue 3 Composition API
import { ref } from 'vue'
const count = ref(0)

// CORRECT - Vue 2 Options API
## data
{ count: 0 }

❌ Styling Violations

// WRONG - Custom CSS
## styleModule
.card { padding: 16px; }

// CORRECT - Quasar utilities
## template
q-card.q-pa-md

❌ API Call Violations

// WRONG - Standard fetch
await fetch('/api/data')

// CORRECT - ENT API method
await this.callRestApi({ func: 'getData', payload: {} })

❌ Method/Data Name Conflicts

// WRONG - Same name for data and method (Vue 2 error!)
## data
{ showDialog: false }

## methods
{ showDialog() { this.showDialog = true } }

// CORRECT - Different names
## data
{ isDialogOpen: false }

## methods
{ openDialog() { this.isDialogOpen = true } }

❌ Multiple Root Elements

// WRONG - Vue 2 requires single root element
## template
div Main content
q-dialog(v-model="showDialog") Dialog

// CORRECT - Everything inside single root
## template
div
  | Main content
  q-dialog(v-model="showDialog") Dialog

Rationalization Table

Red Flags - STOP and Check Skill

STOP immediately if you catch yourself:

• Thinking "Vue 3 Composition API"
• Writing custom CSS in styleModule
• Using template(v-slot:header) or any v-slot: prefix
• Creating methods with same name as data properties
• Creating multiple root elements in template
• Using fixed colors like text-grey-6, bg-blue-1
• Using fetch() or axios for API calls
• Creating store without extends: base/BaseStore
• Creating page without component section
• Saying "I know Vue/Quasar" (≠ knowing ENT)

All of these mean: You're NOT using ENT patterns. Re-read this skill.

Dark Mode Quick Rules

✅ USE semantic colors:

q-card.bg-surface.bordered
  .text-h6.text-on-surface Main text
  .text-body2.text-on-surface-dim Secondary text
  .text-caption.text-on-surface-dim-2 Helper text

❌ NEVER use fixed colors:

q-card.bg-blue-1           // Breaks dark mode
  .text-h6.text-grey-6     // Invisible in dark mode

File Organization

Required folder structure:

[namespace]/
  components/
  pages/
  stores/
  libs/

Required file extensions:

• Components: .component.md
• Pages: .page.md
• Stores: .store.md
• Namespaces: .namespace.md

Critical Dependencies

REQUIRED SUB-SKILL: You MUST understand and apply all patterns from this skill. No exceptions or rationalizations allowed.

For complete ENT documentation: See /docs symlinks in project:

• docs/ent-main-doc.md - Complete reference
• docs/component.md - Component examples
• docs/store.md - Store patterns

Reference these only when: You need comprehensive API details beyond these patterns.