docs: tighten oss onboarding and trim legacy cli alias

Author: benvinegar

AGENTS.md

@@ -46,10 +46,10 @@ CLI input
 - `[` and `]` navigate hunks across the full review stream. Do not reintroduce `j`/`k` hunk navigation unless the user asks.
 - Agent context belongs beside the code, not hidden in a separate mode or workflow.
 - Agent notes are hunk-specific: show notes for the selected hunk, render them in the diff flow near the annotated row, and keep a clear spatial relationship to the code they explain.
-- When making code changes in this repo, also refresh `.hunk/latest.json` so the next review can load agent rationale with `hunk git --agent-context .hunk/latest.json`.
+- When making code changes in this repo, also refresh `.hunk/latest.json` so the next review can load agent rationale with `hunk diff --agent-context .hunk/latest.json`.
 - Keep `.hunk/latest.json` concise and review-oriented: one changeset summary, file summaries in narrative order, and a few hunk-level annotations with real rationale.
 - File order in `.hunk/latest.json` is intentional, but the visible note UI should stay hunk-note driven rather than showing generic file or changeset explainer cards.
-- If newly created files should appear in `hunk git` before commit, use `git add -N <paths>` so they show up in the review stream without staging content.
+- If newly created files should appear in `hunk diff` before commit, use `git add -N <paths>` so they show up in the review stream without staging content.
 
 ## commands
 

CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing
+
+Thanks for contributing to Hunk.
+
+## Before you open a PR
+
+- open an issue or discussion first for large behavior or UX changes
+- keep PRs focused
+- include tests for parser, CLI, or rendering changes where practical
+- update `README.md` when the public workflow changes
+- refresh `.hunk/latest.json` for local review context when you change code
+
+## Development setup
+
+```bash
+git clone https://github.com/modem-dev/hunk.git
+cd hunk
+bun install
+```
+
+Run from source:
+
+```bash
+bun run src/main.tsx -- diff
+```
+
+## Validation
+
+For most changes, run:
+
+```bash
+bun run typecheck
+bun test
+```
+
+For rendering or terminal interaction changes, also run:
+
+```bash
+bun run test:tty-smoke
+```
+
+If you touch packaging or release-related files, also run:
+
+```bash
+bun run build:npm
+bun run check:pack
+```
+
+## Pull request checklist
+
+- [ ] scope is focused
+- [ ] tests or rationale added for behavior changes
+- [ ] `bun run typecheck` passes
+- [ ] `bun test` passes
+- [ ] `README.md` updated if the CLI or install flow changed
+
+## Design notes
+
+Hunk is review-first:
+
+- the main pane is a single multi-file review stream
+- the sidebar is navigation, not a single-file mode switcher
+- split and stack views come from the same normalized diff model
+- agent notes should stay attached to the code they explain
+
+## Code of conduct
+
+Be respectful, assume good intent, and focus review on the code and user impact.