What is the recommended troubleshooting for weird build errors?

The skill suggests a 'nuclear option' which involves cleaning build artifacts, removing node_modules and the lockfile, and performing a fresh install and build to resolve stale state.

Can I run tests for a single module within the monorepo?

Yes, the skill provides specific commands to run isolated tests from the root using the --projects flag, such as npm test -- --projects=core.

How does this skill help with local development?

It provides a 3-terminal workflow strategy: Terminal 1 for core watch-mode, Terminal 2 for Webpack hot-reloading, and Terminal 3 for the API server, ensuring all parts of the simulator sync correctly.

Why is the core-first build principle important?

In the Starwards monorepo, the server, browser, and node-red modules all depend on core logic and types. Building core first ensures that these dependencies are available, preventing 'module not found' errors during compilation.

Starwards Monorepo Workflow

Name: Starwards Monorepo Workflow
Author: starwards

bystarwards

•

游戏开发

Manages npm workspace workflows for the Starwards spaceship simulator by enforcing build order and cross-module dependencies.

The starwards-monorepo skill provides Claude with the specific operational intelligence required to navigate and maintain the Starwards project's four-module npm workspace architecture. It codifies the project's 'core-first' build principle, ensuring that shared game logic and types are compiled before dependent server and browser modules. By formalizing multi-terminal development patterns, watch-mode configurations, and root-level testing strategies, this skill prevents common monorepo pitfalls like stale artifacts and out-of-order execution, significantly speeding up the development of LARP simulator features.

主要功能

01Enforces strict 'core-first' build sequences across all module workspaces

02Automates path alias resolution for @starwards/core across different environments

03Orchestrates multi-terminal dev environments including watch mode and hot-reloading

04Provides standardized troubleshooting for stale build artifacts and dependency mismatches

05Streamlines cross-module testing from core logic to full E2E Playwright suites

0639 GitHub stars

使用场景

01Implementing new game mechanics in core and propagating changes to the UI and server

02Running CI/CD-ready verification commands to ensure workspace integrity

03Setting up complex local development environments with synchronized module watching

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add starwards/starwards starwards-monorepo

For use in Claude.ai and ChatGPT

Download Skill