Skip to content

docs: add CWL agent guidance to AGENTS.md#89

Open
seonghobae wants to merge 1 commit into
developfrom
docs/agent-guidance
Open

docs: add CWL agent guidance to AGENTS.md#89
seonghobae wants to merge 1 commit into
developfrom
docs/agent-guidance

Conversation

@seonghobae

Copy link
Copy Markdown

Adds a cross-agent AGENTS.md (readable by Claude, Codex, Cursor, opencode, …) with a tailored Agent guidance (CWL governance) section, wrapped in a <!-- BEGIN/END cwl-agent-guidance --> idempotency marker so future runs replace rather than duplicate.

What's in the section

  • Security & review gate — documents the central required Security Scan (osv-scan + dependency-review diff-scoped, trivy-fs repo-wide CRITICAL/HIGH fixable), that it runs on every PR base including stacked PRs, and that a failing trivy-fs is a real finding to remediate — not disable. Tailored to this repo's actual stack (Shell scripts + YAML templates, no lockfiles/Dockerfile/k8s), so remediation guidance points at misconfig/secret findings and the trivy --download-db-only + merge-ref reproduction flow. Notes the org code_scanning ruleset is intentionally CodeQL-only.
  • Code exploration — no .codegraph/ index exists here, so the guidance says to use normal search, with a conditional note to prefer CodeGraph if an index is added later.

No behavior/code changes — documentation only.

🤖 Generated with Claude Code

Add a tailored "Agent guidance (CWL governance)" section covering the
central Security Scan gate (osv-scan, dependency-review, trivy-fs) and
code-exploration conventions for this Shell/Markdown/YAML plugin repo.
Wrapped in an idempotency marker so re-runs replace rather than duplicate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RTAMs4bpSZS77Xe3RQjv9P
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