Install shared agent workflow seam

[justin808]

Summary

• add the shared agent-workflow command contract under .agents/bin
• add .agents/agent-workflow.yml with repo policy values for installed shared skills
• point AGENTS.md at the local command/policy seam

Validation

• agent-workflows-status --host codex --source /Users/justin/src/agent-workflows
• agent-workflows-status --host claude --source /Users/justin/src/agent-workflows
• /Users/justin/src/agent-workflows/bin/agent-workflow-seam-doctor --root /Users/justin/Codex/reactonrails-com --shared /Users/justin/src/agent-workflows
• bash -n .agents/bin/setup .agents/bin/validate .agents/bin/test .agents/bin/build
• .agents/bin/setup
• .agents/bin/validate

Notes: Docusaurus build passes but reports existing broken-link and broken-anchor warnings.

Summary by CodeRabbit

• New Features

  • Added standardized repo-local agent workflow scripts for setup, validation, build, and test tasks.
  • Introduced workflow configuration to define branch, review, merge, and coordination rules.

• Documentation

  • Added guidance for using the new workflow scripts and where to find shared workflow settings.
  • Updated contributor-facing instructions to reference the agent workflow setup.

[coderabbitai]

Warning

Review limit reached

@justin808, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 29 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: da342b7e-4791-4b8f-828b-191ed01b5ab0

📥 Commits

Reviewing files that changed from the base of the PR and between 8b53d4f and 8bd5cd1.

📒 Files selected for processing (3)

• .agents/bin/README.md
• .agents/bin/setup
• .agents/bin/test

Walkthrough

This PR adds an .agents/ directory containing a workflow policy file (agent-workflow.yml), four Bash entrypoint scripts (setup, build, test, validate), a README documenting them, and an AGENTS.md section referencing this new agent workflow configuration.

Changes

Agent Workflow Tooling

Layer / File(s)	Summary
Agent bin entrypoint scripts .agents/bin/setup, .agents/bin/build, .agents/bin/test, .agents/bin/validate	New Bash scripts with strict error handling that resolve the repo root and run npm ci, npm run build, test commands (test:docs-layout, test:prepare-prompts), and a combined build+test validation sequence respectively.
Workflow policy and documentation .agents/agent-workflow.yml, .agents/bin/README.md, AGENTS.md	Adds a review-gate/merge policy YAML, a README documenting the bin scripts and their purposes, and an AGENTS.md section pointing to both.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related issues

• Dogfood & validate the synced agent-workflow skills (post-#4221) react_on_rails#4228: Concerns the same .agents/ agent-workflow setup, including the .agents/bin/* scripts and workflow configuration introduced here.

Poem

A rabbit hops through folders new,
.agents/bin with scripts in view,
Build and test in tidy rows,
Setup runs where npm goes,
A README guides, a YAML gates,
Small hops today, this rabbit celebrates. 🐇

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title matches the main change by introducing a shared agent workflow seam and related scripts/configuration.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch agent-workflows/seam-sync

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Greptile Summary

This PR installs a shared agent workflow seam for the repo. The main changes are:

• New .agents/bin command wrappers for setup, validate, test, and build.
• New .agents/agent-workflow.yml policy values for shared skills.
• AGENTS.md guidance that points agents at the local command and policy seam.

Confidence Score: 4/5

The shared workflow path can fail after setup in a clean workspace.

• setup installs dependencies but leaves generated docs and prompts absent.
• validate runs the existing build, which checks for those generated inputs.
• The test wrapper can narrow coverage when caller arguments are interpreted by node --test.

.agents/bin/setup, .agents/bin/test

Important Files Changed

Filename	Overview
.agents/bin/setup	Adds dependency installation for the shared setup command, but it does not prepare generated docs and prompts needed by the build.
.agents/bin/build	Adds a build wrapper around the existing root build script.
.agents/bin/test	Adds a test wrapper that runs the two documented node test commands and forwards caller arguments.
.agents/bin/validate	Adds a validate wrapper that runs build before test through root-relative script paths.
.agents/agent-workflow.yml	Adds repo policy values consumed by shared agent workflow skills.
.agents/bin/README.md	Documents the shared command contract and which capabilities are available or not applicable.
AGENTS.md	Documents the new command and policy locations for portable shared skills.

_{Reviews (1): Last reviewed commit: "Install shared agent workflow seam" | Re-trigger Greptile}

[github-actions]

Cloudflare preview deployed.

• Branch: pr-143
• URL: https://a3c9eecb.reactonrails-com.pages.dev