Skip to content

feat: add organization-wide agent-task issue template (Why-first)#10

Merged
get6 merged 2 commits into
mainfrom
agent/claude/f8ef1fb6
May 11, 2026
Merged

feat: add organization-wide agent-task issue template (Why-first)#10
get6 merged 2 commits into
mainfrom
agent/claude/f8ef1fb6

Conversation

@get6
Copy link
Copy Markdown
Member

@get6 get6 commented May 11, 2026

Why

에이전트 작업 이슈에서 Why가 비어 있으면 잘못된 방향으로 빠르게 작동한다. 사람용 가이드("Why를 적어주세요")는 에이전트에겐 무력하다. 이슈 단위 입력 게이트가 가장 강력한 강제 수단이다.

ITT-82(Golden Circle 적용)의 B2(a) 단계.

How

  • 조직 전체에 영향을 주는 .github repo에 .github/ISSUE_TEMPLATE/ 디렉토리 신설
  • agent-task.yml: YAML form으로 Why·What 필수 필드 + 작성자 확인 체크박스 강제
  • Vision/Mission 원문은 profile/README.md의 한 줄을 그대로 인용 (추측 금지)
  • blank_issues_enabled: true 유지 — 자유 양식 이슈는 그대로 허용, 강제는 에이전트 작업에만 적용

What

  • + .github/ISSUE_TEMPLATE/agent-task.yml (Why/How/What/Acceptance + 확인 체크박스)
  • + .github/ISSUE_TEMPLATE/config.yml (Vision/Mission README로 연결되는 contact link)

Out of scope (의도적으로 제외)

  • PR 템플릿(B5c): 자체 AI 리뷰 워크플로우(claude-code-review.yml 등)와 융합 후 별도 PR
  • 완료 코멘트 Why 회고(B3): 동일 사유로 보류
  • Claude Code hooks·Actions Why 검증(B5a/b): 자체 AI 리뷰가 일부 역할 중복, 안정화 후

Test plan

  • organization의 임의 repo에서 "New Issue" 클릭 시 "Agent Task (Why → How → What)" 옵션 노출
  • Why 빈 칸으로 submit 시도 시 차단
  • 작성자 확인 체크박스 미체크 시 submit 차단
  • config의 contact link가 profile/README 한국어 Vision/Mission 섹션으로 연결

Why: 에이전트 작업 이슈에서 Why를 명시하지 않으면 잘못된 방향으로
빠르게 작동한다. 이슈 단위 입력 게이트가 가장 강력한 강제 수단이다.

- agent-task.yml: Why/How/What/Acceptance 필수 YAML form
- config.yml: profile/README의 Vision/Mission으로 연결되는 contact link
- blank_issues_enabled: true 유지 — 자유 양식은 그대로 허용

ref: ITT-82 (Golden Circle 적용)
Co-authored-by: multica-agent <github@multica.ai>
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a new GitHub issue template, 'Agent Task', which follows a 'Why → How → What' structure to ensure all tasks align with the organization's Vision and Mission. It also includes a configuration file to provide links to the core values. The review feedback suggests correcting the Vision and Mission statements within the template to exactly match the official wording in the profile README for consistency.

Comment thread .github/ISSUE_TEMPLATE/agent-task.yml Outdated
Comment on lines +10 to +11
> **Vision:** 사람들의 계획이 현실이 되도록 돕는다.
> **Mission:** 어제를 소중히 여기고, 내일을 꿈꾸며, 오늘을 살아갈 수 있도록 돕는다.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

PR 본문에서 "Vision/Mission 원문은 profile/README.md의 한 줄을 그대로 인용 (추측 금지)"한다고 명시하셨으나, 현재 템플릿에 작성된 문구는 원문(~돕는 것입니다)과 종결 어미가 다릅니다. 조직의 핵심 가치를 일관되게 전달하기 위해 원문과 동일하게 수정하는 것이 좋겠습니다.

        > **Vision:** 사람들의 계획이 현실이 되도록 돕는 것입니다.\n        > **Mission:** 어제를 소중히 여기고, 내일을 꿈꾸며, 오늘을 살아갈 수 있도록 돕는 것입니다.

Comment thread .github/ISSUE_TEMPLATE/agent-task.yml Outdated
attributes:
label: Why — 왜 해야 하는가
description: |
이 작업이 우리 Vision("사람들의 계획이 현실이 되도록 돕는다")을 어떻게 강화하는가?
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

설명(description) 부분에 포함된 Vision 문구도 원문과 일치하도록 수정이 필요합니다.

        이 작업이 우리 Vision(\"사람들의 계획이 현실이 되도록 돕는 것입니다\")을 어떻게 강화하는가?

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c866b6575e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/ISSUE_TEMPLATE/agent-task.yml Outdated
name: Agent Task (Why → How → What)
description: AI 에이전트(또는 사람)가 처리할 작업. Golden Circle에 따라 Why부터 명시한다.
title: "[Agent Task] "
labels: ["agent-task"]
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Create the org-wide label before assigning it

For repositories where this org-wide form is inherited but the agent-task label has not already been created, GitHub will not add the label to new issues (GitHub's issue-form syntax docs state labels are only auto-added if they already exist in the repository). Because this template is intended to apply across the organization and this change does not provision the label in each target repo, agent-task issues in those repos will not be reliably triageable by this label; either remove the default label or ensure it exists everywhere the form is used.

Useful? React with 👍 / 👎.

…e default label

Why: 원문 그대로 인용 정책을 명시했음에도 종결체가 어긋났고, org-wide
form이 상속되는 repo에 미존재 라벨은 GitHub이 자동 부여하지 않는다는
신뢰성 문제가 있었다.

Review feedback addressed:
- Gemini (line 11): Vision/Mission 종결체를 profile/README 원문대로 수정
- Gemini (line 21): description 안의 Vision 문구도 동일하게 수정
- Codex (line 4, P2): default label 제거 — 라벨 부여는 각 repo 책임

ref: ITT-82
Co-authored-by: multica-agent <github@multica.ai>
@get6 get6 merged commit e31e62e into main May 11, 2026
@get6 get6 deleted the agent/claude/f8ef1fb6 branch May 11, 2026 23:36
@get6 get6 self-assigned this May 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant