Guidance Repository Coding Standards & Review Guidelines

Overview

This skill defines the architectural principles, coding conventions, and PR review standards for the modern-web-guidance-src repository.

Follow these guidelines whenever authoring TypeScript, JavaScript, CLI commands, harness utilities, server endpoints, or dashboard code.

PR Scope and Modularity

Keep PRs Focused and Single-Purpose

• Split multi-component features: Do not combine backend data models, CLI tools, and frontend UI changes into a single monolithic PR.
• Logical progression: Structure larger features into small, stacked, or sequential PRs:
  1. Data layer / core libraries (parsing, normalization, abstractions)
  2. CLI workflows and execution commands
  3. UI / visualization components and dashboard views
• Smaller, well-scoped PRs are easier to review, test, and safely revert if regressions occur.