server-start

Starts the FOUNDATION dev server via PM2 and reports readiness status.

19|3|Updated Jul 19, 2024
One-click install
npx skills add https://github.com/danielterra/FOUNDATION --skill server-start
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: server-start
Source: https://github.com/danielterra/FOUNDATION/tree/main/.claude/skills/server-start
Command: npx skills add https://github.com/danielterra/FOUNDATION --skill server-start

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates starting the FOUNDATION development server under PM2 when it is not running, ensuring a ready state for development tasks and validation.

Core Features & Use Cases

  • Start the dev server as the PM2 process foundation-dev and verify it is running from the repo root.
  • Perform safety checks to avoid duplicate instances and terminate orphaned processes to prevent port or memory conflicts.
  • Wait for readiness by monitoring logs and report the PID and startup status for reliable verification.

Quick Start

Start the FOUNDATION dev server with PM2 and report readiness.

Frequently Asked Questions about server-start

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a development server with PM2 and verify it is running?

Starting a dev server with PM2 involves performing status checks, terminating obstructions, and launching the ecosystem. The process waits for readiness by monitoring logs and reports the PID and startup status for reliable verification.

Why does PM2 create duplicate instances when I start my dev server?

Duplicate instances occur when orphaned processes are not terminated before startup. The server-start process prevents this by performing safety pre-checks, identifying obstructions, and cleaning up orphaned processes to ensure deterministic startup and avoid port or memory conflicts.

How do I check if my PM2 dev server is ready for QA and validation tasks?

To check if your PM2 dev server is ready for QA, monitor the logs and wait for the readiness verification step to complete. The startup process automates this by waiting for the application to achieve a ready state before reporting the PID and startup status.

Does PM2 handle orphaned process cleanup automatically when starting a dev server?

PM2 startup automation handles orphaned process cleanup by performing safety checks and terminating obstructions before launching the ecosystem. This prevents port or memory conflicts and ensures the dev server starts deterministically without duplicate instances.

What is the best way to ensure deterministic startup for a PM2 managed application?

The best way to ensure deterministic PM2 startup is to perform status checks, terminate obstructions, and clean up orphaned processes before launching the ecosystem. Waiting for readiness verification and reporting the PID guarantees a reliable startup state.

Can I use PM2 to manage a development server for MCP and visual validation?

You can use PM2 to manage a development server for MCP and visual validation by automating the startup process. It handles pre-checks, orphan cleanup, and readiness verification, ensuring the server is up and reporting the PID for reliable task execution.