docs: add common command failures and solutions #12

agentson · 2026-02-04T09:56:32+09:00

agentson commented

2026-02-04 09:56:32 +09:00

Summary

반복 실패를 방지하기 위한 명령어 실패 패턴과 해결책을 문서화했습니다.

Changes

새로 추가된 섹션: Common Command Failures

각 실패 패턴마다 다음 정보 포함:

❌ 실패하는 명령어
💡 실패 이유
✅ 성공하는 명령어
📝 참고사항

문서화된 실패 패턴

1. tea CLI

TTY Error: YES="" 환경변수로 interactive 확인 우회
Wrong Parameter: --description (not --body)

2. Gitea API

Wrong Hostname: localhost:3000 (not gitea.local)

3. Git Commands

User Not Configured: git config 설정 필요
Permission Denied: 저장소 write 권한 확인

4. Python/Pytest

Module Import Error: pip install -e ".[dev]" 필요
Async Test Hangs: asyncio_mode="auto" 설정 (이미 완료)

Testing

문서 변경사항이므로 별도 테스트 불필요.

References

Closes #11

## Summary 반복 실패를 방지하기 위한 명령어 실패 패턴과 해결책을 문서화했습니다. ## Changes ### 새로 추가된 섹션: Common Command Failures 각 실패 패턴마다 다음 정보 포함: - ❌ 실패하는 명령어 - 💡 실패 이유 - ✅ 성공하는 명령어 - 📝 참고사항 ### 문서화된 실패 패턴 #### 1. tea CLI - **TTY Error**: `YES=""` 환경변수로 interactive 확인 우회 - **Wrong Parameter**: `--description` (not `--body`) #### 2. Gitea API - **Wrong Hostname**: `localhost:3000` (not `gitea.local`) #### 3. Git Commands - **User Not Configured**: git config 설정 필요 - **Permission Denied**: 저장소 write 권한 확인 #### 4. Python/Pytest - **Module Import Error**: `pip install -e ".[dev]"` 필요 - **Async Test Hangs**: asyncio_mode="auto" 설정 (이미 완료) ## Testing 문서 변경사항이므로 별도 테스트 불필요. ## References Closes #11

agentson added 1 commit 2026-02-04 09:56:32 +09:00

docs: add common command failures and solutions

CI / test (pull_request) Has been cancelled

Details

91698a6400

- Document tea CLI TTY errors and YES="" workaround
- Record wrong parameter names (--body vs --description)
- Add Gitea API hostname corrections
- Include Git configuration errors
- Document Python/pytest common issues

Each failure includes:
- ❌ Failing command
- 💡 Failure reason
- ✅ Working solution
- 📝 Additional notes

Closes #11

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

agentson force-pushed feature/issue-11-command-failures from 91698a6400 to 3dd222bd3b

2026-02-04 10:02:47 +09:00

Compare

jihoson merged commit 3c676c2b8d into main

2026-02-04 10:03:29 +09:00

jihoson referenced this issue from a commit

2026-02-04 10:03:30 +09:00

Merge pull request 'docs: add common command failures and solutions' (#12) from feature/issue-11-command-failures into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: jihoson/The-Ouroboros#12