Skip to content

docs: add cross-agent CWL governance guidance to AGENTS.md#62

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

docs: add cross-agent CWL governance guidance to AGENTS.md#62
seonghobae wants to merge 1 commit into
mainfrom
docs/agent-guidance

Conversation

@seonghobae

Copy link
Copy Markdown
Contributor

Summary

Adds an Agent guidance (CWL governance) section to AGENTS.md — the cross-agent convention file readable by any coding agent (Claude, Codex, Cursor, opencode, …), not just Claude. AGENTS.md did not exist, so this creates it with a short repo intro plus the guidance section.

The section distills two org governance conventions and tailors them to this repo:

  • Security & review gate — every PR runs the central Security Scan required gate (osv-scan + dependency-review diff-scoped, trivy-fs repo-wide CRITICAL/HIGH fixable), now including stacked PRs. A failing trivy-fs is a real finding: read the log/SARIF and remediate; don't weaken the gate. Since this is a static site with no package.json/lockfile/Dockerfile/k8s manifests, findings here most likely mean a checked-in secret or committed-config misconfig. Includes the trivy --download-db-only + merge-ref reproduce note, and the reminder that the org code_scanning ruleset is intentionally CodeQL-only (gate by job result, don't add tools to that rule).
  • Code exploration — this repo has no .codegraph/ index, so use normal search; the CodeGraph-first guidance is phrased conditionally for if an index is ever added.

Wrapped in <!-- BEGIN cwl-agent-guidance --> … <!-- END cwl-agent-guidance --> idempotency markers so future runs replace rather than duplicate.

🤖 Generated with Claude Code

Add an "Agent guidance (CWL governance)" section readable by any agent,
distilling the org security-gate and code-exploration conventions and
tailoring them to this static GitHub Pages repo (no package manager,
Dockerfile, k8s manifests, or .codegraph index).

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