ersinkoc/project-architect

**문서 우선 프로젝트 계획 (documentation-first project planning)**을 위한 에이전트 기술 (Agent Skill)입니다. 프로젝트 아이디어를 구현 가능한 설계도(blueprints)와 단일 실행 코딩 에이전트 프롬프트(single-shot coding agent prompt)로 변환합니다.

Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, Roo Code 등을 포함한 **40개 이상의 코딩 에이전트 (coding agents)**와 호환됩니다.

프로젝트 아이디어가 주어지면, Project Architect는 대화형 탐색 프로세스 (interactive discovery process)를 통해 사용자를 안내하고 서로 연결된 5개의 문서를 생성합니다:

[Discovery] -> SPECIFICATION.md -> IMPLEMENTATION.md -> TASKS.md -> BRANDING.md
(무엇을 할 것인가) (어떻게 할 것인가) (수행할 작업) (정체성)
| | |
...

문서	목적
SPECIFICATION.md	프로젝트의 정의, 기능, 데이터 모델 (data model), API 표면 (API surface)
IMPLEMENTATION.md	기술 스택 (tech stack), 디자인 패턴 (design patterns), 디렉토리 구조 (directory structure), 스키마 (schemas)
TASKS.md	순서가 지정된 작업 항목 (work items), 각 항목은 단일 에이전트 세션 내에서 완료 가능
BRANDING.md	이름, 색상, 타이포그래피, 보이스 (선택 사항, 사용자 대상 프로젝트용)
PROMPT.md	처음부터 전체 프로젝트를 구축하기 위한 독립적인 프롬프트 (self-contained prompt)

대화형 기술 스택 어드바이저 (Interactive tech stack advisor) -- 트레이드오프 (trade-offs)와 함께 옵션을 제시하며 사용자가 선택할 수 있게 합니다. 디자인 패턴 추천 (Design pattern recommendations) -- 프로젝트의 특정 요구 사항에 맞춰 코드 스케치 (code sketches)와 함께 제공됩니다. 프로젝트 규모에 따른 확장성 (Scales to project size) -- 주말 해커톤 프로젝트는 15개의 작업, 엔터프라이즈 시스템은 100개 이상의 작업을 생성합니다. 에이전트 최적화 출력 (Agent-optimized output) -- 모든 작업에는 생성/수정해야 할 정확한 파일 목록과 수락 기준 (acceptance criteria)이 포함됩니다. 일시 중지 및 검토 흐름 (Pause-and-review flow) -- 각 문서를 생성한 후, 다음 단계로 넘어가기 전 승인을 기다립니다.

설치하는 가장 쉬운 방법이며, agentskills.io와 호환되는 모든 에이전트에서 작동합니다:

npx skills add ersinkoc/project-architect

이 명령은 사용자의 코딩 에이전트를 자동으로 감지하여 올바른 위치에 설치합니다.

특정 에이전트를 위한 설치:

npx skills add ersinkoc/project-architect --agent claude-code
npx skills add ersinkoc/project-architect --agent cursor
npx skills add ersinkoc/project-architect --agent codex

전역 설치 (모든 프로젝트):

npx skills add ersinkoc/project-architect --global

저장소 (Repository): github.com/ersinkoc/project-architect

프로젝트의 .claude/settings.json에 추가하세요:

{
"plugins": [
"/absolute/path/to/project-architect"
...

또는 전역적으로 사용할 수 있도록 ~/.claude/settings.json에 추가하세요.

저장소를 클론(Clone)한 후, 스킬 (skill) 디렉토리를 에이전트 (agent)의 스킬 폴더로 복사하거나 심볼릭 링크 (symlink)를 생성하세요:

에이전트 (Agent)	스킬 디렉토리 (Skills Directory)
Claude Code	.claude/skills/ 또는 ~/.claude/skills/
...

# 예시: Claude Code에 전역 설치
git clone https://github.com/ersinkoc/project-architect.git
ln -s $(pwd)/project-architect ~/.claude/skills/project-architect
...

코딩 에이전트 (coding agent)와 대화를 시작하고 구축하고자 하는 내용을 설명하세요:

> plan my project: a CLI tool for managing dotfiles across machines

또는 다음 트리거 문구 (trigger phrases) 중 하나를 사용하세요:

• "plan my project"
• "spec this out"
• "architect a system for..."
• "help me plan"
• "what stack should I use"
• "generate a prompt"
• "break this into tasks"
• "I want to build X"

Discovery (탐색) -- 에이전트가 프로젝트에 대해 구조화된 질문(유형, 범위, 스택, 기능 등)을 던집니다.
SPECIFICATION.md (사양서) -- 생성되어 검토를 위해 제시됩니다.
IMPLEMENTATION.md (구현 계획) -- 기술적 결정, 패턴, 디렉토리 구조를 다룹니다.
TASKS.md (작업 목록) -- 파일 목록과 수락 기준 (acceptance criteria)이 포함된 순차적 작업 분할.
BRANDING.md (브랜딩) -- 선택 사항인 아이덴티티 가이드 (색상, 타이포그래피, 보이스).
PROMPT.md (프롬프트) -- 모든 내용이 하나의 실행 가능한 프롬프트로 합성됩니다.

다음 문서가 생성되기 전에 각 문서를 검토하고 승인합니다.

전체 파이프라인 (pipeline)을 모두 실행할 필요는 없습니다:

사용자의 말	발생하는 일
"Just the spec"	SPECIFICATION.md만 생성
...

이 스킬에는 각 생성 단계에 정보를 제공하는 상세 가이드가 포함되어 있습니다:

파일	목적
references/elicitation-guide.md	프로젝트 탐색을 위한 질문 프레임워크 (Question framework)
references/tech-stacks.md	트레이드오프 (Trade-offs)를 고려한 대화형 기술 스택 (Tech stack) 선택
references/design-patterns.md	선택 가이드가 포함된 패턴 카탈로그 (Pattern catalog)
references/specification-guide.md	SPECIFICATION.md를 위한 템플릿 및 규칙
references/implementation-guide.md	IMPLEMENTATION.md를 위한 템플릿 및 규칙
references/tasks-guide.md	TASKS.md를 위한 템플릿 및 규칙
references/branding-guide.md	BRANDING.md를 위한 템플릿 및 규칙
references/claude-code-prompt.md	PROMPT.md를 위한 템플릿 및 규칙

project-architect/
├── SKILL.md # 스킬 정의 (agentskills.io 형식)
├── plugin.json # Claude Code 플러그인 매니페스트 (plugin manifest)
...

이 스킬은 Agent Skills 사양을 따르며 다음 도구들과 호환됩니다:

Claude Code(플러그인 + 스킬), Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI, Roo Code, OpenCode, Kiro, 그리고 agentskills.io를 통한 30개 이상의 기타 에이전트들

MIT