ko.md

시작 가이드

준비 사항

협업에는 Git을 사용하며 추적 가능한 release candidate에는 Git이 필수입니다. Plugin을 지원하는 AI client가 서비스 발견에 편리하지만 생성된 저장소에는 독립적인 Skill과 Markdown fallback도 들어갑니다. Go 1.26 이상은 source에서 직접 build할 때만 필요합니다.

GitHub에서 설치

codex plugin marketplace add kcrmin/Stackcord --ref v1.0.0
codex plugin add stackcord@stackcord

설치된 snapshot에서 다섯 Stackcord Skill과 lifecycle hook을 불러오도록 설치 후 새 Codex 대화를 시작합니다.

검증된 release bundle 설치

현재 platform용 Plugin zip과 checksums.txt를 함께 내려받아 SHA-256을 확인하고 압축을 풉니다. Bundle에는 .agents/plugins/marketplace.json, 5개 Skill, lifecycle hook, project template, macOS·Windows bootstrap script, distribution/platform.json이 들어 있습니다. Platform record는 Plugin version을 맞는 CLI asset과 checksum URL에 연결합니다.

AI에게 “이 검증된 bundle을 local에 설치해줘”라고 말하면 platform record를 확인하고 checksum-first bootstrap을 사용할 수 있습니다. 압축을 푼 Plugin을 Codex CLI로 설치할 때는 해당 directory를 local marketplace로 추가하고 표시된 Plugin을 설치합니다.

codex plugin marketplace add /absolute/path/to/unpacked/stackcord
codex plugin add stackcord@stackcord

Bootstrap은 test용 loopback HTTP를 제외하면 HTTPS release URL만 받고 checksum과 doctor smoke test를 통과한 뒤 CLI를 원자적으로 교체합니다. Hook은 software를 download하거나 설치하지 않습니다.

CLI build

제품 저장소에서 실행합니다.

cd cli
go test ./...
go build -o ../bin/stackcord ./cmd/stackcord

Windows PowerShell에서는 go build -o ..\bin\stackcord.exe .\cmd\stackcord를 사용합니다. 생성된 binary를 PATH에 두거나 AI에게 절대 경로를 알려줍니다. stackcord doctor --json으로 Git과 선택 capability를 진단할 수 있습니다. Source build는 contributor용이며 일반 사용자는 검증된 bundle을 권장합니다.

선택적 Plugin 설치

Source tree를 개발할 때는 이 저장소를 local marketplace로 추가하고 Plugins 또는 Codex CLI에서 설치합니다.

codex plugin marketplace add /absolute/path/to/stackcord

Codex CLI에서는 marketplace 추가 뒤 /plugins를 엽니다. Plugin 설치는 선택이며 생성된 프로젝트의 repo-local 동작은 유지됩니다.

AI와 대화로 시작

빈 parent directory에서는 “새 서비스를 같이 시작해줘”, 기존 저장소에서는 “기존 파일을 덮어쓰지 말고 이 프로젝트에 도입해줘”라고 말합니다. AI는 먼저 filesystem과 Git을 확인하고 알맞은 Skill을 읽은 뒤 결과를 바꾸는 질문을 하나씩 묻습니다. 발견이 이어지는 동안 정규화 checkpoint를 계속 저장합니다.

초기화 후에는 “지금 뭐 해야 해?”, “이 기능 만들어줘”, “Contract와 DB 영향을 확인해줘”, “Production candidate 준비해줘”처럼 요청합니다. 내부 ID나 command argument를 사용자가 관리할 필요가 없어야 합니다.

첫 결과 확인

README.md, AGENTS.md, .agents/skills/use-project-harness/, .harness/, specs/, contracts/, docs/가 있는지 확인합니다. AI에게 context audit과 Git inspect를 요청합니다. Audit은 저장소 파일을 근거로 사용하고 unknown이나 stale을 지어내지 말고 그대로 알려야 합니다.

다음 가이드

핵심 개념을 읽고 신규 프로젝트 또는 기존 프로젝트로 갑니다. 병렬 협업 전에는 작업 관리와 작업 선점을 봅니다. Clone·context·Git·선택 도구 상태가 불명확하면 문제 해결을 사용합니다.

편집 가능한 외부 목업이나 별도 UI 저장소가 필요하면 UI workspace와 외부 목업에서 directory와 submodule 중 맞는 경계를 선택합니다.