Imported from tylerforgione/hockeysim (
AGENTS.md). Install upstream withnpx skills add tylerforgione/hockeysim. Copyright stays with the author.
Working in HockeySim
Explore and change code
- Before exploring, read domain guidance, then architecture. The existing application is provisional scaffolding; architecture distinguishes current and planned projects.
- Before changing code or dependencies, read conventions and technology stack, including dependency approval policy.
- Before adding tests or validating changes, read testing. Report the commands actually run and distinguish missing tests from passing tests.
Issues and delivery
- Before starting substantive implementation or performing branch, commit, PR, or merge operations, read Git workflow. It defines issue requirements, agent autonomy, and mandatory maintainer review of agent PRs.
- Before tracker operations, read issue tracker. Issues and specs live in GitHub Issues.
- Before assigning triage labels, read triage labels. Use the five documented labels.
Keep decisions current
When work changes an established responsibility or dependency direction, discuss
the change before implementation and update the relevant documentation. Record
resolved domain terminology in CONTEXT.md and consequential architecture
tradeoffs in docs/adr/, following the single-context layout.