القائمة
Use when making any code change to this repo. Covers the full edit-lint-build-test loop with exact commands. Examples: 'implement this feature', 'fix this bug', 'add a new package'.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Create a new GitHub release with version tag and release notes. Determines the next version, verifies main, tags, and creates a GitHub release. Examples: 'create a release', 'release v0.15.0', 'cut a new version'.
Pick up a GitHub issue and implement it end-to-end. Reads the issue, creates a branch, implements the fix/feature, verifies, and creates a PR. Examples: 'pickup issue #67', 'work on issue 55', 'grab that issue'.
Ship changes by creating a pull request. Runs verification first, then pushes and creates PR with repo conventions. Examples: 'create a PR', 'open a pull request', 'ship this'.
Local CI mirror. Run all checks that CI runs before pushing. Use before creating a PR or when you want to validate your changes match CI. Examples: 'verify my changes', 'run CI checks locally', 'check if this will pass CI'.
| name | implement |
| description | Use when making any code change to this repo. Covers the full edit-lint-build-test loop with exact commands. Examples: 'implement this feature', 'fix this bug', 'add a new package'. |
Foundation for any code change in luthersystems/svc. Follow this loop for every change.
*_test.go) to understand testing patterns# Branch from main, use username/Description format
git checkout main && git pull
git checkout -b sam-at-luther/Short_description
// Copyright © <year> Luther Systems, Ltd. All right reserved.oracle/testservice/gen/# Format
gofmt -w .
# Lint (matches CI — gosec enabled)
golangci-lint run
Fix any lint issues before proceeding. The gosec linter is enabled — pay attention to security findings.
go build ./...
# Run tests for the changed package
go test -timeout 10m ./your-package/...
# Run the full test suite
go test -timeout 10m ./...
If working on oracle/ tests, the substrate plugin must be available:
# Download the plugin (only needed once)
./scripts/obtain-plugin.sh
# Or via make
make plugin
If your change adds a new public API, verify it with a simple test. If modifying behavior, write a test that captures the expected behavior first (TDD).
testify for assertions in tests (existing pattern in codebase)svcerr package maps errors to gRPC status codes — use it for error handlinggrpclogging.AddLogrusField(ctx, key, value) for structured loggingSUBSTRATEHCP_FILE env var pointing to the plugin binary (set by Makefile)go build ./...)golangci-lint run)go test -timeout 10m ./...)