| name | frontend-workflow |
| description | Use when working on this project's frontend app, apps/web, fork/upstream PR flow, Bun frontend commands, frontend lint/build checks, or frontend collaboration rules. |
Frontend Workflow
Use this project-local skill before frontend implementation, review, branch/PR guidance, or CI/Lint setup for apps/web.
Read First
CONTRIBUTING.md — authoritative repository branch, PR, commit, and merge policy.docs/collaboration/frontend-workflow.md — frontend-specific workflow supplement..trellis/spec/frontend/index.md — agent-facing frontend implementation standards..trellis/spec/frontend/quality-guidelines.md — required checks, Bun command form, and review checklist..trellis/spec/frontend/directory-structure.md — apps/web/src/ layout and module boundaries.
PR Creation Addendum
Before creating or editing a PR, also read:
docs/collaboration/repository-settings.md for PR Guard rules..github/pull_request_template.md for the required Chinese body sections.
Do not handwrite an English-only PR body. PR titles must not contain Chinese
characters; PR bodies must contain Chinese content, use the template sections
修改内容, 关联 Issue, 验证, 已知风险, and 检查项, and include a valid
issue closing keyword such as Closes #117 when the task has an issue.
Fixed Project Rules
- Frontend source lives under
apps/web/src/; do not create repository-root src/ for frontend code.
- Branch, PR, commit, and merge policy comes from
CONTRIBUTING.md; do not override it in frontend-specific docs or commands.
- Current frontend work follows the repository fork + PR flow into
upstream/develop; do not target frontend-dev unless CONTRIBUTING.md is updated to enable it.
- Use Bun for frontend dependencies and scripts.
- From the repository root, run frontend scripts as
bun run --cwd apps/web <script>.
Required Checks
For non-trivial frontend changes, run and report:
bun run --cwd apps/web check
bun run --cwd apps/web build
git diff --check
If a check is not run, report it with the reason and remaining risk.
Trellis Fit
This skill is for on-demand frontend workflow context. Do not replace the Trellis workflow-state hooks with this content. Hooks should stay focused on active-task and phase context; frontend rules belong here and in .trellis/spec/frontend/.
