agentic-dev

agentic-dev는 더 이상 앱 템플릿 정본이 아니다. 현재 이 repo의 canonical 역할은 새 GitHub repo 안에서 agentic-core와 template-* repo를 조합해 초기 프로젝트 baseline을 생성하는 installer CLI다.

Canonical Flow

1. GitHub에 새 repository를 만든다.
2. 그 repo를 clone한다.
3. repo root에 .git만 있는 상태에서 아래를 실행한다.

npx @say828/agentic-dev init

4. CLI는 다음을 단계별로 묻는다.
   • agentic-core repo/ref
   • do4ai 조직의 template-* repo 선택
   • template ref
   • 앱 slug / display name / bootstrap email
   • GitHub owner / repository / project
5. CLI는 template materialize -> token render -> agentic-core sync -> repo-local contract/bootstrap -> exact commit lock 생성 순서로 세팅한다.

What Gets Generated

• agentic-core canonical harness
  • .claude/
  • .codex/
  • sdd/ shared inventory
  • scripts/agentic-core/
• template runtime/app code
• repo-local GitHub Project agentic surface
  • .claude/agentic-dev.json
  • .codex/agentic-dev.json
  • sdd/99_toolchain/01_automation/github-project-kit/project-contract.json
  • sdd/99_toolchain/01_automation/github-project-kit/artifact-contract.json
• provenance lock
  • .agentic-dev-lock.json

Preconditions

• current directory must already be a Git repo root
• the repo should be empty except for .git
• gh, git, python3, node must be installed
• GitHub auth must have repo/project permissions
• target GitHub repository must already exist

Template Contract

template repo는 optional .agentic-dev/template.json을 통해 installer에 override를 줄 수 있다.

• artifact_contract 또는 artifactContract
• render_excludes

없으면 installer는 generic artifact contract baseline을 사용한다.

Development

npm test
node src/cli.js --help

Notes

• template 정본은 별도 template-* repo가 소유해야 하며, 첫 기준 템플릿은 palcar를 일반화한 template-fullstack-mono를 전제로 한다.
• installer repo 자체에는 .agent 같은 로컬 런타임 상태 파일을 정본으로 두지 않는다.