---
title: "codex-workflow"
description: "사용자 의도를 먼저 판별하고, 제품·기능·연구 실험·버그에 맞는 서로 다른 승인 흐름을 적용하는 한국어 워크플로우입니다."
canonical: https://agentpluginsdirectory.com/plugins/codex-workflow
last-updated: 2026-09-25
---

# codex-workflow
사용자 의도를 먼저 판별하고, 제품·기능·연구 실험·버그에 맞는 서로 다른 승인 흐름을 적용하는 한국어 워크플로우입니다.
- Slug: codex-workflow
- Publisher: j-token
- Repository: https://github.com/j-token/j-token-codex-workflow-kit
- Manifest: plugins/codex-workflow/plugin.json
- Version: 1.6.0
- License: Apache-2.0
- Category (editorial): agent-tooling
- Skills: 18 (audit-technical-spec, branch-rule, bug-report-to-fix, cognitive-writing, commit-rule, figma-flow-to-implementation, git-push-safety, intent-first, j-explain-style, orchestrate-subagents, pr-rule, prd-writer, prototype-design, requirements-to-spec, research-experiment-workflow, start-implementation-thread, technical-spec-writer, workflow-composer)
- MCP servers: 1 (workflow-confirmation)
- Stars: 1
- Repository created: 2026-05-20
- Repository last pushed: 2026-08-09
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/codex-workflow
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What codex-workflow does, in the publisher's words

j-token-workflow-kit은 Codex가 저장소와 필요한 외부 자료를 먼저 조사한 뒤, 작업 성격에 맞는 승인 경계와 구현 경로를 선택하는 한국어 워크플로우 플러그인입니다. 플러그인 패키지는 Agent Plugins 1.0.0의 이식 가능한 표준 구조를 따릅니다.

버전 1.5.0부터 열린 질문이 없는 이진 승인에는 Python MCP 서버가 제공하는 인라인 승인·취소 카드를 사용할 수 있습니다. 호스트가 MCP Apps UI를 렌더링하지 않으면 같은 도구 결과가 한국어 텍스트 승인 질문으로 폴백합니다.

현재 플러그인 버전: 1.6.0

- 플러그인 루트의 plugin.json, mcp.json, skills/ 고정 위치를 사용하는 Agent Plugins 1.0.0 표준으로 전체 마이그레이션했습니다.
- 레거시 Codex 전용.codex-plugin/plugin.json과.mcp.json을 제거했습니다.
- 매니페스트에서 구성 요소 경로를 직접 선언하지 않고 표준 클라이언트가 고정 위치에서 스킬과 MCP 서버를 발견하도록 변경했습니다.
- 모든 SKILL.md의 Agent Skills 핵심 계약과 두 표준 JSON 문서의 회귀 검증을 추가했습니다.
- 번들 MCP 서버 설정의 래퍼를 Codex가 지원하는 mcp_servers로 수정해 show_workflow_confirmation과 submit_workflow_decision이 도구 목록에 등록되도록 했습니다.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/j-token/j-token-codex-workflow-kit/HEAD/README.md

## Skills

- audit-technical-spec: 사용자가 기술 스펙의 독립 감사를 명시적으로 요청했거나, 보안·데이터·호환성·배포처럼 실패 비용이 큰 계획에서 독립 검토가 실질적으로 필요한 경우 사용합니다. 승인된 기술 스펙을 저장소와 공식 자료에 대조해 사실 불일치와 구현 블로커를 찾습니다. 일반 저위험 작업의 필수 게이트로 사용하지 않습니다.
- branch-rule: Git 브랜치를 생성하거나 분기하거나 이름을 정하기 전에 적용합니다. 사용자가 브랜치 생성, 분기 또는 이름 결정을 요청할 때 의미가 분명한 접두사 규칙을 제공합니다.
- bug-report-to-fix: 사용자가 버그, 불명확한 증상, 스크린샷, 로그 또는 재현 정보를 주고 진단이나 수정을 요청할 때 사용합니다. 사실과 추정을 분리해 재현·원인을 먼저 조사하고, 요청 증상과 직접 관련된 원인 및 필수 변경 범위를 제시해 별도 승인받은 뒤 수정·검증합니다. 조사 중 발견한 별도 버그, 독립 리팩터링과 새 동작은 별도 범위로 분리합니다.
- cognitive-writing: 독자의 인지 부하를 최소화하도록 글을 구조화하는 공통 규칙입니다. 인지부하론(내재적/외재적/본유적 부하, 작업기억 보호) 4원칙, GitHub-flavored Markdown 작성 규칙, Codex Desktop의 Mermaid와 Codex CLI의 코드 블록 ASCII 다이어그램 규칙, 공통 자가 점검 체크리스트를 제공합니다. PR·plan·기획서·기술 문서·이슈 코멘트 등 "타인이 읽고 판단해야 할 모든 글"에 적용합니다. 사용자가 "글 정리해줘", "문서 다듬어줘", "리뷰어 부담 줄여줘", "마크다운 양식 점검", "인지…
- commit-rule: 사용자가 현재 요청에서 Git 커밋 생성을 명시적으로 요청했을 때 적용합니다. 모든 커밋마다 명시적 허락을 요구하고 작업별 커밋과 메시지 규칙을 제공합니다.
- figma-flow-to-implementation: 사용자가 Figma 링크, 스크린샷, 시각 자료를 제공하거나 UI/화면 구현을 요청할 때 사용합니다. 시각 자료와 기존 앱을 조사해 화면 역할·전이·에셋을 파악하고 단일 UI 스펙/구현 문서를 제시한 뒤, 별도 사용자 메시지에서 구현 승인을 받으면 새 Codex 작업으로 인계합니다.
- git-push-safety: 의도하지 않은 브랜치나 보호 브랜치에 push하는 사고를 막기 위한 안전 워크플로우입니다. Codex가 git push 실행, 준비, 검토, 설명, force push, upstream 설정, 브랜치 게시, PR 준비를 요청받았을 때 사용합니다. 사용자가 매번 명시적으로 push를 요청하거나 승인하지 않으면 push는 금지됩니다.
- intent-first: 모든 사용자 명령에서 실질적인 작업보다 먼저 사용자의 실제 의도를 판별하고, 불명확한 부분을 조사할지 가정할지 질문할지 의식적으로 결정합니다. 짧거나 추상적이거나 여러 해석이 가능한 요청, 범위가 크거나 되돌리기 어려운 작업에서는 특히 엄격히 적용합니다. 명확한 한 줄 변경도 이 라우팅 자체는 생략하지 않습니다.
- j-explain-style: 사용자에게 작업 결과, 지식, 개념, 기술, 수치 또는 판단 근거를 설명할 때 적용합니다. 개념 설명에서는 청자가 아는 기준점에서 출발해 차이와 문제를 세우고, 한 단계 질문과 상태 변화를 따라 핵심 메커니즘에 도달한 뒤 필요성과 행동으로 되돌아옵니다. 작업 결과 보고에서는 결과, 변경, 증거와 남은 범위만 간결하게 전달합니다.
- orchestrate-subagents: 현재 작업 안에서 서로 독립적인 조사·구현·검토를 병렬화할 실질적 이점이 있거나 사용자가 하위 에이전트를 명시적으로 요청했을 때 사용합니다. 역할, 최소 컨텍스트, 파일 소유권과 결과 검증을 조율합니다. 간단한 수정과 일반 작업에 하위 에이전트나 독립 리뷰를 필수 게이트로 강제하지 않습니다.
- pr-rule: 사용자가 pull request 생성을 명시적으로 요청했을 때 적용합니다. draft PR을 만들고 대상 브랜치를 사용자에게 확인하며 제목과 본문 양식을 강제합니다.
- prd-writer: 사용자가 PRD, 제품 요구사항 문서, 기술 제품 기획서 또는 제품·기능 구현을 요청했을 때 작성하거나 다듬습니다. 요구사항 조사 결과를 제품 범위와 수용 기준으로 정리해 제시하고, 별도 사용자 메시지에서 기술 스펙 작성 승인을 기다립니다.
- prototype-design
- requirements-to-spec
- research-experiment-workflow
- start-implementation-thread
- technical-spec-writer
- workflow-composer

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- workflow-confirmation: transport: stdio; command: python ${PLUGIN_ROOT}/mcp/server.py

Read from the plugin's own mcp.json. Environment variable names only, never values.