astro:help — 파이프라인 사용법
astro: 파이프라인은 계약부터 PR/배포까지 IA로 개발하기 위한 스킬 모음이며, 코드 보호 장치(게이트)가 보안 장벽을 강제합니다. 각 스킬은 하나의 단계이며, 순서대로 사용하되 필요한 것만 호출하세요.
파이프라인 한눈에 보기
| 단계 | 명령어 | 사용 시점 |
|---|---|---|
| 0 · 계약 | astro:setup | 프로젝트 시작/재개 시, 코드 작성 전에 |
| 1 · 계획 | astro:plan | 변경 사항을 설명하고 구현 전 계획을 원할 때 |
| 2 · 실행 | astro:exec | 전체 계획을 한 번에 하나의 태스크씩 실행 |
| 3 · 마무리 | astro:commit | 논리적 변경에 대한 메시지 생성 및 커밋 |
| 3 · 마무리 | astro:pr | Pull Request 설명 작성 |
| 3 · 마무리 | astro:answer | QA/PO를 위한 태스크 전달 문서 (로컬 파일) |
| 게이트 | astro:gate | 브라우저에서 게이트 규칙 편집기 열기 |
| 도움말 | astro:help | 이 가이드 |
일반적인 흐름
astro:setup(프로젝트당 한 번) —CLAUDE.md에 계약(장벽 + 패턴)을 명시하고, 스택을 감지하여 Laravel의 경우 아키텍처를 다운로드하고 도메인별AGENTS.md를 보장합니다. 게이트를 설치합니다: 미니 앱ai-gate/(SQLite)가.claude/hooks/astro_gate.py를 생성하고 금지 명령을 차단하는 훅을 등록합니다.astro:plan— 변경 사항을 설명하면 상황을 파악하고 사용자의 결정이 필요한 것만 AskUserQuestion으로 물은 후, 계획을 제안하고 승인 후 세션 내 태스크로 분해합니다 (프로젝트 파일 생성 없음).astro:exec— 계획을 한 번에 하나의 태스크씩 실행하며, 범위 내에서만 구현하고 계약과 아키텍처를 따르며 실제 테스트(실제 출력)를 수행합니다.astro:commit—TIPO: Título형식의 메시지 + 변경 목록 (브라질 포르투갈어, 과거분사); 논리적 변경당 하나의 커밋.- 마무리:
astro:pr(PR 설명) 및/또는astro:answer(QA/PO를 위한 전달 텍스트, 커밋되지 않는 로컬 파일에 저장).
게이트 (코드가 보장)
프롬프트가 안내하고, 게이트가 보장: 모든 명령 실행이 검사되며 금지 텍스트(migrate:fresh, rm -rf, git push --force, truncate…)가 포함되면 차단. 규칙은 편집 가능:
astro:gate(또는python3 ai-gate/app.py)로 UI(http://127.0.0.1:8787)를 열어 규칙 추가/편집/비활성화; 게이트 생성이.claude/hooks/astro_gate.py를 다시 작성합니다.- 생성된 게이트는 독립 실행형 — VM/CI에서 CLI로도 실행 가능:
python3 astro_gate.py "$CMD" && eval "$CMD".
모든 단계에 적용되는 원칙
- 사용자의 결정이 필요한 것만 묻고, 나머지는 결정 (안전한 기본값으로, 가정을 알림).
- 출처에서 확인하고, API/경로/컬럼/버전을 임의로 만들지 않음.
- 작고 검토 가능한 변경; 테스트 함께; 실제 증거, 주장이 아닌.
- 파괴적인 작업 금지, 비밀 금지, 의존성 업로드 금지 — 게이트가 이를 강화.