Skip to content

CLAUDE.md: compot images are not published; equivalents from ci/ - #41

Merged
compot-dev merged 1 commit into
mainfrom
docs/claude-md-images
Oct 17, 2026
Merged

compot-dev merged 1 commit into
mainfrom
docs/claude-md-images

Conversation

@compot-dev

Copy link
Copy Markdown
Collaborator

Follow-up to #40. compot/cross and compot/android are built on a maintainer's machine and are not published. Each command that uses them now has an equivalent built from the repository's own ci/Dockerfile.native, ci/Dockerfile.cross or ci/Dockerfile.android, the same images CI uses. The layout now matches cerberus's CLAUDE.md.

Documentation only.

Tested on main e8dc7cf:

  • vtesse-ci-native (ci/Dockerfile.native): make test, 63 checks, 0 failures.
  • An image built from ci/Dockerfile.cross with TOOLCHAIN_CACHE=/opt/tc: QEMU=1 ci/build-musl.sh arm32, 62 checks, 0 failures.
  • android/build.sh without VTESSE_ANDROID_IMAGE is the CI path itself (the Android APK job).

Every compot command now has its equivalent built from the repository's
own ci/Dockerfile.native, ci/Dockerfile.cross or ci/Dockerfile.android,
the images CI uses. Same layout as cerberus's CLAUDE.md.
@qodo-free-for-open-source-projects

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

Tip of the day
💡 Did you know, you can see how risky a PR is at a glance with blast radius labels

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Grey Divider

Qodo Logo

@qodo-free-for-open-source-projects

Copy link
Copy Markdown

PR Summary by Qodo

Document Docker alternatives to unpublished compot images

📝 Documentation 🕐 Less than 10 minutes

Grey Divider

AI Description

• Explain that compot images are unpublished and document repository-based alternatives for local
 builds.
• Cover native tests, musl cross-builds, and Android APK builds.
• Warn against host builds that leave host-built artifacts.
Diagram

graph TD
  Guide["CLAUDE.md"] --> Native["Native Dockerfile"] --> Tests["Native tests"]
  Guide --> Cross["Cross Dockerfile"] --> Musl["Musl builds"]
  Guide --> Android["Android build script"] --> AndroidImage["Android Dockerfile"] --> APK["Android APKs"]
Loading
High-Level Assessment

Keep the maintainer's compot examples alongside repository-based alternatives. This preserves the existing workflow while making the checks accessible elsewhere; removing the compot examples would simplify the guide but discard useful maintainer instructions.

Files changed (1) +19 / -9

Documentation (1) +19 / -9
CLAUDE.mdDocument compot-free local build paths +19/-9

Document compot-free local build paths

• Explains that compot images are unpublished and points native, musl/QEMU, and Android commands to repository Dockerfiles or the Android build script. Clarifies cross-toolchain cache behavior and warns that building on the host leaves host-built objects.

CLAUDE.md

@compot-dev
compot-dev merged commit 5b37a29 into main Oct 17, 2026
9 checks passed
@compot-dev
compot-dev deleted the docs/claude-md-images branch October 17, 2026 00:19
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