docs(rfc): RFC-011 — rename "context" → "profile"#233
Merged
Conversation
"context" (borrowed from kubectl) collides with agent/LLM "context". Rename the named-operator-defaults concept to "profile" (AWS-CLI precedent: --profile, OMNIGRAPH_PROFILE, profiles:). Doc-only — the concept was unshipped. "scope" (the resolved addressing target a profile populates) is unchanged. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Renames the context concept in RFC-011 to profile.
Why
"context" was borrowed from kubectl, but it now collides with agent/LLM
"context" — a real source of confusion. profile is the established term for
"a named, selectable bundle of config defaults" (AWS-CLI precedent:
--profile,AWS_PROFILE,[profile name]), and reads cleanly as--profile prod/OMNIGRAPH_PROFILE/profiles:/profile list|show.Scope
Doc-only — the concept was unshipped (it existed only in RFC-011). No code,
no migration.
scope(the resolved addressing target that a profile populates)is intentionally unchanged — only the named-bundle term is renamed.
All 35 occurrences were the concept (none was prose "in this context"), renamed
case-correctly:
--context→--profile,OMNIGRAPH_CONTEXT→OMNIGRAPH_PROFILE,contexts:→profiles:,current_context→current_profile, headingsContext→Profile.Verification
scripts/check-agents-md.shgreen; all RFC links resolve; zero remaining"context".
🤖 Generated with Claude Code
Greptile Summary
Renames the "context" concept to "profile" throughout RFC-011 and its index entry in
docs/dev/index.md. The concept was unshipped, so this is a pure documentation change with no code or migration impact.--context→--profile,OMNIGRAPH_CONTEXT→OMNIGRAPH_PROFILE,contexts:→profiles:,current_context→current_profile, headings and prose updated throughoutrfc-011-cli-refactoring.md.omnigraph-ts,omnigraph-ui,omnigraph-cookbooks) carry no stale references to the old term, consistent with the feature being unshipped.scopeconcept (the resolved runtime target that a profile populates) is intentionally unchanged.Confidence Score: 5/5
Documentation-only rename of an unshipped concept; no code, config schema, or binary is touched.
Every occurrence of the renamed concept in both changed files has been updated consistently. Related repos carry no stale references. The single prose use of "context" left in
docs/dev/index.md(line 88, "requires that context unless…") is correctly untouched — it is ordinary English, not the renamed concept.No files require special attention.
Important Files Changed
Flowchart
%%{init: {'theme': 'neutral'}}%% flowchart TD A[CLI Command] --> B{Scope resolution} B --> |"--server / --cluster / --store"| C[Primitive address] B --> |"--profile name\nor OMNIGRAPH_PROFILE"| D[Named profile\nin operator config] B --> |"flat defaults"| E[Operator config defaults] C --> F{Capability x Scope} D --> F E --> F F --> |"server scope + any/served"| G["Served path\n(HTTP + Cedar policy)"] F --> |"cluster scope + direct/control"| H["Direct path\n(privileged, bucket creds)"] F --> |"store scope + any/direct"| I["Direct path\n(local-dev / break-glass)"] F --> |"local verb"| J["No graph/scope resolved"]Reviews (1): Last reviewed commit: "docs(rfc): RFC-011 — rename "context" → ..." | Re-trigger Greptile