groundwork

v0.5.0

Whole-app UI/UX planning for AI builders. Groundwork codifies the product schema, requirements, flows, screens, states, design patterns, architecture, implementation plan, and acceptance criteria into one traceable builder packet. Start with /groundwork:run.

CodexClaude Code6 Skills

By Tyrone RossLicense: Apache-2.00 GitHub starsUpdated 2 weeks ago

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 6 skill or MCP entries
Source updated: Oct 6, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install groundwork for Codex and Claude Code

Installs for the current user

codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add groundwork@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

Compatibility: the page URL and API slug “groundwork-2” remain stable.

Codex: groundwork-2@agent-plugin-marketplace → groundwork@agent-plugin-marketplace

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/tyroneross/groundwork-public

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

groundwork/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/calm-precision/SKILL.md
├── skills/groundwork/SKILL.md
├── skills/interface-designer/SKILL.md
├── skills/product-design-architect/SKILL.md
├── skills/product-design-manager/SKILL.md
└── skills/ui-ux-researcher/SKILL.md

Included Skills6

calm-precisionskills/calm-precision/SKILL.md

UI/UX implementation guide for building cognitively predictable interfaces. WHAT: Decision trees, component patterns, code examples, anti-patterns, and audit checklists grounded in perceptual science (Gestalt, Fitts, Hick, Cognitive Load, Signal-to-Noise, Affordance, Temporal Gestalt, Dual-Coding, Pragmatic Inference, Attentional Cascade). WHEN: Building or modifying frontend components, pages, layouts, navigation, forms, dashboards, or lists. Reviewing UI for design compliance. Any frontend design or implementation task. Triggers: "build a component", "create a page", "add UI", "frontend design", "design review", "UI audit", "navigation", "form layout", "dashboard", "list view", "card component", "build the frontend", "style this", "make it look good", "chart", "graph", "data visualization", "KPI", "sparkline", "timeline chart", "table design"

groundworkskills/groundwork/SKILL.md

Use Groundwork to plan a whole app and codify its product schema, requirements, UI/UX flows, screens, states, design patterns, architecture, implementation plan, acceptance criteria, traceability, and Build Loop handoff. Trigger for a raw idea, an existing app, design preferences, mockups, or any product definition that must stay coherent across the full system. Also trigger to compare options, decide A vs B, or record the user's design decisions on a mobile-friendly compare board.

interface-designerskills/interface-designer/SKILL.md

Design or evolve complete interface systems in Groundwork, including information architecture, flows, screens, states, interaction behavior, content hierarchy, responsive behavior, accessibility, tokens, and visual direction. Use for UI concepts, screen redesigns, design systems, mockups, interaction refinement, or when a selected aesthetic must become a coherent product experience.

product-design-architectskills/product-design-architect/SKILL.md

Connect Groundwork interface and product decisions to functional application architecture. Use when adding or changing a screen, workflow, control, data display, integration, API, event, platform surface, or design-system behavior; when auditing UI-to-spec completeness; or before producing a build-ready handoff that must trace data, components, contracts, flows, tasks, and tests.

product-design-managerskills/product-design-manager/SKILL.md

Orchestrate whole-app UI/UX planning in Groundwork from any product starting point through schema, requirements, flows, screens, states, design patterns, architecture, implementation planning, validation, and a build-ready handoff. Use for broad app ideas, existing products, multi-stage design work, or one UI surface whose system impacts must stay tracked.

ui-ux-researcherskills/ui-ux-researcher/SKILL.md

Plan, conduct, and synthesize decision-ready UI/UX research for Groundwork. Use when user behavior, usability, information architecture, accessibility, content, workflow risk, comparative patterns, or evidence gaps could change a product or interface decision; also use to test a prototype or distinguish observed evidence from assumptions before design convergence.

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "groundwork",
  "version": "0.5.0",
  "description": "Whole-app UI/UX planning for AI builders. Groundwork codifies the product schema, requirements, flows, screens, states, design patterns, architecture, implementation plan, and acceptance criteria into one traceable builder packet. Start with /groundwork:run.",
  "author": {
    "name": "Tyrone Ross"
  },
  "repository": "https://github.com/tyroneross/groundwork-public",
  "license": "Apache-2.0",
  "keywords": [
    "product-design",
    "product-planning",
    "requirements",
    "ui-design",
    "mockups",
    "design-system",
    "codex",
    "claude-code"
  ],
  "skills": "./skills",
  "interface": {
    "displayName": "Groundwork",
    "shortDescription": "Plan a whole app and codify its UI/UX and system design.",
    "longDescription": "Groundwork plans a whole app before production code changes. It turns an idea or existing product into one canonical product schema covering requirements, UX flows, screens and states, design patterns, architecture, implementation tasks, tests, and acceptance criteria, then emits a traceable builder packet.",
    "developerName": "Ross Labs",
    "category": "Design",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/tyroneross/groundwork-public",
    "defaultPrompt": [
      "Plan this whole app by capturing what is already decided and identifying the design gaps.",
      "Plan this whole app and codify its product schema, UI/UX, architecture, and build plan.",
      "Plan the app's visual direction and codify the UI patterns to build.",
      "Compare version A and version B of these screens and record my decisions."
    ],
    "brandColor": "#0F766E"
  }
}

.claude-plugin/plugin.json

{
  "name": "groundwork",
  "version": "0.5.0",
  "description": "Whole-app UI/UX planning for AI builders. Groundwork codifies the product schema, requirements, flows, screens, states, design patterns, architecture, implementation plan, and acceptance criteria into one traceable builder packet. Start with /groundwork:run.",
  "author": {
    "name": "Tyrone Ross"
  },
  "repository": "https://github.com/tyroneross/groundwork-public",
  "license": "Apache-2.0",
  "keywords": [
    "product-design",
    "product-planning",
    "requirements",
    "ui-design",
    "mockups",
    "design-system",
    "codex",
    "claude-code"
  ]
}