Skip to content

Ways of Working#

Shared conventions for how work happens across the PSModule ecosystem — for humans and agents alike.

This section documents the principles, processes, and norms that every contributor follows. Whether you're opening an issue, writing a commit message, reviewing a pull request, or planning a feature — the answer is here.

What's covered#

  • Workflow — How work flows from idea to delivery and back again. The phases, the loop, and how they connect.
  • Principles — The foundational beliefs and product mindset that drive every decision.
  • Goal-Setting Framework — Mission, OKRs, and Initiatives — how strategic direction connects to work in repositories.
  • Issue Format — The three-section issue structure, formatting rules, and labels.
  • Issue Hierarchy — Epic / PBI / Task — the three operational levels tracked via GitHub sub-issues.
  • PR Format — Pull request title, description, change types, and labels.
  • Commit Conventions — How we write commit messages.
  • Review Etiquette — Tone, scope, severity prefixes, and how to disagree well.
  • Git Worktrees — Bare-clone + worktree layout for parallel, conflict-free development.
  • README-Driven Context — Why the README is the front door and the source of truth.

Who this is for#

Everyone. If you contribute to a PSModule project — by code, review, issue, or discussion — these are the norms you follow. Agents follow them too; they read these pages as context before acting.