Skip to content

feat: CLI-first discovery, context verification (show whoami; confirm unless clear match)#14

Merged
leggetter merged 4 commits intomainfrom
feat/agent-cli-first-discovery
Feb 27, 2026
Merged

feat: CLI-first discovery, context verification (show whoami; confirm unless clear match)#14
leggetter merged 4 commits intomainfrom
feat/agent-cli-first-discovery

Conversation

@leggetter
Copy link
Collaborator

Summary

Agent-skills updates for CLI-first discovery and org/project context verification.

Changes

  • Context verification: Always run hookdeck whoami and show the user the output. Ask for explicit confirmation unless the user has very clearly identified the organization and project (e.g. "use prod org, default project") and whoami shows an exact match. (SKILL.md, cli-workflows.md, monitoring-debugging.md)
  • CLI reference: AGENTS.md and references use per-command .md URLs for docs discovery; note that /docs/cli is the full HTML reference.
  • Ref→ref: One-hop ref→ref allowed for workflow/see-also; some links replaced with live doc links (connection-rules, 04-iterate).
  • Capability summaries: Reasonable summaries + link to canonical reference; checklist items in AGENTS.md.
  • Resources: Explicit list (sources, destinations, connections, transformations) and org/project definitions with link to Projects docs.

Checklist

  • SKILL.md under 500 lines
  • Terminology and request→event→attempt order
  • Live doc links inline

Made with Cursor

AGENTS.md:
- Clarify ref→ref: one-hop for workflow/see-also OK; avoid long chains
- Shorten commands/options guidance; add checklist item for capability
  summaries + link to canonical reference
- Add spec checklist item for ref→ref rule

event-gateway:
- SKILL: Workflow Stages (getting started), Quick Start→Stages link,
  Resources row (sources, destinations, connections, transformations)
- monitoring-debugging: drop api-patterns ref→ref; CLI links use .md
  URLs; add metrics to Documentation list
- cli-workflows: CLI doc links use .md URLs; note per-command as Markdown
- connection-rules: bulk replay → live API docs (Bulk, Inspect)
- 04-iterate: API patterns → live API docs; keep referencing-docs link

Made-with: Cursor
… identified org/project and exact match

- SKILL.md: numbered steps for context verification; step 2 asks for confirmation unless user clearly identified org/project and whoami matches. Workflow callout and Dev & Ops table updated.
- cli-workflows.md: verify before queries/metrics; always show whoami output; ask to confirm unless clear user-specified match.
- monitoring-debugging.md: checklist adds 'show output' and 'confirm unless clear match'; common mistake updated.

Made-with: Cursor
…ng to API Patterns for common uses and providing a more comprehensive overview of API documentation references.
@leggetter leggetter merged commit e6e16d7 into main Feb 27, 2026
7 checks passed
@leggetter leggetter deleted the feat/agent-cli-first-discovery branch February 27, 2026 12:34
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