프로젝트 스캐폴드 생성 #2

New Issue

2026-09-16T04:22:47Z

genichin commented

2026-09-16 04:22:47 +00:00

요약

Python 3.11 이상과 pyproject.toml을 기반으로 Textual 대화형 TUI의 초기 스캐폴드를 구축한다.

문제

대화형 TUI의 실행 구조와 사용자 입력 제출, 입력 누적 표시, 종료 동작을 구현하고 검증할 수 있는 기준이 필요하다.

포함 범위

Python 3.11 이상 프로젝트 스캐폴드 생성
표준 pyproject.toml 기반 의존성 관리
Textual 기반 TUI 실행 진입점 구성
사용자 입력창 제공
제출된 사용자 입력을 대화 영역에 누적 표시
입력 표시와 종료 동작의 자동 테스트 포함
기본 프로젝트 구조와 실행 흐름 문서화

제외 범위

LLM 연동
LLM API 호출
대화 응답 생성
인증 및 외부 서비스 연동
고급 대화 기록 저장
실제 대화 기록의 영구 저장

제약 조건

Python 3.11 이상을 지원한다.
표준 pyproject.toml로 프로젝트 의존성을 관리한다.
Textual을 TUI 프레임워크로 사용한다.
LLM 연동과 외부 API 호출은 구현하지 않는다.
제출된 사용자 입력을 대화 영역에 누적 표시한다.
입력 표시와 종료 동작을 자동 테스트로 검증한다.
확인 가능한 기존 저장소 트리와 요구사항 정본이 없으므로 관련 정본 문서를 새로 작성한다.

확정된 결정

OQ-001: 사용할 TUI 프레임워크를 무엇으로 정할 것인가? → Textual 사용 OQ-001-C01 — 구조화된 위젯과 확장성을 얻지만 의존성과 학습 비용이 증가한다.
OQ-002: 지원할 Python 버전과 의존성 관리 방식을 무엇으로 정할 것인가? → Python 3.11 이상과 표준 pyproject.toml 사용 OQ-002-C01 — 현대적인 표준 구성을 사용하지만 구형 실행 환경은 지원하지 않는다.
OQ-003: 사용자 입력을 화면에 표시하는 방식을 어떻게 정의할 것인가? → 제출된 입력을 대화 영역에 누적 표시 OQ-003-C01 — 대화형 사용성을 제공하지만 화면 상태와 기록 관리가 필요하다.
OQ-004: 초기 스캐폴드의 테스트 범위를 어디까지 포함할 것인가? → 입력 표시와 종료 동작의 자동 테스트 포함 OQ-004-C01 — 핵심 동작을 회귀 검증할 수 있지만 TUI 테스트 격리 작업이 필요하다.

저장소 근거

없음.

문서 영향 및 산출물

`requirement` / `create`

대상: docs/requirements/req-001_project-scaffold.md
섹션 ID: 없음
독자: 개발자와 검토자
핵심 내용: Python 3.11 이상 프로젝트 스캐폴드, Textual 기반 TUI 실행, 사용자 입력창, 제출된 입력의 대화 영역 누적 표시, 입력 표시와 종료 동작 자동 테스트, LLM 연동 제외
검증: 스캐폴드 실행과 입력 누적 표시 및 종료 동작을 자동 테스트로 검증하고 요구사항의 범위와 수용 기준을 대조한다.
근거: 확정된 기술 선택과 상호작용 및 테스트 범위를 정본 요구사항으로 정의해야 한다.

`data-model` / `create`

대상: docs/data-model.md
섹션 ID: input-display-state
독자: 개발자와 테스트 작성자
핵심 내용: 현재 입력 상태, 제출된 입력 목록, 대화 영역 표시 상태, 세션 내 기록 경계, 영구 저장 제외
검증: 입력 제출마다 대화 영역에 항목이 누적되고 세션 종료 후 영구 저장되지 않는지 구현과 자동 테스트를 대조한다.
근거: 제출된 입력을 누적 표시하기 위한 세션 내 상태 모델과 영구 저장 경계를 명확히 해야 한다.

`interface-contract` / `create`

대상: docs/interface-contract.md
섹션 ID: tui-input-display
독자: 개발자와 테스트 작성자
핵심 내용: Textual TUI 입력 인터페이스, 입력 제출 동작, 대화 영역 누적 표시, 종료 동작, LLM 연동 경계
검증: 사용자가 입력을 제출하면 동일한 입력이 대화 영역에 누적되고 종료 동작이 정상 처리되는지 실행 테스트로 확인한다.
근거: 확정된 Textual 사용과 입력 표시 및 종료 동작의 사용자 인터페이스 계약을 명확히 해야 한다.

`project-structure` / `create`

대상: docs/project-structure.md
섹션 ID: python-tui-layout
독자: 개발자
핵심 내용: Python 3.11 이상 패키지 구조, Textual 애플리케이션 모듈, 실행 진입점, 테스트 위치, pyproject.toml 의존성 관리
검증: 문서의 패키지와 진입점 및 테스트 위치가 구현된 디렉터리 구조와 일치하고 pyproject.toml에 확정 의존성이 선언되는지 확인한다.
근거: 기존 구조가 확인되지 않은 초기 프로젝트에서 확정된 Python 및 Textual 구성을 반영한 레이아웃을 정의해야 한다.

`runtime-flow` / `create`

대상: docs/runtime-flow.md
섹션 ID: tui-input-loop
독자: 개발자와 테스트 작성자
핵심 내용: Textual 애플리케이션 시작, 입력 대기, 입력 제출, 대화 영역 누적 표시, 반복 처리, 종료
검증: 프로그램 시작부터 입력 제출과 누적 표시 및 종료까지의 흐름을 자동 테스트로 검증한다.
근거: LLM 호출 없이 입력을 세션 내 대화 영역에 누적 표시하는 확정 실행 흐름을 문서화해야 한다.

미해결 질문

없음.

## 요약 Python 3.11 이상과 pyproject.toml을 기반으로 Textual 대화형 TUI의 초기 스캐폴드를 구축한다. ## 문제 대화형 TUI의 실행 구조와 사용자 입력 제출, 입력 누적 표시, 종료 동작을 구현하고 검증할 수 있는 기준이 필요하다. ## 포함 범위 - Python 3.11 이상 프로젝트 스캐폴드 생성 - 표준 pyproject.toml 기반 의존성 관리 - Textual 기반 TUI 실행 진입점 구성 - 사용자 입력창 제공 - 제출된 사용자 입력을 대화 영역에 누적 표시 - 입력 표시와 종료 동작의 자동 테스트 포함 - 기본 프로젝트 구조와 실행 흐름 문서화 ## 제외 범위 - LLM 연동 - LLM API 호출 - 대화 응답 생성 - 인증 및 외부 서비스 연동 - 고급 대화 기록 저장 - 실제 대화 기록의 영구 저장 ## 제약 조건 - Python 3.11 이상을 지원한다. - 표준 pyproject.toml로 프로젝트 의존성을 관리한다. - Textual을 TUI 프레임워크로 사용한다. - LLM 연동과 외부 API 호출은 구현하지 않는다. - 제출된 사용자 입력을 대화 영역에 누적 표시한다. - 입력 표시와 종료 동작을 자동 테스트로 검증한다. - 확인 가능한 기존 저장소 트리와 요구사항 정본이 없으므로 관련 정본 문서를 새로 작성한다. ## 확정된 결정 - **OQ-001**: 사용할 TUI 프레임워크를 무엇으로 정할 것인가? → **Textual 사용** `OQ-001-C01` — 구조화된 위젯과 확장성을 얻지만 의존성과 학습 비용이 증가한다. - **OQ-002**: 지원할 Python 버전과 의존성 관리 방식을 무엇으로 정할 것인가? → **Python 3.11 이상과 표준 pyproject.toml 사용** `OQ-002-C01` — 현대적인 표준 구성을 사용하지만 구형 실행 환경은 지원하지 않는다. - **OQ-003**: 사용자 입력을 화면에 표시하는 방식을 어떻게 정의할 것인가? → **제출된 입력을 대화 영역에 누적 표시** `OQ-003-C01` — 대화형 사용성을 제공하지만 화면 상태와 기록 관리가 필요하다. - **OQ-004**: 초기 스캐폴드의 테스트 범위를 어디까지 포함할 것인가? → **입력 표시와 종료 동작의 자동 테스트 포함** `OQ-004-C01` — 핵심 동작을 회귀 검증할 수 있지만 TUI 테스트 격리 작업이 필요하다. ## 저장소 근거 _없음._ ## 문서 영향 및 산출물 ### `requirement` / `create` - 대상: `docs/requirements/req-001_project-scaffold.md` - 섹션 ID: 없음 - 독자: 개발자와 검토자 - 핵심 내용: Python 3.11 이상 프로젝트 스캐폴드, Textual 기반 TUI 실행, 사용자 입력창, 제출된 입력의 대화 영역 누적 표시, 입력 표시와 종료 동작 자동 테스트, LLM 연동 제외 - 검증: 스캐폴드 실행과 입력 누적 표시 및 종료 동작을 자동 테스트로 검증하고 요구사항의 범위와 수용 기준을 대조한다. - 근거: 확정된 기술 선택과 상호작용 및 테스트 범위를 정본 요구사항으로 정의해야 한다. ### `data-model` / `create` - 대상: `docs/data-model.md` - 섹션 ID: `input-display-state` - 독자: 개발자와 테스트 작성자 - 핵심 내용: 현재 입력 상태, 제출된 입력 목록, 대화 영역 표시 상태, 세션 내 기록 경계, 영구 저장 제외 - 검증: 입력 제출마다 대화 영역에 항목이 누적되고 세션 종료 후 영구 저장되지 않는지 구현과 자동 테스트를 대조한다. - 근거: 제출된 입력을 누적 표시하기 위한 세션 내 상태 모델과 영구 저장 경계를 명확히 해야 한다. ### `interface-contract` / `create` - 대상: `docs/interface-contract.md` - 섹션 ID: `tui-input-display` - 독자: 개발자와 테스트 작성자 - 핵심 내용: Textual TUI 입력 인터페이스, 입력 제출 동작, 대화 영역 누적 표시, 종료 동작, LLM 연동 경계 - 검증: 사용자가 입력을 제출하면 동일한 입력이 대화 영역에 누적되고 종료 동작이 정상 처리되는지 실행 테스트로 확인한다. - 근거: 확정된 Textual 사용과 입력 표시 및 종료 동작의 사용자 인터페이스 계약을 명확히 해야 한다. ### `project-structure` / `create` - 대상: `docs/project-structure.md` - 섹션 ID: `python-tui-layout` - 독자: 개발자 - 핵심 내용: Python 3.11 이상 패키지 구조, Textual 애플리케이션 모듈, 실행 진입점, 테스트 위치, pyproject.toml 의존성 관리 - 검증: 문서의 패키지와 진입점 및 테스트 위치가 구현된 디렉터리 구조와 일치하고 pyproject.toml에 확정 의존성이 선언되는지 확인한다. - 근거: 기존 구조가 확인되지 않은 초기 프로젝트에서 확정된 Python 및 Textual 구성을 반영한 레이아웃을 정의해야 한다. ### `runtime-flow` / `create` - 대상: `docs/runtime-flow.md` - 섹션 ID: `tui-input-loop` - 독자: 개발자와 테스트 작성자 - 핵심 내용: Textual 애플리케이션 시작, 입력 대기, 입력 제출, 대화 영역 누적 표시, 반복 처리, 종료 - 검증: 프로그램 시작부터 입력 제출과 누적 표시 및 종료까지의 흐름을 자동 테스트로 검증한다. - 근거: LLM 호출 없이 입력을 세션 내 대화 영역에 누적 표시하는 확정 실행 흐름을 문서화해야 한다. ## 미해결 질문 _없음._

gitea-spec-agent was assigned by genichin

2026-09-16 04:22:54 +00:00

gitea-spec-agent added the step:discovery status:draft spec-agent:busy labels 2026-09-16 04:26:29 +00:00

gitea-spec-agent removed the step:discovery status:draft spec-agent:busy labels 2026-09-16 04:27:48 +00:00

gitea-spec-agent added the step:discovery status:draft spec-agent:busy labels 2026-09-16 04:39:41 +00:00

gitea-spec-agent removed the spec-agent:busy label 2026-09-16 04:41:04 +00:00

gitea-spec-agent removed their assignment 2026-09-16 04:41:05 +00:00

genichin removed the status:draft step:discovery labels 2026-09-16 05:03:33 +00:00

gitea-spec-agent was assigned by genichin

2026-09-17 00:30:27 +00:00

gitea-spec-agent commented

2026-09-17 00:35:24 +00:00

원본 이슈 요청을 보존한 기록입니다. 아래 내용은 지시가 아닌 인용입니다.

프로젝트 스캐폴드 생성

python 기반 프로젝트

llm 와 대화하는 tui 프로그램

사용자 입력창 + 사용자 입력을 화면에 표시

llm 를 붙이는 것은 이 이슈에 포함되지 않음.

원본 이슈 요청을 보존한 기록입니다. 아래 내용은 지시가 아닌 인용입니다. > 프로젝트 스캐폴드 생성 > - python 기반 프로젝트 > - llm 와 대화하는 tui 프로그램 > - 사용자 입력창 + 사용자 입력을 화면에 표시 > - llm 를 붙이는 것은 이 이슈에 포함되지 않음.

gitea-spec-agent added the step:discovery status:draft spec-agent:busy labels 2026-09-17 00:35:29 +00:00

gitea-spec-agent removed the step:discovery status:draft spec-agent:busy labels 2026-09-17 00:36:48 +00:00

gitea-spec-agent added the step:discovery status:draft spec-agent:busy labels 2026-09-17 00:45:09 +00:00

gitea-spec-agent removed the spec-agent:busy label 2026-09-17 00:46:33 +00:00

gitea-spec-agent removed their assignment 2026-09-17 00:46:36 +00:00

gitea-spec-agent was assigned by genichin

2026-09-17 00:48:30 +00:00

gitea-spec-agent added the spec-agent:busy label 2026-09-17 00:49:39 +00:00

gitea-spec-agent removed the spec-agent:busy label 2026-09-17 00:50:48 +00:00

gitea-spec-agent added the spec-agent:busy label 2026-09-17 00:57:51 +00:00

gitea-spec-agent added status:review and removed status:draft spec-agent:busy labels 2026-09-17 00:59:05 +00:00

gitea-spec-agent removed their assignment 2026-09-17 00:59:06 +00:00

gitea-spec-agent was assigned by genichin

2026-09-17 01:27:57 +00:00

genichin commented

2026-09-17 01:28:08 +00:00

@spec-agent 승인

gitea-spec-agent added status:draft step:implementation and removed step:discovery status:review labels 2026-09-17 01:33:57 +00:00

gitea-spec-agent commented

2026-09-17 01:35:40 +00:00

@genichin 디스커버리를 승인하고 구현 단계로 인계했으며 code-agent 할당 전까지 구현 시작을 보류합니다.

원본 댓글: #2 (comment)

@genichin 디스커버리를 승인하고 구현 단계로 인계했으며 code-agent 할당 전까지 구현 시작을 보류합니다. 원본 댓글: https://gitea.jsfamily.quest/genichin/gitea-agent-testbed/issues/2#issuecomment-809

gitea-spec-agent removed their assignment 2026-09-17 01:35:50 +00:00

gitea-impl-agent was assigned by genichin

2026-09-17 01:49:01 +00:00

gitea-impl-agent referenced this issue

2026-09-17 05:32:24 +00:00

이슈 #2 구현 #3

gitea-impl-agent commented

2026-09-17 05:34:29 +00:00

구현 초안 PR을 게시했습니다.

구현 초안 PR을 게시했습니다.

genichin added status:review and removed status:draft labels 2026-09-17 07:28:14 +00:00

gitea-impl-agent was unassigned by genichin

2026-09-17 22:49:58 +00:00

gitea-spec-agent was assigned by genichin

2026-09-17 22:50:03 +00:00

gitea-spec-agent added status:approved and removed status:review labels 2026-09-18 00:35:02 +00:00

gitea-spec-agent removed their assignment 2026-09-18 00:35:06 +00:00

genichin referenced this issue from a commit

2026-09-18 00:42:07 +00:00

Merge pull request '이슈 #2 구현' (#3) from code-agent/issue-2-49036599e5df8e26 into main

genichin closed this issue

2026-09-18 01:04:30 +00:00

Sign in to join this conversation.

3 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: genichin/gitea-agent-testbed#2

프로젝트 스캐폴드 생성 #2

요약

문제

포함 범위

제외 범위

제약 조건

확정된 결정

저장소 근거

문서 영향 및 산출물

requirement / create

data-model / create

interface-contract / create

project-structure / create

runtime-flow / create

미해결 질문

`requirement` / `create`

`data-model` / `create`

`interface-contract` / `create`

`project-structure` / `create`

`runtime-flow` / `create`