Project Management Conventions

Tool-agnostic — applies equally to GitHub Issues, Linear issues, and any PR host.

1. Issue Conventions

Title format

• Imperative verb phrase, under 70 chars
• Conventional commit prefix: feat:, fix:, refactor:, docs:, chore:, ci:, perf:, test:
• Example: fix: shell startup hangs when config is missing

Description structure

Four sections — omit any that are empty: