process: harden compact/new-session Gitea preflight and operation order #381

Closed
opened 2026-03-02 02:13:32 +09:00 by agentson · 4 comments
Collaborator

Summary

compact/new session 이후 Gitea 작업에서 도구/인증 프리플라이트가 누락되면,

  • gh 오사용
  • Gitea API 무토큰 호출(401)
  • 사용자 요청 순서(코멘트 확인 선행) 위반
    이 재발할 수 있다.

Problem

현행 워크플로우 문서에는 원칙이 있으나, 세션 시작 시 강제되는 실행 체크가 부족해 실제 작업에서 누락이 발생했다.

Scope

  • 세션 시작 프리플라이트 절차 강화 (tea/인증/원격/브랜치)
  • Gitea 작업에서 gh 차단 및 fallback 규칙 명확화
  • "PR 코멘트 확인 전 수정 금지" 같은 순서 가드 명문화
  • 필요 시 자동 점검 스크립트/체크리스트 추가

Acceptance Criteria

  • compact/new session 시작 직후 실행 가능한 표준 preflight 절차가 문서화되어 있다.
  • Gitea 이슈/PR/코멘트 작업에서 gh 사용 금지와 tea 우선 규칙이 절차로 검증된다.
  • PR 코멘트 확인 요청 시, 원격 코멘트 조회 성공 전 코드/문서 수정을 금지하는 가드가 명시된다.
  • 최소 1개 자동화 점검(스크립트 또는 CI 체크)으로 누락을 조기 탐지한다.

Why Now

동일 유형의 운영 실수 재발 가능성이 확인되어, 코드 이슈와 별개로 프로세스 개선을 트래킹해야 한다.

## Summary compact/new session 이후 Gitea 작업에서 도구/인증 프리플라이트가 누락되면, - `gh` 오사용 - Gitea API 무토큰 호출(401) - 사용자 요청 순서(코멘트 확인 선행) 위반 이 재발할 수 있다. ## Problem 현행 워크플로우 문서에는 원칙이 있으나, 세션 시작 시 강제되는 실행 체크가 부족해 실제 작업에서 누락이 발생했다. ## Scope - 세션 시작 프리플라이트 절차 강화 (`tea`/인증/원격/브랜치) - Gitea 작업에서 `gh` 차단 및 fallback 규칙 명확화 - "PR 코멘트 확인 전 수정 금지" 같은 순서 가드 명문화 - 필요 시 자동 점검 스크립트/체크리스트 추가 ## Acceptance Criteria - compact/new session 시작 직후 실행 가능한 표준 preflight 절차가 문서화되어 있다. - Gitea 이슈/PR/코멘트 작업에서 `gh` 사용 금지와 `tea` 우선 규칙이 절차로 검증된다. - PR 코멘트 확인 요청 시, 원격 코멘트 조회 성공 전 코드/문서 수정을 금지하는 가드가 명시된다. - 최소 1개 자동화 점검(스크립트 또는 CI 체크)으로 누락을 조기 탐지한다. ## Why Now 동일 유형의 운영 실수 재발 가능성이 확인되어, 코드 이슈와 별개로 프로세스 개선을 트래킹해야 한다.
Author
Collaborator

Status: NOT_STARTED
Observed At: 2026-03-02 23:15:19 KST, 2026-03-02 14:15:19 UTC
Environment: live
Evidence: N/A
Next: Begin live observation for this issue.

Status: NOT_STARTED Observed At: 2026-03-02 23:15:19 KST, 2026-03-02 14:15:19 UTC Environment: live Evidence: N/A Next: Begin live observation for this issue.
Author
Collaborator

Status: OBSERVING
Observed At: 2026-03-02 23:16:37 KST, 2026-03-02 14:16:37 UTC
Environment: live
Evidence: live observation window started
Next: Capture one concrete runtime evidence item to transition this issue to CONFIRMED.

Status: OBSERVING Observed At: 2026-03-02 23:16:37 KST, 2026-03-02 14:16:37 UTC Environment: live Evidence: live observation window started Next: Capture one concrete runtime evidence item to transition this issue to CONFIRMED.
Author
Collaborator

Status: OBSERVING
Observed At: 2026-03-03 08:16:52 KST, 2026-03-02 23:16:52 UTC
Environment: live
Evidence: Checked current runtime logs + trade_logs_live.db; no qualifying one-shot evidence yet for this issue's acceptance criteria.
Next: Continue targeted observation/reproduction for issue-specific trigger.

Status: OBSERVING Observed At: 2026-03-03 08:16:52 KST, 2026-03-02 23:16:52 UTC Environment: live Evidence: Checked current runtime logs + trade_logs_live.db; no qualifying one-shot evidence yet for this issue's acceptance criteria. Next: Continue targeted observation/reproduction for issue-specific trigger.
Author
Collaborator

Status: CONFIRMED
Observed At: 2026-03-03 08:36:42 KST, 2026-03-02 23:36:42 UTC
Environment: live

Detailed Check (loop):

  • Acceptance 1/2/3 충족 확인:
    • docs/workflow.md의 Agent Gitea Preflight + gh 금지/tea 우선 + PR 코멘트 확인/가드 규칙 존재
    • docs/commands.md의 Session Handover Preflight + tea 표준/gh 금지 절차 존재
  • Acceptance 4 자동 점검 충족:
    • scripts/validate_governance_assets.py 에 preflight/tea_comment/gh 관련 필수 토큰 점검 포함

Evidence:

  • docs/workflow.md
  • docs/commands.md
  • scripts/validate_governance_assets.py

Next:

  • 이슈 수용기준 충족으로 close 처리.
Status: CONFIRMED Observed At: 2026-03-03 08:36:42 KST, 2026-03-02 23:36:42 UTC Environment: live Detailed Check (loop): - Acceptance 1/2/3 충족 확인: - docs/workflow.md의 Agent Gitea Preflight + gh 금지/tea 우선 + PR 코멘트 확인/가드 규칙 존재 - docs/commands.md의 Session Handover Preflight + tea 표준/gh 금지 절차 존재 - Acceptance 4 자동 점검 충족: - scripts/validate_governance_assets.py 에 preflight/tea_comment/gh 관련 필수 토큰 점검 포함 Evidence: - docs/workflow.md - docs/commands.md - scripts/validate_governance_assets.py Next: - 이슈 수용기준 충족으로 close 처리.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jihoson/The-Ouroboros#381