Skip to content

[rustjava-worklog-json-proposals-convention] docs: 회차 워크로그 .md+.json 규약 이식 - #15

Merged
Jun025 merged 1 commit into
mainfrom
feat/worklog-json-proposals-convention
Aug 26, 2026
Merged

[rustjava-worklog-json-proposals-convention] docs: 회차 워크로그 .md+.json 규약 이식#15
Jun025 merged 1 commit into
mainfrom
feat/worklog-json-proposals-convention

Conversation

@Jun025

Copy link
Copy Markdown
Owner

무엇을

cockpit 「후속 작업 추천」 커버리지에서 RustJava 만 docs/worklog디렉터리 자체가 없어 구조적으로 0건이었다.
qts 회차(2026-08-23)가 세운 규약을 스키마 발명 0 으로 복제해 이식한다. Rust 코드 변경 0.

  • AGENTS.md — 「Round Worklog docs/worklog/」 절. .md(사람 축) + .json(기계 축) 한 쌍,
    소비처(/api/proposalsscanRepoSimple)가 실제로 읽는 키 표, 그 밖의 키는 자유, 과거 소급 없음.
    CLAUDE.md@AGENTS.md 로 참조하므로 이 자리가 매 세션 상시 로드된다.
  • scripts/check-worklog-json.py — qts tests/guardrail/test_worklog_json_schema.py같은 6축 잠금.
  • .github/workflows/rust.ymlworklog_json job 1개(ubuntu 단일 러너). 6셀 rust 매트릭스에는 붙이지 않았다.
  • docs/worklog/2026-08-26-…{md,json} — 규약의 자기증명 1쌍 겸 docs/worklog/ 개시.

실측

기준선(2026-08-26 GET :4477/api/proposals): RustJava = json:0 · md:0 · proposals:0 +
archiveErr: fatal: pathspec 'docs/worklog' did not match any files ⇒ 08-23 실측이 지금도 참이고
처방은 «폴더 신설»이 맞다(wie 의 json:1 · proposals:0 과 다른 처방).

착지 전에는 수치가 바뀌지 않는다 — 소비처가 git archive origin/main 으로 읽는다.
착지 후 기대값 = json:1 · md:1 · proposals:2(캐시 60초).

잠금 돌연변이 대조쌍 6축 전건(제품 파일 개악 → red, 원복 → green): 7키 결손 / date↔파일명 불일치 /
처분 ref 형식 파괴 / 짝 .md 제거 / AGENTS.md 절 삭제 / JSON 파손.

cargo fmt --check rc=0 · cargo clippy --all -- -D warnings green ·
cargo test --alltest_timer_periodic 1건 간헐 실패는 선재 flake(단독 재실행 3/3 통과, 이 PR 은 Rust 무변경).

qts 규약 대비 다른 점

  • 잠금 구현: qts = pytest guardrail / 여기 = 단독 python3 스크립트 + CI job. 이 repo 에 pytest 가 없고,
    cargo test 로 옮기려면 문서 검사 하나 때문에 serde_json dev-dep + 6셀 빌드 비용이 든다. 검사 6축은 동일.
  • 문안 언어: qts AGENTS.md 는 한국어 / 이 repo AGENTS.md 는 영어라 주변 문체에 맞췄다. 키 이름은 동일.
  • 절 번호: qts §6.1(원장 파일 계약 하위) / 여기는 절 번호 체계가 없어 최상위 절.

한계 (정직한 대가)

규약을 심었다 ≠ 커버리지가 계속 는다. 이 repo 의 회차 기록 정본은 REPORT.md 라 워크로그가 DoD 에 없다 —
다음 회차들이 쓰지 않으면 수치는 이 회차 2건에서 멈춘다. 그 결정은 워크로그 proposals[0] 으로 넘겼다.

3게이트 평시 — 머지는 게이트② 검수자 몫.

@Jun025
Jun025 merged commit b3a4cf4 into mainAug 26, 2026
9 checks passed
@Jun025
Jun025 deleted the feat/worklog-json-proposals-convention branch August 26, 2026 02:57
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jun025