agentic-dev

agentic-dev는 say828/template-* 레포를 조회해 설치하고, GitHub Project 기반 멀티에이전트 개발 환경까지 같이 구성하는 installer/orchestrator CLI다.

역할

이 저장소는 runtime app 자체를 들고 있는 template monorepo가 아니다.

• template app/runtime payload: say828/template-*
• installer/orchestration logic: agentic-dev
• source-of-truth implementation: src/**/*.ts
• published CLI/runtime entry: dist/**/*.js
• shared sub-agent assets: .agent, .claude, .codex
• target repo workflow/runtime automation: install 시 target repo에 주입

Interactive Flow

npx agentic-dev

wizard는 아래 정보를 모두 먼저 받는다.

• project directory
• project name
• GitHub repository
• GitHub credential source
• GitHub project mode
• GitHub project title
• template repo
• AI execution adapters
• workspace agent surfaces
• non-empty directory 진행 여부
• final confirmation

조작:

• ←/→: 이전/다음 화면 이동
• ↑/↓: 선택 이동
• Space: multi-select toggle
• Enter: 현재 화면 확정

중요:

• 모든 입력이 끝나기 전에는 clone/install/bootstrap을 실행하지 않는다.
• 최종 확인 뒤에만 GitHub repo/project, template install, workflow wiring을 실행한다.

After Confirm

CLI는 이 순서로 동작한다.

1. GitHub repository create-or-use
2. GitHub Project create-or-use
3. selected template-* repo clone
4. shared .agent, .claude, .codex asset install
5. .agentic-dev/orchestration.json / .agentic-dev/setup.json write
6. .github/workflows/agentic-orchestration.yml install
7. .agentic-dev/runtime/*.ts install
8. .agentic-dev/runtime/server.ts install
9. .env.example -> .env
10. pnpm install
11. selected template에 default frontend target이 있으면 Playwright/bootstrap

Workflow Contract

설치된 repo는 아래 orchestration surface를 가진다.

• sdd/02_plan/** push
• .agentic-dev/runtime/sdd_to_ir.ts
• .agentic-dev/runtime/sync_project_tasks.ts
• .agentic-dev/runtime/run_multi_agent_queue.ts
• .agentic-dev/runtime/dispatch_agents.ts
• .agentic-dev/runtime/dispatch_execute.ts
• .agentic-dev/runtime/close_completed_tasks.ts
• .agentic-dev/runtime/server.ts
• .github/workflows/agentic-orchestration.yml

즉 SDD planning 산출물이 push되면 workflow가 local orchestration server를 띄우고, 그 서버가 task IR, GitHub task mirror, multi-agent queue, dispatch plan, dispatch execution, close pass를 처리하는 구조다.

GitHub Credential Source

이 선택은 사용자 레포가 퍼블릭인지 프라이빗인지 묻는 단계가 아니다.

• gh-session
  • 현재 머신의 gh auth login 세션을 GitHub repo/project orchestration에 사용한다.
• env
  • GH_TOKEN, GITHUB_TOKEN, AGENTIC_GITHUB_TOKEN을 GitHub repo/project orchestration에 사용한다.
• pat
  • 이번 실행에서만 붙여넣은 PAT를 GitHub repo/project orchestration에 사용한다.

모든 모드에서 템플릿 후보는 동일하게 say828/template-* 레포들이다.

Non-interactive Example

npx agentic-dev init my-app \
  --template template-fullstack-mono \
  --project-name my-app \
  --github-repo say828/my-app \
  --github-project-title "My App Delivery" \
  --github-project-mode create-if-missing \
  --provider-profiles codex-cli,openai-api \
  --providers codex,claude \
  --yes

AI Execution Adapters

현재 프로파일은 실제 실행 adapter 기준이다.

• codex-cli
  • 로컬 codex CLI 세션을 사용한다.
• openai-api
  • OPENAI_API_KEY로 OpenAI Responses API를 직접 호출한다.
• claude-cli
  • 로컬 claude CLI 세션을 사용한다.
• anthropic-api
  • ANTHROPIC_API_KEY로 Anthropic Messages API를 직접 호출한다.
• ollama-self-hosted
  • 로컬 ollama 서버를 사용한다.

legacy 값인 codex-subscription, codex-api, claude-subscription, claude-api는 내부에서 각각 codex-cli, openai-api, claude-cli, anthropic-api로 정규화된다.

즉 codex-api는 별도 독립 adapter가 아니고, OpenAI API 계열 direct adapter인 openai-api로 흡수된다.