Skip to content

docs(contributing): add contributor guide#53

Open
FenjuFu wants to merge 1 commit into
mainfrom
docs/add-contributing-guide
Open

docs(contributing): add contributor guide#53
FenjuFu wants to merge 1 commit into
mainfrom
docs/add-contributing-guide

Conversation

@FenjuFu

@FenjuFu FenjuFu commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

What

Adds a CONTRIBUTING.md. The repository did not have one.

Contents

  • Prerequisites - Go 1.26+ (module targets go 1.26.1), plus the optional golangci-lint and ripgrep dependencies
  • Local setup - make build / make run, and why make run is preferred over calling the binary directly (it frees ports and prepares the runtime dir first)
  • Pre-PR checks - make fmt / tidy / lint / test / vuln, and the build-tagged integration tests that are deliberately excluded from make test
  • Architecture constraints - the one-way Channel -> Router -> Engine -> Provider / Tool dependency direction, plus a table pointing at the real extension points
  • Commit messages - links docs/release-rules.md as the authoritative source rather than restating it, and repeats the essentials, including the existing ban on Co-Authored-By trailers
  • Changelog - when an entry is required and when it is not
  • Support channels and what to include in a bug report

Notes

Paths were taken from the current tree, not from the README's "Project Structure" section - that section is stale (it lists internal/tool/ and internal/skill/, the actual directories are internal/tools/ and internal/skills/). Happy to fix the README separately if useful.

Nothing is claimed about MCP: internal/mcp/ currently holds only a .gitkeep, so there is no behaviour to document yet.

Docs-only change.

Covers prerequisites, make targets for build/test/lint/vuln, the build-tagged
integration tests, the one-way Channel -> Router -> Engine -> Provider/Tool
layering, and points at docs/release-rules.md for commit and changelog rules.
@gemini-code-assist

Copy link
Copy Markdown

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant