Skip to content

docs: fix CLAUDE.md drift (local paths, release versions, NASA proposal location); GitHub identity section moved to the org-folder CLAUDE.md - #8

Merged
577-Industries merged 1 commit into
mainfrom
docs/claude-md-drift-20260820
Aug 21, 2026
Merged

docs: fix CLAUDE.md drift (local paths, release versions, NASA proposal location); GitHub identity section moved to the org-folder CLAUDE.md#8
577-Industries merged 1 commit into
mainfrom
docs/claude-md-drift-20260820

Conversation

@577-Industries

Copy link
Copy Markdown
Collaborator
  • §4/§8: local checkout path is now 577Industries-github/helios//; the
    workspace-root .worktrees line is gone (neither directory exists)
  • §0/§3: release versions re-read from git describe --tags on 2026-08-20
    (program v0.3.0, provenance-spec v0.1.0, connectors v0.2.1, fusion-engine
    v0.2.0, gannon v0.1.0); git tag / gh release list declared authoritative;
    the stale snapshot status line is removed
  • §7: canonical .docx and final PDF now point into the private
    sbir-nasa-helios-proposal repo; dead plaintext-extraction pointer removed
  • §2: replaced with a 3-line pointer to the org-folder CLAUDE.md; the
    git tag --quiet gotcha stays here because it is HELIOS-specific
  • §9: memory directory annotated as named for a path that no longer exists
  • §5 and §10 unchanged

Co-Authored-By: Claude Fable 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01JjMK2TTNR4UZDRxDPPorzK

…al location); GitHub identity section moved to the org-folder CLAUDE.md

- §4/§8: local checkout path is now 577Industries-github/helios/<repo>/; the
  workspace-root .worktrees line is gone (neither directory exists)
- §0/§3: release versions re-read from git describe --tags on 2026-08-20
  (program v0.3.0, provenance-spec v0.1.0, connectors v0.2.1, fusion-engine
  v0.2.0, gannon v0.1.0); git tag / gh release list declared authoritative;
  the stale snapshot status line is removed
- §7: canonical .docx and final PDF now point into the private
  sbir-nasa-helios-proposal repo; dead plaintext-extraction pointer removed
- §2: replaced with a 3-line pointer to the org-folder CLAUDE.md; the
  git tag --quiet gotcha stays here because it is HELIOS-specific
- §9: memory directory annotated as named for a path that no longer exists
- §5 and §10 unchanged

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JjMK2TTNR4UZDRxDPPorzK

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 92819901ba

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread CLAUDE.md

**git tag**: in this gh CLI version, `git tag -a` does **not** accept `--quiet`. Omit that flag or you'll silently fail to create the tag (and any subsequent `git push origin <tag>` will fail). If `gh release create <tag>` is run afterward, it will create the tag implicitly — so things sometimes appear to work anyway, but the local tag will be missing.
- **Org = `577Industries`** (no hyphen) owns every HELIOS repo; **user = `577-Industries`** (with hyphen) is the `gh` login and an org member. **Never create repos under the user** — always `gh repo create 577Industries/<name> ...`.
- Full rules, token scopes, the user→org transfer command and the visibility-flip fallback live in the org-folder instructions: `../../CLAUDE.md` (= `/home/twawe/577i-Projects/577Industries-github/CLAUDE.md`). Read that file once per session; do not re-derive the rules here.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep the identity instructions accessible to fresh clones

For anyone using the canonical git clone --recurse-submodules workflow documented below—or browsing this repository on GitHub—../../CLAUDE.md is outside the repository, while the absolute /home/twawe/... path exists only on the operator's machine. Those sessions therefore cannot follow the onboarding requirement to read the full identity, token-scope, transfer, and visibility rules that this commit removes from the tracked file. Keep the critical rules here or link to a version-controlled location that every supported checkout can access.

Useful? React with 👍 / 👎.

@577-Industries
577-Industries merged commit aeb0739 into main Aug 21, 2026
3 checks passed
@577-Industries
577-Industries deleted the docs/claude-md-drift-20260820 branch August 21, 2026 01:17
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