Skip to content

feat: pattern catalogue (catalogue + skill generation)#288

Open
IzumiSy wants to merge 8 commits into
mainfrom
feat/catalogue-pattern-system
Open

feat: pattern catalogue (catalogue + skill generation)#288
IzumiSy wants to merge 8 commits into
mainfrom
feat/catalogue-pattern-system

Conversation

@IzumiSy
Copy link
Copy Markdown
Contributor

@IzumiSy IzumiSy commented May 26, 2026

Implements the foundation of the Unified Pattern (platform-planning#1206), providing a catalogue/ workspace for defining UI patterns and a script to generate LLM-consumable skills from them.

What's included

catalogue/ workspace package

  • Pattern definitions in PATTERN.md files with YAML frontmatter (slug, title, category, do/don't rules)
  • Source code co-located with each pattern (.tsx files referenced via <!-- source: file.tsx --> markers)
  • Fundamental references (fundamental/) — foundational rules for components, design system, and GraphQL conventions
  • Type-checked pattern implementations against @tailor-platform/app-shell

Skill generation (catalogue/scripts/generate-skill.mjs)

  • Reads all PATTERN.md files and fundamental references across categories
  • Resolves <!-- source: ... --> markers by embedding referenced file contents as fenced code blocks
  • Generates skill files into packages/core/skills/app-shell-patterns/ for npm distribution
  • Template-based output via SKILL.template.md

Generated output (packages/core/skills/app-shell-patterns/)

  • Distributed as part of the @tailor-platform/app-shell npm package (files: ["dist/**", "skills/**"])
  • Ready-to-use skill files that LLM agents can consume for code generation guidance

Seed patterns

  • list/dense-scan — Dense list with DataTable, sort, filters, and pagination
  • detail/hero-with-actions — Single-record detail view with workflow actions and activity timeline
  • form/modal, form/sectioned, form/single-page, form/wizard — Form patterns
  • interaction/confirm, interaction/multi-select, interaction/toast — Interaction patterns

How to use

cd catalogue
pnpm build            # Generate skills into packages/core/skills/
pnpm type-check       # Type-check all pattern files

Out of scope (future work)

  • Additional patterns (screens, recipes)
  • Viewer app for browsing patterns visually
  • CI integration for automatic skill regeneration on publish

@IzumiSy IzumiSy force-pushed the feat/catalogue-pattern-system branch from 78a27fb to 646031b Compare May 26, 2026 02:11
@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented May 26, 2026

Open in StackBlitz

npm i https://pkg.pr.new/@tailor-platform/app-shell@288
npm i https://pkg.pr.new/@tailor-platform/app-shell-sdk-plugin@288
npm i https://pkg.pr.new/@tailor-platform/app-shell-vite-plugin@288

commit: e375728

@IzumiSy IzumiSy force-pushed the feat/catalogue-pattern-system branch 2 times, most recently from d512557 to c1f4c7f Compare May 26, 2026 03:24
@IzumiSy
Copy link
Copy Markdown
Contributor Author

IzumiSy commented May 26, 2026

  • Place skills under package/core to distrubute artifacts through npm package to make it accesible to AI through node_modules.

@IzumiSy IzumiSy changed the title feat: Unified Pattern System (catalogue + skill generation) feat: Pattern catalogue (catalogue + skill generation) May 26, 2026
IzumiSy added 6 commits May 26, 2026 15:03
- Add catalogue/ workspace package with pattern definitions
- Implement dense-scan list pattern as initial seed
- Add generate-skill.mjs script to produce skills from patterns
- Generate skills/app-shell-patterns/ output for LLM consumption
- Use gray-matter for frontmatter parsing
- detail/hero-with-actions: single-record detail with workflow actions and activity timeline
- form/modal: default create/edit form with route-driven variant
- form/sectioned: complex form with 15+ fields in named fieldset sections
- form/single-page: routed full-page form for moderate field count
- form/wizard: multi-stage create flow with step validation
- interaction/confirm: confirmation dialog for destructive actions
- interaction/toast: lightweight mutation feedback
- interaction/multi-select: floating bottom bar for bulk row operations
- Updated list/dense-scan with DataTable/useCollectionVariables guidance
- Generated skills from catalogue patterns
@IzumiSy IzumiSy force-pushed the feat/catalogue-pattern-system branch from e7cdbdb to e375728 Compare May 26, 2026 06:03
@IzumiSy IzumiSy changed the title feat: Pattern catalogue (catalogue + skill generation) feat: pattern catalogue (catalogue + skill generation) May 26, 2026
@IzumiSy IzumiSy requested a review from itsprade May 26, 2026 07:21
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