Skip to content

ci, docs: job 이름 구분 + CLAUDE.md / 코드맵 추가, PDCA 규칙 제거 - #8

Merged
boinred merged 3 commits into
mainfrom
claude/gracious-keller-qe7alq
Oct 5, 2026
Merged

boinred merged 3 commits into
mainfrom
claude/gracious-keller-qe7alq

Conversation

@boinred

@boinred boinred commented Sep 28, 2026 •

Copy link
Copy Markdown
Owner

요약

1. CI job 이름에 워크플로 접두어 부여

build.yml과 dashboard.yml의 matrix job 이름이 둘 다 ${{ matrix.os }}여서 main ruleset 필수 체크에서 구분되지 않았습니다.

워크플로 변경 전 변경 후
build ubuntu-latest, macos-latest, windows-latest build (ubuntu-latest), build (macos-latest), build (windows-latest)
dashboard macos-latest, windows-latest dashboard (macos-latest), dashboard (windows-latest)
scaffold <os> / <flavor> 변경 없음

2. 에이전트 문서

  • CLAUDE.md 추가: @AGENTS.md, @docs/CODEMAP.md를 import해 Claude Code와 Codex가 같은 규칙을 사용. Claude 전용 메모(커밋 작성자, main 보호/필수 체크, builds/release 이름, golden hash 갱신 시점) 포함
  • docs/CODEMAP.md 추가: 프로젝트 의존 그래프, 디렉터리 맵, 엔진 타입별 역할, BaseSession 수신/송신/종료 흐름, 앱·템플릿 DI 구성과 패킷 추가 절차, 테스트·검증 도구, CI job, 주의사항(golden hash, 팩토리 파일명 뒤바뀜, 미사용 코드, macOS symlink 등) — 에이전트가 매번 트리를 다시 읽지 않도록
  • AGENTS.md: PDCA 자동화 규칙 삭제, "작업 전 코드맵 먼저 읽기 / 구조 변경 시 코드맵 갱신" 규칙 추가, 제목을 공용으로 변경
  • README 트리 주석과 Maui README의 PDCA 언급 제거 (Maui README는 삭제된 docs/archive/ 폴더를 가리키고 있었음)

⚠️ 머지 전 필요한 작업

main ruleset 필수 체크를 기존 ubuntu-latest 등에서 build (ubuntu-latest), build (macos-latest), build (windows-latest)로 바꿔야 머지 가능합니다.

검증

  • 새 이름의 체크 5개(build 3, dashboard 2) 통과 확인 (4e7be66)
  • 저장소 전체 .md 상대 링크 검사: 깨진 링크 0
  • 코드맵이 언급하는 파일·경로 존재 여부 스크립트로 확인, 타입·사용처(미사용 코드, 팩토리 파일명, scaffold 복사 대상)는 소스 grep으로 대조

🤖 Generated with Claude Code

https://claude.ai/code/session_01BQy9NxDcMgXNygFbZQbBnS

Both workflows named their matrix jobs just "${{ matrix.os }}", so the
build and dashboard checks were indistinguishable ("macos-latest",
"windows-latest") when selecting required status checks for the main
branch ruleset. Jobs now report as "build (<os>)" and "dashboard (<os>)".

Claude-Session: https://claude.ai/code/session_01BQy9NxDcMgXNygFbZQbBnS
- CLAUDE.md imports AGENTS.md and docs/CODEMAP.md so Claude Code and
  Codex share one rule set, plus Claude-specific git/PR and golden-hash
  notes.
- docs/CODEMAP.md: project graph, directory map, engine types, session
  data flow, app/template wiring, test tools, CI jobs and known pitfalls,
  so agents can locate code without re-reading the tree.
- AGENTS.md: remove the PDCA automation rule (no longer used), add a code
  map rule, retitle as shared Codex / Claude Code instructions.
- Remove remaining PDCA mentions from README trees and the Maui README
  (its docs/archive link pointed at a deleted folder).

Claude-Session: https://claude.ai/code/session_01BQy9NxDcMgXNygFbZQbBnS
@boinred boinred changed the title ci: build/dashboard job 이름에 워크플로 접두어 부여 ci, docs: job 이름 구분 + CLAUDE.md / 코드맵 추가, PDCA 규칙 제거 Oct 5, 2026
`dotnet workload install maui` picked up the new workload set 10.0.401.1,
which moves MacCatalyst to SDK 27.0.10722. That SDK requires Xcode 27.0,
but the macos-latest runner ships Xcode 26.6, so dashboard (macos-latest)
failed with "requires Xcode 27.0" even on a docs-only change.

Pin the set that last passed (10.0.401: MacCatalyst 26.5.10318, MAUI
10.0.20, matching the project's Microsoft.Maui.Controls 10.0.20).

Claude-Session: https://claude.ai/code/session_01BQy9NxDcMgXNygFbZQbBnS
@boinred
boinred merged commit c709a26 into main Oct 5, 2026
5 checks passed
@boinred
boinred deleted the claude/gracious-keller-qe7alq branch October 5, 2026 07:08
Sign up for free to 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