Skip to content

docs: replace project-context.md with a tracked CLAUDE.md - #163

Merged
JanZachmann merged 2 commits into
omnect:mainfrom
JanZachmann:jz-2026-11-20-track-claude-md
Nov 20, 2026
Merged

JanZachmann merged 2 commits into
omnect:mainfrom
JanZachmann:jz-2026-11-20-track-claude-md

Conversation

@JanZachmann

Copy link
Copy Markdown
Contributor

Summary

  • New tracked CLAUDE.md, built from project-context.md and reduced to what applies only to this repo. project-context.md is removed.
  • Each kept fact was checked against the code. Wrong or outdated facts were dropped or fixed: the Azure SDK fork is no longer a dependency (Device Update has its own REST client in src/device_update/), fdisk is not called by the code, mmd was missing from the tool list, and version numbers and counts are gone.
  • .gitignore: the entries of the old file generator (setup-ai.sh, .user-context.md, CLAUDE.md, GEMINI.md) are removed.
  • Bump the version to 0.29.2.

Before you pull: delete your local generated CLAUDE.md, else git refuses the pull. If you have a CLAUDE.local.md with only @project-context.md, delete it too. GEMINI.md, setup-ai.sh, .github/copilot-instructions.md and .user-context.md are no longer used and no longer ignored; delete them, so that they cannot be committed by mistake.

Reason

The team works with Claude Code only. The generator (setup-ai.sh) that wrote CLAUDE.md, GEMINI.md and the Copilot file from project-context.md is no longer used, so nothing loads project-context.md any more. A tracked CLAUDE.md is loaded by Claude Code by default and everyone gets the same file. Only knowledge of this repo stays in it; general rules (Rust QA, commit format, comment style) come from each developer's own setup. CI tags each merge to main with the Cargo.toml version, so the version is raised.

Not covered

  • A colleague with an old untracked CLAUDE.md gets a refused pull until the file is deleted (see above).
  • CLAUDE.md describes the code as it is now; it has to be kept in line with later changes like any other doc.

Nothing loads project-context.md since the ai-templates generator is
gone. Keep the repo knowledge that is still true as a tracked CLAUDE.md,
which Claude Code loads by default, and drop what the shared team setup
already covers. Remove the generator entries from .gitignore.

Bump the version to 0.29.2.

Signed-off-by: Jan Zachmann 50990105+JanZachmann@users.noreply.github.com
Signed-off-by: Jan Zachmann 50990105+JanZachmann@users.noreply.github.com
@JanZachmann
JanZachmann merged commit d1bcbf0 into omnect:main Nov 20, 2026
2 checks passed
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