arklabshq/arkd-makefile-ref
skills/arkd-makefile-ref/SKILL.md
Quick reference for arkd Makefile targets. Use before building, generating code, or running linters. Covers proto generation, build, sqlc, lint, and explains why make test must NEVER be used.
$ install --global
skillsauthnpx skillsauth add arklabshq/arkadian arkd-makefile-refInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 29, 2026, 5:23 AM337.8s1 file scanned
SKILL.md
- name:
- arkd-makefile-ref
- description:
- Quick reference for arkd Makefile targets. Use before building, generating code, or running linters. Covers proto generation, build, sqlc, lint, and explains why make test must NEVER be used.
arkd Makefile Quick Reference
Common Makefile targets for the arkd project at ${ARKD_REPO}.
Safe Targets
| Target | What it does | When to use |
|--------|-------------|-------------|
| make proto | Lint protos + generate Go code via buf generate | After changing .proto files |
| make build | Build arkd binary via scripts/build-arkd | Before testing locally |
| make sqlc | Generate Go code from SQL queries | After changing SQL in queries/ |
| make lint | Run golangci-lint | Before finalizing changes |
| make clean | Remove build artifacts | When build state is stale |
| make run-light | Run arkd in light mode (sqlite, no PG/Redis) | Local dev iteration |
| make run | Run arkd in full mode (PG + Redis) | When testing PG-specific code |
| make run-wallet | Start arkd-wallet + Docker deps (pg, nbxplorer) | Before running arkd |
NEVER Use These Targets
| Target | Why |
|--------|-----|
| make test | Starts ark-pg-test container on port 5432 which conflicts with pgnbxplorer from make run-wallet. Use individual go test commands instead. |
| make integrationtest | Runs the FULL e2e suite which is slow (~15-20 min) and has the same port conflict. Only use for final verification if no other infrastructure is running. |
Individual Test Commands (Use These Instead)
# Run a specific test
go test -v -count=1 -run TestFunctionName -timeout 800s github.com/arkade-os/arkd/internal/test/e2e
# Run a specific sub-test
go test -v -count=1 -run "TestParent/sub_test_name" -timeout 800s github.com/arkade-os/arkd/internal/test/e2e
# Run unit tests for a specific package (no infra needed)
go test -v ./internal/core/application/...
# Run unit tests for a specific file pattern
go test -v ./internal/core/domain/...
Proto Generation Details
make proto runs:
buf lint— validates proto filesbuf generate— generates Go code from protos (via Docker)
If proto generation fails, check:
- Docker is running
.protofiles have valid syntaxbuf.gen.yamlconfig is correct
Do NOT run Docker buf commands manually — always use make proto.
Build Details
make build runs scripts/build-arkd which:
- Compiles the arkd binary with proper build flags
- Output:
build/arkd
For quick iteration, you can also use go build ./cmd/arkd directly.
Related Skills
arklabshq/update-project
documentation
VerifiedTrustedCommunity
Update project documentation based on new commits and changes in the repository. Use when: user wants to sync docs after project changes.
3SKILL.mdUpdated Apr 29, 2026
arklabshq/remove-project
testing
VerifiedTrustedCommunity
Remove a project from the Arkadian documentation registry and delete all associated documentation files. Use when: user wants to deregister a project.
3SKILL.mdUpdated Apr 29, 2026
arklabshq/pm-tasks
tools
VerifiedTrustedCommunity
RESTRICTED to ark-project-manager. Generate actionable, dependency-ordered task lists organized by user story.
3SKILL.mdUpdated Apr 29, 2026
arklabshq/pm-spec
testing
VerifiedTrustedCommunity
RESTRICTED to ark-project-manager. Create or update feature specifications from natural language descriptions.
3SKILL.mdUpdated Apr 29, 2026