Skip to content

setting: CI 및 에이전트 워크플로우 기준 정리 - #6

Merged
hdg0116 merged 10 commits into
developfrom
setting/#5-ci-workflow
Aug 4, 2026
Merged

setting: CI 및 에이전트 워크플로우 기준 정리#6
hdg0116 merged 10 commits into
developfrom
setting/#5-ci-workflow

Conversation

@hdg0116

@hdg0116 hdg0116 commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

ISSUE 🔗

close #5



What is this PR? 🔍

  • Roominus Admin 프로젝트 기준의 AGENTS.md를 정리했습니다.
  • Next.js 16 App Router 작업 시 참고해야 할 로컬 문서와 작업 규칙을 추가했습니다.
  • .agents/skills에 필요한 에이전트 스킬만 라이트하게 추가했습니다.
    • 프론트엔드 작업 분류
    • 페이지/라우트 작업
    • API 및 TanStack Query 작업
    • 이슈 작성
    • PR 작성
    • 프로젝트 코드/브랜치/커밋 컨벤션
    • 프론트엔드 검증
  • docs/agent/index.md에 현재 에이전트 구성을 정리했습니다.
  • .github/workflows/ci.yml을 현재 단일 Next.js Admin 프로젝트에 맞게 경량화했습니다.
    • 수동 실행 추가
    • 중복 CI 실행 취소
    • 최소 권한 설정
    • timeout 설정
    • format:check, lint, build 검증 유지
  • 브랜치 컨벤션을 <type>/<issue-number>-<english-slug> 형식으로 정리하고, # 사용 금지 규칙을 추가했습니다.



Screenshot 📷



Test Checklist ✔

  • git diff --check
  • pnpm format:check
  • pnpm lint
  • pnpm build

@github-actions github-actions Bot added the 📬 API 서버 API 통신 label Jul 30, 2026
@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Summary by CodeRabbit

  • 문서

    • API 연동, 폼 처리, 페이지 기능, 공유 컴포넌트, 서버·클라이언트 경계 관련 가이드를 추가했습니다.
    • 프론트엔드 품질 검토·검증, 프로젝트 규칙, 이슈 및 PR 작성 지침을 정리했습니다.
    • 작업 유형별 에이전트 워크플로 선택과 실행 기준을 체계화했습니다.
  • 개선

    • CI 실행 환경, 캐시, 권한 및 실행 시간 제한을 개선했습니다.
    • Node.js와 pnpm 버전을 명확히 지정했습니다.

Walkthrough

11개의 프론트엔드 작업 유형별 에이전트 스킬 문서와 openai.yaml 설정을 추가했습니다. AGENTS.mddocs/agent/index.md를 갱신했습니다. CI 실행 정책과 Node.js 및 pnpm 버전 설정도 변경했습니다.

Changes

에이전트 스킬 워크플로 문서

Layer / File(s) Summary
작업 진입점 및 프로젝트 규칙
AGENTS.md, .agents/skills/frontend-task-orchestrator/..., .agents/skills/project-conventions-workflow/..., docs/agent/index.md
저장소 구조, 작업 분류, 명명·컴포넌트·브랜치·커밋·검증 규칙을 정의했습니다.
페이지 및 Server/Client 경계 워크플로
.agents/skills/page-feature-workflow/..., .agents/skills/server-client-boundary-workflow/...
Next.js 페이지 구현과 Server/Client Component 경계 결정 기준을 정의했습니다.
폼, API 및 공유 컴포넌트 워크플로
.agents/skills/form-flow-workflow/..., .agents/skills/api-integration-workflow/..., .agents/skills/shared-component-workflow/...
폼 상태·접근성, API 계약·오류 처리, 공유 컴포넌트 재사용 기준을 정의했습니다.
리뷰, 검증, 이슈 및 PR 워크플로
.agents/skills/frontend-fundamentals-review/..., .agents/skills/frontend-quality-verification/..., .agents/skills/issue-workflow/..., .agents/skills/pr-prep-workflow/...
프론트엔드 리뷰, 검증 명령, 이슈 작성 및 PR 준비 절차를 정의했습니다.

CI 및 런타임 버전 설정

Layer / File(s) Summary
CI 실행 정책 및 버전 고정
.github/workflows/ci.yml, .node-version, package.json
CI에 수동 실행, 동시 실행 취소, contents: read, 15분 타임아웃, 커밋 고정 액션을 추가했습니다. Node.js는 .node-version을 사용하고 pnpm은 package.json10.33.0을 사용하도록 설정했습니다.

Estimated code review effort: 2 (Simple) | ~15 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Title check ⚠️ Warning 제목은 변경 내용과 관련되지만 요구된 [SETTING] 형식과 대문자 접두사를 따르지 않습니다. 제목을 [SETTING] CI 및 에이전트 워크플로우 기준 정리처럼 지정된 접두사 형식으로 수정하세요.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed PR 변경 내용은 직접 연결된 Issue #5의 에이전트 환경 및 CI 구성 목표와 일치합니다.
Out of Scope Changes check ✅ Passed 추가된 스킬, 문서, Node.js 설정, 패키지 관리자 설정, CI 변경은 PR 목표 범위에 포함됩니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check ✅ Passed 이슈, 변경 내용, 스크린샷, 테스트 체크리스트 섹션을 포함해 템플릿을 대부분 충족합니다.

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 7

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.agents/skills/pr-prep-workflow/SKILL.md:
- Line 15: Remove the duplicated branch and commit convention definitions from
pr-prep-workflow/SKILL.md around lines 36-46, leaving only a concise reference
to project-conventions-workflow/SKILL.md as the single source of truth. Update
the line-15 guidance if needed so it clearly directs readers to that document
without restating formats, examples, or commit types.

In @.agents/skills/project-conventions-workflow/agents/openai.yaml:
- Around line 1-4: Update the metadata for the Project Conventions Workflow by
adding the policy.allow_implicit_invocation setting with a true value alongside
the existing interface definition, preserving the current display_name,
short_description, and default_prompt.

In @.agents/skills/project-conventions-workflow/SKILL.md:
- Around line 54-60: Update the no-issue-number guidance in the branch rules
near the work-branch format so it no longer permits or defines a no-issue branch
name; require asking the user to create or link an issue before proposing a
branch. Keep the required <type>/<issue-number>-<english-slug> format and
existing naming restrictions consistent with AGENTS.md.

In @.github/workflows/ci.yml:
- Line 25: Pin the GitHub Actions in ci.yml to specific commit SHAs for security
and reproducibility. Replace the version tag references for actions/checkout,
pnpm/action-setup, and actions/setup-node (currently using `@v4` format) with
their corresponding 40-character commit SHAs. Include the original version tag
as a comment after each commit SHA reference to maintain documentation of which
version was used.
- Around line 24-25: Update the actions/checkout@v4 step in the CI workflow to
set persist-credentials to false, ensuring the checkout does not retain
GITHUB_TOKEN in .git/config for later pnpm lint and pnpm build JavaScript
execution.

In `@docs/agent/index.md`:
- Around line 11-21: Synchronize the Included Skills table in the documentation
entry point with AGENTS.md by adding server-client-boundary-workflow,
shared-component-workflow, form-flow-workflow, and frontend-fundamentals-review,
preserving the existing skill descriptions and table format.
- Around line 23-27: Update the “Excluded From The Light Setup” section to
remove the external “DONGCHIMI-CLIENT” repository reference and explain
directly, using this repository’s context, that the listed workflows are not
included because this is currently a single Next.js Admin app; retain the
guidance to add them when they become part of everyday work.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 814e0292-2803-4cca-802e-1103ff8aacdd

📥 Commits

Reviewing files that changed from the base of the PR and between 45dd044 and 2089a2d.

⛔ Files ignored due to path filters (1)
  • .coderabbit.yaml is excluded by !.coderabbit.yaml and included by none
📒 Files selected for processing (27)
  • .agents/skills/api-integration-workflow/SKILL.md
  • .agents/skills/api-integration-workflow/agents/openai.yaml
  • .agents/skills/form-flow-workflow/SKILL.md
  • .agents/skills/form-flow-workflow/agents/openai.yaml
  • .agents/skills/frontend-fundamentals-review/SKILL.md
  • .agents/skills/frontend-fundamentals-review/agents/openai.yaml
  • .agents/skills/frontend-quality-verification/SKILL.md
  • .agents/skills/frontend-quality-verification/agents/openai.yaml
  • .agents/skills/frontend-task-orchestrator/SKILL.md
  • .agents/skills/frontend-task-orchestrator/agents/openai.yaml
  • .agents/skills/issue-workflow/SKILL.md
  • .agents/skills/issue-workflow/agents/openai.yaml
  • .agents/skills/page-feature-workflow/SKILL.md
  • .agents/skills/page-feature-workflow/agents/openai.yaml
  • .agents/skills/pr-prep-workflow/SKILL.md
  • .agents/skills/pr-prep-workflow/agents/openai.yaml
  • .agents/skills/project-conventions-workflow/SKILL.md
  • .agents/skills/project-conventions-workflow/agents/openai.yaml
  • .agents/skills/server-client-boundary-workflow/SKILL.md
  • .agents/skills/server-client-boundary-workflow/agents/openai.yaml
  • .agents/skills/shared-component-workflow/SKILL.md
  • .agents/skills/shared-component-workflow/agents/openai.yaml
  • .github/workflows/ci.yml
  • .node-version
  • AGENTS.md
  • docs/agent/index.md
  • package.json

Comment thread .agents/skills/pr-prep-workflow/SKILL.md Outdated
Comment thread .agents/skills/project-conventions-workflow/agents/openai.yaml
Comment thread .agents/skills/project-conventions-workflow/SKILL.md Outdated
Comment thread .github/workflows/ci.yml Outdated
Comment thread .github/workflows/ci.yml Outdated
Comment thread docs/agent/index.md Outdated
Comment thread docs/agent/index.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
.agents/skills/project-conventions-workflow/SKILL.md (1)

50-59: 📐 Maintainability & Code Quality | 🟠 Major | ⚡ Quick win

브랜치·커밋 규칙의 단일 출처를 유지하세요.

AGENTS.md Lines 67-98과 이 파일 Lines 50-119가 브랜치 형식, 금지 문자, 커밋 형식, 타입 목록, 본문 규칙을 각각 정의합니다. 한 문서만 상세 규칙의 source of truth가 되어야 합니다. 현재 구조는 한 문서만 변경될 때 에이전트가 서로 다른 규칙을 적용할 위험이 있습니다. 이 skill을 단일 출처로 유지하고 AGENTS.md에는 짧은 참조만 남기세요.

As per path instructions: .agents/** skill은 AGENTS.md와 중복되거나 충돌하는 source of truth를 만들지 않아야 합니다.

Also applies to: 62-119

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.agents/skills/project-conventions-workflow/SKILL.md around lines 50 - 59,
Make `.agents/skills/project-conventions-workflow/SKILL.md` the sole detailed
source of truth for the Branch Naming and commit convention rules. Remove the
duplicated branch, commit, type, character, and body requirements from
`AGENTS.md`, replacing them with a brief reference to this skill. Preserve the
complete rules in the skill without introducing conflicting guidance.

Source: Path instructions

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In @.agents/skills/project-conventions-workflow/SKILL.md:
- Around line 50-59: Make `.agents/skills/project-conventions-workflow/SKILL.md`
the sole detailed source of truth for the Branch Naming and commit convention
rules. Remove the duplicated branch, commit, type, character, and body
requirements from `AGENTS.md`, replacing them with a brief reference to this
skill. Preserve the complete rules in the skill without introducing conflicting
guidance.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 7bf38cc9-e8bd-45fd-9cad-4d57f0085ad7

📥 Commits

Reviewing files that changed from the base of the PR and between 2089a2d and 1fb0584.

📒 Files selected for processing (5)
  • .agents/skills/pr-prep-workflow/SKILL.md
  • .agents/skills/project-conventions-workflow/SKILL.md
  • .agents/skills/project-conventions-workflow/agents/openai.yaml
  • .github/workflows/ci.yml
  • docs/agent/index.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
AGENTS.md (1)

24-24: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

패키지 관리자 기준에 package.json#packageManager를 포함해 주세요.

Line 24는 lockfile과 scripts만 source of truth로 지정합니다. 제공된 package.jsonpnpm@10.33.0을 선언합니다. 이 설정을 포함하지 않으면 다른 pnpm 버전이 선택되어 lockfile 동작이 달라질 수 있습니다.

수정 예시
-- Package manager source of truth: existing lockfile and scripts. This repo currently uses `pnpm-lock.yaml`.
+- Package manager source of truth: the repository package-manager configuration (`package.json#packageManager`), `pnpm-lock.yaml`, and existing scripts.

저장소 지침과 제공된 package.json 설정을 기준으로 판단했습니다.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@AGENTS.md` at line 24, Update the package manager source-of-truth guidance in
AGENTS.md to include the package.json packageManager field alongside the
existing lockfile and scripts, preserving the declared pnpm@10.33.0
configuration as the version to use.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In `@AGENTS.md`:
- Line 24: Update the package manager source-of-truth guidance in AGENTS.md to
include the package.json packageManager field alongside the existing lockfile
and scripts, preserving the declared pnpm@10.33.0 configuration as the version
to use.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: c67a3034-1e0c-48fc-8849-2b9410acf837

📥 Commits

Reviewing files that changed from the base of the PR and between 1fb0584 and b007052.

📒 Files selected for processing (1)
  • AGENTS.md

@hdg0116 hdg0116 changed the title Setting/#5 ci workflow Setting: CI 및 에이전트 워크플로우 기준 정리 Aug 4, 2026
@hdg0116 hdg0116 changed the title Setting: CI 및 에이전트 워크플로우 기준 정리 ㄴetting: CI 및 에이전트 워크플로우 기준 정리 Aug 4, 2026
@hdg0116 hdg0116 changed the title ㄴetting: CI 및 에이전트 워크플로우 기준 정리 setting: CI 및 에이전트 워크플로우 기준 정리 Aug 4, 2026
@hdg0116
hdg0116 merged commit 44fef36 into develop Aug 4, 2026
2 checks passed
@hdg0116
hdg0116 deleted the setting/#5-ci-workflow branch August 4, 2026 17:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📬 API 서버 API 통신

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEAT] 프로젝트 에이전트 및 CI 워크플로우 세팅

1 participant