From b80f1eca1d06678d20d790f37c008197febd9ab6 Mon Sep 17 00:00:00 2001
From: Vladimir Berezniker <1155690+vmpn@users.noreply.github.com>
Date: Sun, 26 Apr 2026 13:56:33 -0400
Subject: [PATCH] docs(basecamp): cross-reference Agent Invariants from CLI
 Introspection
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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.
---
 skills/basecamp/SKILL.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/skills/basecamp/SKILL.md b/skills/basecamp/SKILL.md
index d1d2208..956b9d5 100644
--- a/skills/basecamp/SKILL.md
+++ b/skills/basecamp/SKILL.md
@@ -126,6 +126,8 @@ basecamp todos --agent --help
 
 Walk the tree: start at `basecamp --agent --help` for top-level commands, then drill into any subcommand. Commands include `notes` with domain-specific agent hints (e.g., "Cards do NOT support --assignee filtering").
 
+Note: persistent global flags from the Agent Invariants (e.g. `--jq`, `--agent`, `--styled`, `--verbose`) are listed only at the root (`basecamp --agent --help`) and won't show up in a subcommand's `inherited_flags`. They still apply on every subcommand.
+
 ### Pagination
 
 ```bash