Skip to content

docs(#2215): extend forge abstraction scope to action.yml#2219

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/2215-forge-action-yml-scope
Open

docs(#2215): extend forge abstraction scope to action.yml#2219
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/2215-forge-action-yml-scope

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

The forge abstraction rule in CLAUDE.md and AGENTS.md was written with Go-specific examples (exec.Command, net/http) and did not explicitly cover action.yml bash scripts. This led the code agent in PR #2150 to correctly use forge.Client in Go but also add parallel inline gh api calls in action.yml, requiring substantial rework.

Both files now state that new GitHub API operations in action.yml steps should be implemented as fullsend CLI subcommands (under internal/cli/) that use forge.Client, not as inline gh api calls. Existing gh api calls are grandfathered but should be migrated when touched.

Note: make lint could not run in sandbox due to shellcheck installation failure (network restriction). This is a docs-only change with no code to test.


Closes #2215

Post-script verification

  • Branch is not main/master (agent/2215-forge-action-yml-scope)
  • Secret scan passed (gitleaks — 9c19aa5cc7bd8f1d0d499453d12855e03c8b7f9c..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

@github-actions

github-actions Bot commented Jun 12, 2026

Copy link
Copy Markdown

Site preview

Preview: https://08a2d1b1-site.fullsend-ai.workers.dev

Commit: 38cfc04c97e3dce984b7441d27020a511bd6af91

@fullsend-ai-review

fullsend-ai-review Bot commented Jun 12, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 12:11 PM UTC · Completed 12:18 PM UTC
Commit: e2ccaab · View workflow run →

@codecov

codecov Bot commented Jun 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@fullsend-ai-review

fullsend-ai-review Bot commented Jun 12, 2026

Copy link
Copy Markdown

Review

Findings

Medium

Info

  • [terminology-precision] AGENTS.md:65 — The header "Action workflows" may cause confusion: in GitHub Actions terminology, "workflows" refers to .github/workflows/*.yml files, while action.yml defines a composite action. The parenthetical (action.yml) disambiguates in practice, but consider using "Composite actions" or "Action definitions" for terminological precision in a document that serves as authoritative guidance for agents.
Previous run

Review

Findings

Medium

@fullsend-ai-review fullsend-ai-review Bot added the requires-manual-review Review requires human judgment label Jun 12, 2026
The forge abstraction rule in CLAUDE.md and AGENTS.md was written
with Go-specific examples (exec.Command, net/http) and did not
explicitly cover action.yml bash scripts. This led the code agent
in PR #2150 to correctly use forge.Client in Go but also add
parallel inline gh api calls in action.yml, requiring substantial
rework.

Both files now state that new GitHub API operations in action.yml
steps should be implemented as fullsend CLI subcommands (under
internal/cli/) that use forge.Client, not as inline gh api calls.
Existing gh api calls are grandfathered but should be migrated
when touched.

Note: make lint could not run in sandbox due to shellcheck
installation failure (network restriction). This is a docs-only
change with no code to test.

Closes #2215
@fullsend-ai-review

fullsend-ai-review Bot commented Jun 15, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 5:49 PM UTC · Completed 5:58 PM UTC
Commit: 38cfc04 · View workflow run →

@fullsend-ai-review fullsend-ai-review Bot added requires-manual-review Review requires human judgment and removed requires-manual-review Review requires human judgment labels Jun 15, 2026
@ralphbean ralphbean requested a review from ggallen June 15, 2026 18:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

requires-manual-review Review requires human judgment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify forge abstraction scope to cover action.yml bash scripts

1 participant