Skip to content

docs: add shared operational memory under .claude/memory#678

Open
ecv wants to merge 1 commit into
mainfrom
docs/shared-operational-memory
Open

docs: add shared operational memory under .claude/memory#678
ecv wants to merge 1 commit into
mainfrom
docs/shared-operational-memory

Conversation

@ecv

@ecv ecv commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a version-controlled .claude/memory/ directory holding the public,
repo-portable
subset of operational knowledge for working on this repo with
Claude Code (or any agent). One file per fact, indexed by MEMORY.md.

Opened as a draft for review of both the selection and whether this belongs
in-tree.

What's included

File Why it's here
gh-issue-body-file.md Use --body-file not a --body heredoc so code fences render
github-sub-issues-via-graphql.md Sub-issues have no native gh command; use the addSubIssue GraphQL mutation
pull-main-on-switch.md Always git fetch + pull --ff-only on switching to main
unattended-loop-permission-discipline.md How to run a hands-off /loop with zero permission prompts
activity-policies-owned-by-source-repos.md This repo owns its own ActivityPolicy CRs under config/services/activity/policies/, shipped via an OCI bundle — plus the recurring unguarded-responseObject DLQ-leak pattern

What's deliberately excluded

Operational notes that are environment-specific or sensitive were left out:
prod alert-triage and incident catalogues, access-control internals, Flux/gateway
production incidents, e2e project IDs and gitignored values files, and
deploy-repo Flux paths. Nothing here contains credentials, cluster names,
project IDs, or internal-only incident detail.

Notes

🤖 Generated with Claude Code

Version-controlled, repo-portable operational notes for working on this
repo with Claude Code: gh tooling habits, git hygiene, unattended-loop
permission discipline, and the activity-policy ownership model.

These are the public, non-sensitive subset of operating knowledge —
no credentials, cluster names, project IDs, or internal incident detail.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ecv ecv requested review from drewr, kevwilliams and scotwells June 30, 2026 00:43
@ecv

ecv commented Jun 30, 2026

Copy link
Copy Markdown
Contributor Author

Considering this in a public repo. RFC.

@ecv ecv marked this pull request as ready for review June 30, 2026 01:44
@ecv ecv enabled auto-merge June 30, 2026 20:13
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