Skip to content

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

Merged
seonghobae merged 7 commits into
masterfrom
docs/agent-guidance
Jul 10, 2026
Merged

docs: add CWL agent guidance to AGENTS.md#117
seonghobae merged 7 commits into
masterfrom
docs/agent-guidance

Conversation

@seonghobae

@seonghobae seonghobae commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Stacks the CWL agent guidance block after #93's minimal Product Design/Figma guardrail so AGENTS.md no longer conflicts when #93 merges first.

Current scope:

  • preserves docs(AGENTS): keep Figma guidance minimal #93's no-frontend-without-real-surface guidance
  • adds a concise CWL governance block for central Security Scan, Trivy handling, CodeQL-only code scanning, code exploration, ecosystem role, and research grounding
  • updates the Trivy openssl-doc key note to reference the existing path-scoped .trivyignore.yaml suppression instead of presenting it as an active blocker
  • keeps paper PDFs conditional on redistribution permission; otherwise cite, link, and summarize

No R behavior, calibration/linking logic, workflows, or frontend code changed.

@opencode-agent

opencode-agent Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

OpenCode Review Overview

  • Head SHA: a162e47b8e775dbdc66a64f1426465ef44fdd2d4
  • Workflow run: 29063915873
  • Workflow attempt: 1
  • Gate result: APPROVE (approval step)

Pull request overview

OpenCode reviewed the current-head bounded evidence and found no blocking issues.

Findings

No blocking findings.

Summary

Approval sufficiency: bounded evidence supplied affirmative approval evidence for changed files, coverage/docstring posture, risk surfaces, and current-head verification; approval is not based merely on the absence of known blockers.
Verification posture: CodeGraph evidence was initialized and bounded current-head evidence reviewed for changed-file evidence including AGENTS.md.
Linter/static: workflow/static review evidence is bounded by the current-head GitHub Checks gate and changed-file evidence.
TDD/regression: coverage execution evidence and focused changed hunks were reviewed from bounded-review-evidence.md.
Coverage: coverage execution evidence reports test coverage as not applicable because no supported changed source files or package manifests were found.
Docstring coverage: coverage execution evidence reports docstring coverage as not applicable because no supported changed source files or package manifests were found.
DAG: CodeGraph/source-backed behavior map connects AGENTS.md to the affected review, runtime, or workflow path and required checks.
PoC/execution: coverage-evidence job executed on the current head and reported PASS.
DDD/domain: workflow and repository-governance invariants were reviewed against changed files in bounded evidence.
CDD/context: CodeGraph evidence, changed-file history, and focused hunks were reviewed from bounded-review-evidence.md.
Similar issues: changed-file history evidence was reviewed for comparable local precedents.
Claim/concept check: bounded evidence, repository source, current-head workflow evidence, and, where numeric, scientific, statistical, or literature-backed claims are affected, original-paper/formula evidence and parameter-recovery expectations were used for claims.
Standards search: standards and external-source checks are delegated to configured OpenCode web_search/Context7/DeepWiki sources when applicable; no evidence-backed standards blocker is present in bounded evidence.
Compatibility/convention: changed workflow/script conventions, object naming, and reserved-word safety for schema/API/config/code surfaces were checked in bounded evidence.
Breaking-change/backcompat: deployment evidence and changed-file history were checked for backward-compatibility risk.
Performance: changed surfaces were checked for performance risk in bounded evidence.
Developer experience: changed automation, review, test, setup, and maintenance surfaces were checked for helpful or obstructive DX impact in bounded evidence.
User experience: connected user, operator, API, CLI, documentation, review-comment, status-check, rendering, and workflow-reader behavior was checked for contradictions against code, docs, and tests in bounded evidence.
Visual/DOM: Playwright visual, DOM locator, ARIA snapshot, console, and responsive evidence were checked when a web UI surface was present; for non-web surfaces, API/CLI/log/docs/workflow interaction evidence was reviewed instead.
Accessibility/i18n: accessibility, localization, and human-readable text surfaces were checked where UI, CLI, API message, docs, logs, or review text changed.
Supply-chain/license: dependency, package, model, container, and external-tool changes were checked in bounded evidence.
Packaging: package, build, test, lint, and security contracts were checked in bounded evidence.
Security/privacy: workflow-token, review-gate, and repository-automation security/privacy boundaries were checked in bounded evidence.

  • Result: APPROVE
  • Reason: Documentation-only change with no executable impact
  • Head SHA: a162e47b8e775dbdc66a64f1426465ef44fdd2d4
  • Workflow run: 29063915873
  • Workflow attempt: 1

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file: AGENTS.md"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file: AGENTS.md"]
  R1 --> V1["required checks"]
Loading

@seonghobae seonghobae force-pushed the docs/agent-guidance branch from 73c2ddf to 23b8203 Compare July 9, 2026 07:32
@seonghobae seonghobae force-pushed the docs/agent-guidance branch from 23b8203 to d574404 Compare July 9, 2026 07:39
@seonghobae

Copy link
Copy Markdown
Collaborator Author

Order-safe local validation for the current #117 head.

Current #117 head tested: d574404d591223a1475336afb7fc0f0c6a598ebb.

Stack tested: origin/master + #93 + #108 + #111 + #113 (4f38215) + #115 + #117.

Notes:

Validation results from the disposable stack worktree:

  • git diff --check origin/master...HEAD: clean.
  • R CMD INSTALL . with local R 4.4.1: DONE (aFIPC).
  • Full testthat::test_dir('tests/testthat'): FAIL 0 | WARN 0 | SKIP 0 | PASS 35.
  • Exact markdownlint command used by CI: 14 files linted, 0 error(s).

Design/Figma scope check: this repository is still an R package with no frontend/visual surface, so no UI or Figma artifact is warranted for this PR.

This is validation evidence only; merge still needs the required current-head checks and non-stale approval path.

@seonghobae

Copy link
Copy Markdown
Collaborator Author

Order-safe validation for #117 on the current prepared queue stack.

Current #117 head tested: d574404d591223a1475336afb7fc0f0c6a598ebb.

Local stack tested:

Result:

Validation:

  • git diff --check origin/master...HEAD: clean.
  • npx --yes markdownlint-cli2@0.18.1 README.md AGENTS.md ARCHITECTURE.md CLAUDE.md CONTRIBUTING.md .github/**/*.md docs/**/*.md: 14 files linted, 0 errors.
  • C:\Program Files\R\R-4.4.1\bin\R.exe CMD INSTALL .: DONE (aFIPC).
  • C:\Program Files\R\R-4.4.1\bin\Rscript.exe -e testthat::test_dir('tests/testthat'): FAIL 0 | WARN 0 | SKIP 0 | PASS 34.

The existing OpenCode approval comment is still for older head 410f00e, so #117 still needs the required current-head GitHub checks/review path before merge.

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode reviewed the current-head bounded evidence and found no blocking issues.

Findings

No blocking findings.

Summary

Approval sufficiency: bounded evidence supplied affirmative approval evidence for changed files, coverage/docstring posture, risk surfaces, and current-head verification; approval is not based merely on the absence of known blockers.
Verification posture: CodeGraph evidence was initialized and bounded current-head evidence reviewed for changed-file evidence including AGENTS.md.
Linter/static: workflow/static review evidence is bounded by the current-head GitHub Checks gate and changed-file evidence.
TDD/regression: coverage execution evidence and focused changed hunks were reviewed from bounded-review-evidence.md.
Coverage: coverage execution evidence reports test coverage as not applicable because no supported changed source files or package manifests were found.
Docstring coverage: coverage execution evidence reports docstring coverage as not applicable because no supported changed source files or package manifests were found.
DAG: CodeGraph/source-backed behavior map connects AGENTS.md to the affected review, runtime, or workflow path and required checks.
PoC/execution: coverage-evidence job executed on the current head and reported PASS.
DDD/domain: workflow and repository-governance invariants were reviewed against changed files in bounded evidence.
CDD/context: CodeGraph evidence, changed-file history, and focused hunks were reviewed from bounded-review-evidence.md.
Similar issues: changed-file history evidence was reviewed for comparable local precedents.
Claim/concept check: bounded evidence, repository source, current-head workflow evidence, and, where numeric, scientific, statistical, or literature-backed claims are affected, original-paper/formula evidence and parameter-recovery expectations were used for claims.
Standards search: standards and external-source checks are delegated to configured OpenCode web_search/Context7/DeepWiki sources when applicable; no evidence-backed standards blocker is present in bounded evidence.
Compatibility/convention: changed workflow/script conventions, object naming, and reserved-word safety for schema/API/config/code surfaces were checked in bounded evidence.
Breaking-change/backcompat: deployment evidence and changed-file history were checked for backward-compatibility risk.
Performance: changed surfaces were checked for performance risk in bounded evidence.
Developer experience: changed automation, review, test, setup, and maintenance surfaces were checked for helpful or obstructive DX impact in bounded evidence.
User experience: connected user, operator, API, CLI, documentation, review-comment, status-check, rendering, and workflow-reader behavior was checked for contradictions against code, docs, and tests in bounded evidence.
Visual/DOM: Playwright visual, DOM locator, ARIA snapshot, console, and responsive evidence were checked when a web UI surface was present; for non-web surfaces, API/CLI/log/docs/workflow interaction evidence was reviewed instead.
Accessibility/i18n: accessibility, localization, and human-readable text surfaces were checked where UI, CLI, API message, docs, logs, or review text changed.
Supply-chain/license: dependency, package, model, container, and external-tool changes were checked in bounded evidence.
Packaging: package, build, test, lint, and security contracts were checked in bounded evidence.
Security/privacy: workflow-token, review-gate, and repository-automation security/privacy boundaries were checked in bounded evidence.

  • Result: APPROVE
  • Reason: Documentation-only change with no executable impact
  • Head SHA: a162e47b8e775dbdc66a64f1426465ef44fdd2d4
  • Workflow run: 29063915873
  • Workflow attempt: 1

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file: AGENTS.md"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file: AGENTS.md"]
  R1 --> V1["required checks"]
Loading

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.

2 participants