Senior-dev review pass: reference-projects analysis + improvements #2

Closed
opened 2026-05-19 04:42:46 +00:00 by foravo_admin · 0 comments
Owner

Imported from GitHub issue M00C1FER/mesh-review#12.

Source: https://github.com/M00C1FER/mesh-review/issues/12
Original author: @M00C1FER
Original state: closed


Senior-developer review · improve · commit cycle

Operate as a senior GitHub developer. Make sound engineering judgment calls; do not ask permission for every change. Ship work with conventional-commit-formatted commits and a clean PR.

Workflow

  1. Recon: read README + top-level structure + one core source file end-to-end. Run the existing test suite. Note current state.
  2. Reference search: use gh search repos with relevant keywords to find 3-5 well-rated peers (≥50 stars, MIT/Apache/BSD, recently active). Note one concrete pattern from each in REFERENCES.md at the repo root (commit it).
  3. Improvement list: 3-7 concrete items, categorized as Correctness / Quality / DX / Docs / CI. Skip API-breaking changes unless strongly justified.
  4. Implement: branch copilot/senior-review-2026-05-02. One conventional-commit per logical improvement. Run tests after each commit. Run gitleaks detect --no-banner --redact before push.
  5. PR: structured body with sections: Reference projects studied, Improvements implemented (one bullet per commit), Test results before/after, Known follow-ups. Mark ready-for-review after self-review. Do NOT self-merge.

Hard constraints

  • Email: every commit MUST use 243271903+M00C1FER@users.noreply.github.com. Verify with git config user.email before each commit.
  • Conventional commits: feat:, fix:, docs:, refactor:, test:, chore:, ci:, perf:. Subject ≤72 chars + body explaining WHY.
  • Never force-push, never commit secrets, gitleaks before every push.
  • Don't change public APIs (CLI flags, function signatures, MCP tool names) without strong justification, called out in the PR body.

Specific scope for this repo

Vendor-neutral multi-LLM PR review + summary toolkit. Recently merged: confidence clamping, 95-test suite (#11). Look at: real LLM SDK adapter for the falsifier (replace v0.1 stub), JSON schema for findings (vs current free-text), pre-commit hook integration, comparison against GitButler / aider / continue.dev review patterns.

Stop conditions

  • If you can'''t make the existing test suite pass on main, document in the PR and continue with non-test improvements.
  • If a third-party reference search returns empty / irrelevant, note that and pick best-of-class outside the immediate niche.
  • If you'''ve spent >2 hours without shipping a commit, stop, write what you found in REFERENCES.md, open a PR with that alone, and let the user iterate.
Imported from GitHub issue `M00C1FER/mesh-review#12`. Source: https://github.com/M00C1FER/mesh-review/issues/12 Original author: @M00C1FER Original state: closed <!-- foravo:github-issue:M00C1FER/mesh-review#12 --> --- ## Senior-developer review · improve · commit cycle Operate as a **senior GitHub developer**. Make sound engineering judgment calls; do not ask permission for every change. Ship work with conventional-commit-formatted commits and a clean PR. ## Workflow 1. **Recon**: read README + top-level structure + one core source file end-to-end. Run the existing test suite. Note current state. 2. **Reference search**: use `gh search repos` with relevant keywords to find **3-5 well-rated peers** (≥50 stars, MIT/Apache/BSD, recently active). Note one concrete pattern from each in `REFERENCES.md` at the repo root (commit it). 3. **Improvement list**: 3-7 concrete items, categorized as Correctness / Quality / DX / Docs / CI. Skip API-breaking changes unless strongly justified. 4. **Implement**: branch `copilot/senior-review-2026-05-02`. One conventional-commit per logical improvement. Run tests after each commit. Run `gitleaks detect --no-banner --redact` before push. 5. **PR**: structured body with sections: *Reference projects studied*, *Improvements implemented* (one bullet per commit), *Test results before/after*, *Known follow-ups*. Mark ready-for-review after self-review. Do NOT self-merge. ## Hard constraints - Email: every commit MUST use `243271903+M00C1FER@users.noreply.github.com`. Verify with `git config user.email` before each commit. - Conventional commits: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`, `ci:`, `perf:`. Subject ≤72 chars + body explaining WHY. - Never force-push, never commit secrets, gitleaks before every push. - Don't change public APIs (CLI flags, function signatures, MCP tool names) without strong justification, called out in the PR body. ## Specific scope for this repo Vendor-neutral multi-LLM PR review + summary toolkit. Recently merged: confidence clamping, 95-test suite (#11). Look at: real LLM SDK adapter for the falsifier (replace v0.1 stub), JSON schema for findings (vs current free-text), pre-commit hook integration, comparison against GitButler / aider / continue.dev review patterns. ## Stop conditions - If you can'\''t make the existing test suite pass on `main`, document in the PR and continue with non-test improvements. - If a third-party reference search returns empty / irrelevant, note that and pick best-of-class outside the immediate niche. - If you'\''ve spent >2 hours without shipping a commit, stop, write what you found in REFERENCES.md, open a PR with that alone, and let the user iterate.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
foravo/mesh-review-comment-proof-20260519044241#2
No description provided.