// Contribute safely to the AXONE axoned repository. Use when changing Go code, proto files, generated docs, predicate logic, tests, CI workflows, release plumbing, or local chain behavior in this repo. Applies the repo's validation steps, generation commands, and contributor-specific gotchas before finalizing changes.
Design and evolve protobuf APIs for this repository. Use when creating or changing files under proto/, or when shaping the Go implementation that follows from a proto contract. Focuses on API specification first, with repo-specific conventions plus Cosmos SDK, gRPC, and protobuf compatibility rules.
Add or change predicates in the AXONE logic module. Use when working on x/logic predicate behavior, Prolog libraries, predicate docs, VFS-backed logic capabilities, or feature scenarios. Follows the current architecture direction: new predicates should be written in Prolog, either pure Prolog or Prolog backed by the path-based logic VFS, not as new native Go predicates.
| name | axone-contributor-workflow |
| description | Contribute safely to the AXONE axoned repository. Use when changing Go code, proto files, generated docs, predicate logic, tests, CI workflows, release plumbing, or local chain behavior in this repo. Applies the repo's validation steps, generation commands, and contributor-specific gotchas before finalizing changes. |
| compatibility | Requires git, go, make, and docker. Node is only needed when validating generated markdown for MDX compatibility. |
Use this skill for routine contribution work in this repository. It is the default workflow for changes under app/, cmd/, proto/, scripts/, x/**, docs/, Makefile, and .github/workflows/.
make targets as the only validation interface.make targets could apply, prefer the broader one.make lint-go and make test-go.make proto.make doc-command.make doc-predicate and make test-go.make mock.make build-go.
For local chain validation, use make chain-init, make chain-start, and make chain-stop.
For upgrade work, use make chain-upgrade FROM_VERSION=... TO_VERSION=....docs/: run the relevant generation target from Makefile. CI will additionally check MDX compatibility.testify, ginkgo, and gomega are forbidden.gofumpt is mandatory, but the correct entrypoint is still make lint-go.make doc-command rewrites machine-specific defaults in generated markdown. Do not hand-edit those outputs afterward.make proto-gen copies generated code back from github.com/axone-protocol/axoned/* into the repo root. Inspect the diff after regeneration.make build-go-all is host-limited and can fail on cross-compilation mismatches. Prefer make build-go.make chain-stop runs killall axoned.Makefile.github/workflows/lint.yml.github/workflows/test.yml.golangci.ymlREADME.mdFor subsystem-specific work, also read the closest source and generator entrypoints:
scripts/generate_predicates_doc.goscripts/generate_command_doc.goscripts/protocgen-code.sh and scripts/protocgen-doc.shapp/upgrades.gogit status --short contains only intended files.go.mod or go.sum changed, they were updated intentionally and are tidy.