Document reusable agent workflows

[TaiChi112]

Summary

• Added AGENT_WORKFLOWS.md for reusable agent Git/PR procedures.
• Added portable prompt templates for PR lifecycle, lint cleanup, dependency security updates, and docs-only changes.
• Updated AGENTS.md to point agents to workflow procedures without duplicating them.

Validation

• git diff --check passed.
• bun run build passed.

Notes

• This PR does not create tool-specific slash commands, skills, hooks, MCP servers, or custom agents.
• This PR does not modify runtime code or dependencies.
• Workflow templates are portable across AI coding agents and IDEs.

Summary by CodeRabbit

• Documentation
  • Added standardized workflow documentation for common repository tasks.
  • Introduced procedures for dependency security updates, documentation-only changes, lint cleanup, and pull request management.
  • Established validation guidelines and change isolation rules for consistent repository operations.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
personal-profile-prototype	Ready	Preview, Comment	Jun 2, 2026 2:13pm

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 1eaa92a2-0a80-4cc9-843a-a6631ecaeda8

📥 Commits

Reviewing files that changed from the base of the PR and between 6d3ca4c and 48fd8bb.

📒 Files selected for processing (6)

• AGENTS.md
• AGENT_WORKFLOWS.md
• prompts/agent-workflows/dependency-security-update.md
• prompts/agent-workflows/docs-only-change.md
• prompts/agent-workflows/lint-cleanup.md
• prompts/agent-workflows/pr-lifecycle.md

---

📝 Walkthrough

Walkthrough

This PR establishes a structured guidance framework for agent-managed repository workflows. It adds a reference section to AGENTS.md, defines portable procedures and validation matrices in a new AGENT_WORKFLOWS.md document, and introduces four specialized workflow prompts for common tasks: dependency security updates, documentation-only changes, lint cleanup, and standard PR lifecycle management.

Changes

Agent Workflow Guidance System

Layer / File(s)	Summary
Agent workflow policy reference AGENTS.md	Added "Agent Workflow Reference" section directing to AGENT_WORKFLOWS.md for reusable workflows and clarifying policy/procedure separation.
Core workflow procedures and validation framework AGENT_WORKFLOWS.md	New file defining workflow modes, standard PR lifecycle checklist, universal stop gates, validation matrix by change type, reusable PR/final-report markdown templates, and change isolation rules.
Specialized workflow prompts prompts/agent-workflows/dependency-security-update.md, prompts/agent-workflows/docs-only-change.md, prompts/agent-workflows/lint-cleanup.md, prompts/agent-workflows/pr-lifecycle.md	Four concrete workflow prompts implementing the core procedures: dependency updates (Bun-only, version/lockfile review, validation stops), docs-only changes (approved paths, build validation), lint cleanup (baseline-driven, scoped fixes), and PR lifecycle (branch creation, validation, merge gates, cleanup).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• TaiChi112/Personal-Profile-Prototype#8: Introduced the initial AGENTS.md and agent-boundary rules that this PR extends with workflow reference and procedures.

Poem

🐰 Workflows scripted, procedures clear,
Agent guidance brings good cheer,
No more chaos, path defined—
Security, lint, and docs aligned!
Bouncing through PRs with structured glee! ✨

🚥 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 'Document reusable agent workflows' accurately and concisely describes the main change: adding documentation and reusable workflow templates for agent-based Git and PR operations.
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

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

---

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 and usage tips.}

[Copilot]

Pull request overview

Adds a centralized, portable set of reusable AI-agent Git/PR procedures and scoped prompt templates, and updates the canonical agent guidance to reference them (keeping policy vs. procedure separated).

Changes:

• Introduces AGENT_WORKFLOWS.md with standardized workflow modes, stop-gates, validation matrix, and reporting templates.
• Adds reusable prompt templates under prompts/agent-workflows/ for common PR lifecycle scenarios (PR lifecycle, lint cleanup, docs-only, dependency security update).
• Updates AGENTS.md to point agents to AGENT_WORKFLOWS.md for repeatable procedures without duplicating content.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
prompts/agent-workflows/pr-lifecycle.md	Adds a scoped, repeatable PR lifecycle prompt template with explicit safety gates.
prompts/agent-workflows/lint-cleanup.md	Adds a focused lint-cleanup workflow template with baseline capture and validation steps.
prompts/agent-workflows/docs-only-change.md	Adds a docs-only workflow template emphasizing scope control and optional build validation.
prompts/agent-workflows/dependency-security-update.md	Adds a dependency security update template enforcing Bun-only and strict scope isolation.
AGENTS.md	Adds a reference section that directs agents to AGENT_WORKFLOWS.md for reusable procedures.
AGENT_WORKFLOWS.md	Adds the centralized workflow procedures, validation matrix, and PR/report templates.