3.3 KiB
Developing ReleaseKit
ReleaseKit contains a Go module with the documented root releasekit facade,
adopted policies, and design documents. See the README for
orientation and the product roadmap for proposed
capabilities and implementation sequencing.
Read the agent policy and inspect the worktree before editing. Preserve unrelated changes and follow explicit instructions about commits. The architecture policy governs development boundaries; ADR 0001 records the facade decision. The documentation policy owns the documentation topic map.
Policy Reading Guide
| Policy | Read before… |
|---|---|
| Policy set provenance | Adopting policies, checking upstream revisions, or updating the adopted policy set. |
| Agents | Recommending, planning, or implementing repository changes. |
| Architecture | Planning or changing library or executable code or its structure. |
| Testing | Selecting validation for code changes, or adding, changing, removing, or evaluating tests. |
| Documentation | Writing, revising, or reorganizing documentation. |
| OSS | Adding or updating dependencies or incorporated third-party material, or changing licensing or attribution. |
| Release | Preparing or publishing a release, changing release procedures, or making versioning and compatibility decisions. |
- Read applicable policies before making decisions they govern; multiple policies may apply.
- Select policies using the task triggers above. Follow cross-references to relevant sections when needed to resolve a concrete question.
- Reuse policies already available in context; reread when changed or no longer available.
- Expand reading when the task's scope expands.
- When revising a policy itself, read that policy and any provisions elsewhere affected by the revision.
Validation
Run the offline Go test suite from the repository root with:
go test ./...
Run the compiled public API and dependency-boundary checks from the repository root with:
go run ./internal/apicheck
See the candidate check guide, build consumer guide, internal package inventory, and implementation plan for current implementation progress.
For prose changes, review the diff and check local links, fragment destinations, provenance, template residue, and consistency with current repository contents. Check prose whitespace with:
git diff --check -- '*.md' COPYRIGHT
git diff --cached --check -- '*.md' COPYRIGHT
Verbatim license texts retain their supplied formatting. When changing those texts, compare their bytes with the selected upstream source.
Run the source publication command from the candidate repository root with
./scripts/release VERSION. It uses the local Go toolchain and committed
releasekit.json profile; prepare module dependencies before offline candidate
validation. The maintainer release procedure owns preparation,
publication, and recovery. Executable artifacts and delivery remain outside
ReleaseKit's initial source-only release.