docs: add onboarding docs and setup scripts (fix missing files from #6)

[Copilot]

Files intended to land in PR #6 never appeared in the repo. This PR adds them.

Documentation

• README.md — Replaced the raw planning doc with a concise Korean README: concept, purpose, key features, quick start, and pointers to USER_GUIDE.md / docs/PLAN.md
• docs/PLAN.md — Preserves the original README planning/architecture content under a dedicated archive header
• USER_GUIDE.md — Step-by-step Korean guide covering install, .env setup, agent integration (curl / Claude Code hook / shell / git hook), approve/reject flow, UNDO rollback, and security recommendations

Setup Scripts

• scripts/setup_env.sh — Interactive Bash prompt → writes .env
• scripts/setup_env.ps1 — Same for Windows PowerShell
• scripts/configure.js — Node.js interactive setup via prompts with port validation; safely skips or overwrites existing .env

package.json

Added two script entries and prompts devDependency (no other changes):

"scripts": {
  "setup":     "sh scripts/setup_env.sh",
  "configure": "node scripts/configure.js"
},
"devDependencies": {
  "prompts": "^2.4.2"
}

Environment

• .env.example — Placeholder for MAIN_REPO_PATH, PORT, MAESTRO_SERVER_TOKEN, VITE_WS_URL
• .gitignore already excludes .env — no change needed

Original prompt

Create a corrective PR that adds the missing onboarding documentation and setup scripts that were intended in PR #6 but did not appear in the repository. The PR should add the following files to the repository redsunjin/maestro-coding on a new branch (name: docs/add-onboarding-docs).

Goals

• Ensure the planning document is preserved in docs/PLAN.md (copy current README.md content into this file).
• Add a new public README.md (concise concept, purpose, quick start, pointer to USER_GUIDE.md and docs/PLAN.md) in Korean.
• Add USER_GUIDE.md with detailed install/use/agent integration/testing/undo/security guidance in Korean (use content from earlier chat conversation).
• Add .env.example with placeholder env variables.
• Add setup scripts for convenience: scripts/setup_env.sh, scripts/setup_env.ps1, scripts/configure.js (Node interactive using prompts).
• Add package.json script entries if package.json exists, updating only scripts and devDependencies (merge safely). If package.json does not exist, create a minimal one with the scripts & devDependencies.
• Ensure .gitignore contains .env (do not commit real secrets).
• Create a PR titled: "docs: add onboarding docs and setup scripts (fix missing files from [WIP] Add documentation and setup scripts for onboarding improvement #6)" with an appropriate PR description explaining why these files are added and that they were missing after PR [WIP] Add documentation and setup scripts for onboarding improvement #6.

Files and contents to add (exact content to be created):

1. docs/PLAN.md

# 기획 / 아키텍처 문서 보관소 (PLAN)

이 파일은 기존 README.md(기획 문서)를 보관하는 용도로 사용합니다.
프로젝트 초기 기획, 아키텍처, 실험 메모, 설계 결정 사항 등 변경·보존해야 하는 문서를 이곳으로 옮겨주세요.

---
(여기에 기존 README.md의 기획/아키텍처 전문을 그대로 옮겨주세요.)

2. README.md

# Maestro Coding

코딩을 지휘하다 — AI 에이전트와 함께하는 코드 심포니 🎼

## 컨셉(Concept)
Maestro는 AI 에이전트가 생성하거나 수정한 코드 변경을 "승인 노트" 형태로 제시하고, 사람이 빠르게 승인/반려하여 안전하게 병합하도록 돕는 개발 보조 도구입니다.

## 만든 목적(Purpose)
- AI 에이전트 자동 생성 코드를 인간이 빠르게 확인하고 승인할 수 있도록 가시화
- 승인(merge) 워크플로우를 단순화하여 생산성 향상
- 로컬 개발 환경에서 안전하게 에이전트와 협업할 수 있는 도구 제공

## 주요 기능(At a glance)
- 에이전트가 POST /api/request 로 승인 요청 전송
- Maestro 서버는 WebSocket으로 대시보드에 알림 브로드캐스트
- 사용자가 대시보드에서 APPROVE/REJECT/UNDO 조작 가능
- 승인 시 서버에서 로컬 git 병합(merge)을 수행

## 빠른 시작(Quick Start)
1. 레포지토리 클론
   git clone https://github.com/redsunjin/maestro-coding.git
2. 의존성 설치 (필요한 경우)
   npm install
3. 설정 파일(.env) 준비
   - 루트에 `.env` 또는 환경변수로 설정.
   - 예: `MAIN_REPO_PATH=/path/to/your/main/repo`
4. 서버 실행
   MAIN_REPO_PATH=/path/to/your/main/repo node maestro-server.js
5. 에이전트(또는 훅)에서 승인 요청 전송 (예시)
   curl -X POST http://localhost:8080/api/request \
     -H 'Content-Type: application/json' \
     -d '{"agentId":"local_agent","branchName":"feature/x","diffSummary":{"title":"작업 완료","shortDescription":"변경요약"}}'

## 설치 가이드(Installation)
자세한 설치/사용법은 USER_GUIDE.md를 참고하세요.

## 기획 문서 / 아키텍처
기획 및 아키텍처 문서는 `docs/PLAN.md`로 분리되어 있습니다.

## 기여 방법(Contributing)
- 이 레포는 오픈 실험용입니다. 기여하려면 이슈를 남기고 PR을 보내주세요.
- 민감 정보(토큰 등)는 절대 커밋하지 마세요. `.env`를 사용하세요.

3. USER_GUIDE.md

# 사용자 가이드 (User Guide)

이 문서는 로컬에서 Maestro를 설치하고, 에이전트(예: VS Code, 훅 스크립트)와 연동해 승인 플로우를 테스트하는 방법을 단계별로 안내합니다.

목차
- 요구사항(Prerequisites)
- 빠른 설치(Quick install & run)
- 환경변수(.env) 설정 방법
- 에이전트 연동 예제 (curl / 훅 / VS Code)
- 승인(Approve) 시나리오 테스트
- 롤백(UNDO) 사용법
- 보안 권장사항

---

## 요구사항
- Node.js (v16+ 권장)
- Git (로컬에 병합 가능한 레포가 있어야 함)

## 빠른 설치 & 실행
1. 소스 클론
   git clone https://github.com/redsunjin/maestro-coding.git
   cd maestro-coding

2. (선택) 의존성 설치
   npm install

3. .env 준비
   - 루트에 `.env` 파일을 생성하거나 환경변수로 설정.
   - 최소값:
     - MAIN_REPO_PATH: 병합을 수행할 메인 레포지토리의 로컬 경로
     - PORT (선택, 기본 8080)
     - MAESTRO_SERVER_TOKEN (선택, 인증을 사용할 경우)
   예시 `.env`:

MAIN_REPO_PATH=/home/user/projects/my-main-repo
PORT=8080
MAESTRO_SERVER_TOKEN=very-secret-token

4. 서버 실행
- 환경변수 방식:
  MAIN_REPO_PATH=/path/to/main/repo node maestro-server.js
- 또는 dotenv 사용:
  node -r dotenv/config maestro-server.js

## 에이전트 연동 예제
1) curl로 승인 요청 보내기

curl -X POST http://localhost:8080/api/request
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <TOKEN_IF_USED>'
-d '{
"agentId":"local_agent",
"branchName":"feature/test-branch",
"diffSummary": { "title":"작업 완료", "shortDescription":"파일 A 수정" }
}'

2) Git 훅(예: notify-maestro.sh)
- 레포 내 hooks/notify-maestro.sh를 사용하면 커밋/훅에서 자동으로 Maestro에 요청을 보낼 수 있습니다.
- 사용 전에 `MAESTRO_URL` 환경변수를 설정하세요:
  export MAESTRO_URL=http://localhost:8080
  ./hooks/notify-maestro.sh feature/my-branch "제목" "간단한 변경 요약"

3) VS Code 연동
- 간단한 방법: `.vscode/settings.json`에 `maestro.url` 설정을 추가하거나, 작업(Task)으로 curl 명령을 만들어 실행.

## 승인(Approve) 테스트 방법
1. 에이전트가 `POST /api/request` 호출 → 서버는 WebSocket으로 AGENT_TASK_READY 이벤트를 보냅니다.
2. 대시보드(또는 WebSocket 클라이언트)에서 아래 메시지를 서버로 전송하여 승인 시뮬레이션:

{"action":"APPROVE","requestId":"req_...","branchName":"feature/test-branch"}

3. 서버는 MAIN_REPO_PATH에서 `git merge feature/test-branch`를 실행합니다.

## 롤백(UNDO)
- 사용자가 UNDO를 트리거하면 서버는 메인 레포에서 `git reset --hard HEAD~1`을 실행합니다.
- 주의: 롤백은 데이터 손실을 초래할 수 있으므로 테스...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

*This pull request was created from Copilot chat.*
>

<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more [Copilot coding agent tips](https://gh.io/copilot-coding-agent-tips) in the docs.