docs(basecamp): cross-reference Agent Invariants from CLI Introspection#3
docs(basecamp): cross-reference Agent Invariants from CLI Introspection#3vmpn wants to merge 1 commit intobasecamp:mainfrom
Conversation
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
There was a problem hiding this comment.
Pull request overview
Updates the Basecamp skill documentation to clarify that persistent/global CLI flags are only listed in the root basecamp --agent --help output and may not appear under each subcommand’s inherited_flags, even though they still apply.
Changes:
- Add a note in the “CLI Introspection” section explaining why global flags might be missing from per-subcommand help output and where to find the canonical list.
Tip
If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Persistent flags called out in the Agent Invariants ("Never pipe to
external jq — use --jq instead", etc.) are documented only at the
root (`basecamp --agent --help`) and don't appear in per-subcommand
`inherited_flags`. Adds a one-sentence footnote at the end of the
CLI Introspection section noting this, so an agent inspecting a
subcommand's help doesn't conclude a global flag is unsupported.
Pure docs change — no behavior change.
vmpn
force-pushed
the
docs/global-flags-note
branch
from
3005ae6 to
b80f1ec
Compare
vmpn
changed the title
inherited_flagsThere was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Summary
Adds a one-sentence footnote at the end of the CLI Introspection section of
skills/basecamp/SKILL.md, noting that persistent global flags called out in the Agent Invariants rules (--jq,--agent,--styled,--verbose, …) are documented only at the root (basecamp --agent --help) and won't appear in a subcommand'sinherited_flags. They still apply on every subcommand.Why
Agent Invariant rule #1 already prescribes "Never pipe to external
jq— use--jqinstead". An agent following that rule will use--jqregardless of what<subcommand> --helpshows. But an agent that inspects per-subcommand help to confirm the flag is supported can incorrectly conclude it isn't, becauseinherited_flagsdoesn't list root-level persistent flags. This footnote closes that discoverability gap by cross-referencing back to the Invariants.Pure docs change — no behavior change.
Test plan
skills/basecamp/SKILL.mdis touched (+2 lines)Created with assistance of AI agent with human review.