jira-ingest

Files (1)

• SKILL.md

SKILL.md (first lines)

# jira-ingest — Wiki Index/Log/Cross-ref 점진 갱신

> **Karpathy LLM Wiki 패턴** — synthesis 를 query-time 이 아니라 build-time 에 누적.
> dev-guide 가 생성/완료될 때마다 INDEX·LOG·cross-ref 를 멱등하게 점진 갱신.
> SSoT: `~/.claude/skills/_wiki-schema.md` (정책·schema·규칙 전부 그곳).

## Usage

```
/jira-ingest <ISSUE-KEY>                 # 기본 (의도는 자연어로 전달 또는 컨텍스트 추론)
/jira-ingest <ISSUE-KEY> --subtasks      # 부모 + 슬라이스 일괄 (유일한 명시 플래그)
/jira-ingest                             # 인자 없이 — corpus 수준 의도 (bootstrap / backfill 등) 자연어로
```

**호출 모드는 사용자 자연어에서 추론**한다. 플래그 explosion 회피.
유일한 예외: `--subtasks` — `_subtasks-convention.md` 와 mechanical 일관성 필요.

## ⛔ Guard — Wiki 자산 존재 확인 (최우선)

스킬 시작 직후 다음 3 항목 점검. 결과에 따라 분기:

| 점검 | 부재 시 행동 |
|------|-------------|
| `docs/` 디렉토리 | 사용자에게 "docs/ 디렉토리 만들까요? 다른 경로 (예: `documentation/`) 사용하시나요?" 확인 |
| `docs/INDEX-SCHEMA.md` | **First-run onboarding flow** (§ 1) 진입 |
| `docs/INDEX.md` | **Bootstrap flow** (§ 2) 진입 (schema 는 있음 = onboarding 끝남) |

세 가지 모두 정상이면 → § 3 (정상 ingest) 로.

---

## § 1. First-run Onboarding — 새 프로젝트에서 처음 호출됐을 때

`docs/INDEX-SCHEMA.md` 가 없으면 wiki 자체가 미설정 상태. 사용자에게 안내 후 schema 부트스트랩.

### 1-1. ISSUE_PREFIX 추론

프로젝트 Jira 키 prefix 자동 감지 (예: `STD`, `PROJ`, `SCRUM`):

1. `CLAUDE.md` / `README.md` 에서 `\b[A-Z]+-\d+\b` 패턴 가장 빈도 높은 prefix
2. 추론 실패 시 `mcp__atlassian__getVisibleJiraProjects` → 사용자에게 어느 프로젝트인지 확인
3. 위 둘 다 실패 시 사용자에게 직접 질문 ("Jira 이슈 키 prefix 는? 예: STD")

### 1-2. 사용자 확인 + Schema 작성

`_wiki-schema.md` § 2 의 default schema 를 보여주고 (ISSUE_PREFIX 만 치환), 다음 확인:

```
🆕 첫 실행 감지 — 이 프로젝트는 아직 wiki 가 설정되지 않았습니다.

다음 자산을 생성합니다:
  📁 docs/INDEX-SCHEMA.md   (프로젝트 schema, git tracked)
  📁 docs/INDEX.md          (LLM-maintained 카탈로그)
  📁 docs/LOG.md            (이벤트 로그, append-only)

추론된 설정:
  ISSUE_PREFIX = <STD>
  카테고리     = foundational / decisions / issue_guides / sprint / setup (5종)
  bounded_writes.forbidden = PRD / DB schema / 코드 파일 일체

진행할까요? (yes / 카테고리 조정 / 취소)
```

사용자 승인 시:
- `docs/INDEX-SCHEMA.md` 작성 (default schema, ISSUE_PREFIX 치환)
- `docs/INDEX.md` 빈 골격 작성 (헤더 + ingest-managed 마커)
- `docs/LOG.md` 헤더 1줄 + BOOTSTRAP 라인

이어서 § 1-3 (CLAUDE.md 보강 안내) → § 2 bootstrap 으로 자동 진행.

### 1-3. CLAUDE.md 보강 안내 — wiki 자산 가시화

`_wiki-schema.md` § 15 의 `claude_md_integration` 정책 적용 (default `auto-patch`).

**왜 필요한가**: 미래 LLM 세션은 CLAUDE.md 만 자동 로드 → 이 안내가 없으면 INDEX.md / LOG.md 의 존재를 모르고 dev-guide 작업 중 wiki 활용 안 함.

**탐지**:
```
CLAUDE.md grep "docs/INDEX.md"
  매칭 있음 → 이미 안내됨, 생략
  매칭 없음 → 보강 진행
```

**announce 모드 (CLAUDE.md 무수정 — schema 에서 명시적으로 선택 시)**:

```
📌 권장: CLAUDE.md 에 wiki 자산 안내를 추가하세요
   (jira-ingest 는 CLAUDE.md 를 자동 수정하지 않습니다 — 사용자가 직접 commit)

"Planning Docs" 또는 "Reference Docs" 표 끝에 다음 3 row:

| Wiki Index  | dev-guide 카탈로그·상태 조회        | docs/INDEX.md         |
| Wiki Log    | ingest 이벤트 로그 (append-only)    | docs/LOG.md           |
| Wiki Schema | 카테고리·정책 (사용자 편집)         | docs/INDEX-SCHEMA.md  |

또는 "Key Rules" 에 1줄 추가:
- **ALWAYS** 새 dev-guide 작성 후 자동으로 INDEX/LOG 갱신
  (jira-plan / jira-complete chain. 누락 시 `/jira-ingest <KEY>` 수동 호출)
```

**auto-patch 모드 (default)**:
- "Planning Docs 표 끝에 3 row 를 자동 추가할까요? [y/n]" 1회 confirm
- y → Edit 툴로 target_section 헤더 직후 표 끝 anchor 찾아 append
- 표 헤더 매칭 실패 시 → announce 폴백

**skip 모드**: 안내 자체 생략 (실험적 셋업 또는 wiki 가 일시적).

---

## § 2. Bootstrap — 기존 dev-guide 일제 카탈로그화

`docs/INDEX-SCHEMA.md` 는 있는데 `docs/INDEX.md` 가 없거나 비어있으면, 또는 사용자가 "bootstrap" / "처음 카탈로그화" 의도를 보이면.

### 2-1. 5+1 Pass 알고리즘

**Pass 1: Inventory** (glob 만, ~1분)
```
glob: docs/**/*.md, sprint/**, setup/**, ops/**, qa/**, external/**, data/**
match → INDEX-SCHEMA.categories

From bigbulgogiburger/claude_jira_harness, MIT.

More from bigbulgogiburger/claude_jira_harness