docs(plans): migrate roadmap to Plans/ structure with archive

- ROADMAP.md → Plans/Archive/ROADMAP_202602_202603_Closed.md (unchanged)
- NEXT_ROADMAP.md → Plans/ROADMAP.md (active planning entry point)
- AGENTS.md updated with Plans/ in project layout and workflow rules
- Oracle tracking docs updated to reference Plans/ paths
- Stray nul artifact removed

Author: InitusNovus

.sisyphus/notepads/l2bc-crc-counter/learnings.md

@@ -18,3 +18,7 @@
 20260313_2230_Dbc_T12_blankline_fix: Removed blank lines after triple-quoted DBC literals in T12 tests (IsCrc/IsCounter/Non-CRC/CRC_OFF). Build+tests: OK.
 
 20260313_2348_T14_codegen_crc_counter_tests: Added CodegenTests coverage for CRC/counter modes (validate/passthrough/fail_fast), CRC mismatch/encode paths, counter rollover helper emission, and utils CRC helper parity/no-parity checks.
+
+20260313_2018_T15_api_facade_crc_tests: `Api.generateFromPaths` and `GeneratorFacade.GenerateFromPathsAsync` currently surface CRC/Counter validation failures from YAML/config validation (`UnknownAlgorithm`, `ConfigConflict`) before codegen; missing-message/signal references in `crc_counter.mode=validate` are not rejected by the current pipeline because `applyConfigMetadata` ignores unmatched message/signal names.
+
+20260313_2025_T16_c_build_verification: CRC validate codegen emits the expected helper surface (`sc_crc8_sae_j1850`, CRC table, `MESSAGE_1_check_counter`), so the validate path reaches template emission; the current blocker is C compile correctness in generated encode code, not missing CRC symbol generation.

AGENTS.md

@@ -13,6 +13,7 @@ tests/Signal.CANdy.Core.Tests/  xUnit + FsUnit tests for Core library
 tests/Generator.Tests/   xUnit + FsUnit tests (references Generator project)
 templates/               Scriban templates for C code generation
 examples/                Sample DBC files, YAML configs, and C test runner
+Plans/                  Active/archived roadmap documents
 ```
 
 ## Build & Test Commands
@@ -245,11 +246,11 @@ Reports/YYYYMMDD_HHMM_작업내용요약.md
 | 📝 **작업 요약** | 이번 세션에서 수행한 작업의 한 줄 요약 및 상세 설명 |
 | 🛠 **변경 상세** | 수정/생성/삭제한 파일 목록과 각 변경의 구체적 내용 |
 | ✅ **테스트 결과** | `dotnet test` 결과, C 빌드 결과, 수동 검증 내역 등 |
-| ⏭ **다음 계획** | 다음 세션에서 착수할 ROADMAP 항목 및 선행 조건 |
+| ⏭ **다음 계획** | 다음 세션에서 착수할 활성 계획(`Plans/ROADMAP.md`) 항목 및 선행 조건 |
 
 ### 규칙 4: ROADMAP 업데이트
 
-작업 세션에서 ROADMAP 항목을 완료했다면, **해당 세션 내에서 즉시** `ROADMAP.md`의 체크박스를 `[x]`로 갱신한다.
+작업 세션에서 활성 계획 항목을 완료했다면, **해당 세션 내에서 즉시** `Plans/ROADMAP.md`의 체크박스를 `[x]`로 갱신한다.
 보고서에도 완료된 ROADMAP 항목 ID를 명시한다 (예: "C-1a, C-1b 완료").
 
 ### 규칙 5: 보고서 불변성과 정정 방식

ROADMAP.md …/Archive/ROADMAP_202602_202603_Closed.mdROADMAP.md renamed to Plans/Archive/ROADMAP_202602_202603_Closed.md ROADMAP.md renamed to Plans/Archive/ROADMAP_202602_202603_Closed.md

@@ -1,11 +1,12 @@
-# NEXT ROADMAP — Signal-CANdy 후속 backlog
+# ROADMAP — Signal-CANdy Active Plan
 
-> 이 문서는 `ROADMAP.md` close-out 이후의 **다음 세대 작업 후보**만 기록합니다.
-> 현행 truth 확인 순서: 최신 `Reports/` → 이 문서 → `tests/oracle/CATEGORY_C_EXCEPTIONS.md` / `tests/oracle/ORACLE_RESULTS.md`.
+> 이 문서는 현재 활성 계획 문서입니다.
+> 2026-02~2026-03 세대 종결본은 `Plans/Archive/ROADMAP_202602_202603_Closed.md`에 원본 그대로 보관합니다.
+> 현행 truth 확인 순서: 최신 `Reports/` → `Plans/ROADMAP.md` → `tests/oracle/CATEGORY_C_EXCEPTIONS.md` / `tests/oracle/ORACLE_RESULTS.md`.
 
 ## 포함 원칙
 
-- `ROADMAP.md`에 남기면 historical snapshot을 다시 흔들게 되는 항목만 이관한다.
+- 닫힌 snapshot(`Plans/Archive/ROADMAP_202602_202603_Closed.md`)을 다시 흔들게 되는 항목만 이 문서에서 관리한다.
 - 구현 완료로 닫힌 항목은 여기로 되돌려 적지 않는다.
 - 설계/정책이 더 필요한 future-facing 항목만 유지한다.
 
@@ -14,7 +15,7 @@
 ### 1. valid 비트마스크 `>64` 신호 fallback 방식
 
 - 현 상태: `≤32 -> uint32_t`, `33–64 -> uint64_t`, `>64 -> UnsupportedFeature`
-- 근거: `ROADMAP.md` L-3a close-out 문구, `tests/oracle/CATEGORY_C_EXCEPTIONS.md` Exception 3
+- 근거: `Plans/Archive/ROADMAP_202602_202603_Closed.md` L-3a close-out 문구, `tests/oracle/CATEGORY_C_EXCEPTIONS.md` Exception 3
 - 후속 판단 과제: 배열 기반 valid 표현을 실제로 도입할지, 아니면 `>64` 미지원을 장기 정책으로 유지할지 결정
 
 ### 2. Oracle reference decoder 비호환 DBC 대응 전략
@@ -27,4 +28,4 @@
 
 1. 최신 close-out / verification 보고서를 먼저 확인한다.
 2. 위 두 항목 중 실제 제품 우선순위가 생긴 것만 새 세대 계획으로 승격한다.
-3. 새 계획을 시작할 때는 `ROADMAP.md`를 수정하지 않고, 이 문서 또는 새 세대 roadmap 문서에서 이어간다.
+3. 새 계획을 시작할 때는 archive 문서를 수정하지 않고, 이 문서 또는 `Plans/` 하위 successor roadmap에서 이어간다.

NEXT_ROADMAP.md Plans/ROADMAP.mdNEXT_ROADMAP.md renamed to Plans/ROADMAP.md

@@ -0,0 +1,45 @@
+# Plans 구조 전환 및 정합성 보고서
+
+## 📝 작업 요약
+- 요청사항에 따라 계획 문서 관리 구조를 `Plans/` 중심으로 일관화했다.
+- 기존 완료 문서인 root `ROADMAP.md`는 수정 없이 `Plans/Archive/ROADMAP_202602_202603_Closed.md`로 아카이브했고, 활성 계획은 `Plans/ROADMAP.md`로 전환했다.
+- `AGENTS.md`, `tests/oracle/*`의 지시/참조 경로를 새 구조에 맞게 최소 수정하여 문서 간 정합성을 맞췄다.
+
+---
+
+## 🛠 변경 상세
+- 계획 문서 구조
+  - `ROADMAP.md` (root) → `Plans/Archive/ROADMAP_202602_202603_Closed.md` (아카이브)
+  - `NEXT_ROADMAP.md` (root) → `Plans/ROADMAP.md` (활성 계획)
+- 지시 문서/참조 경로 정합성
+  - `AGENTS.md`
+    - Project Layout에 `Plans/` 추가
+    - 보고서 섹션의 다음 계획 기준을 `Plans/ROADMAP.md`로 전환
+    - 완료 체크 갱신 대상 경로를 `Plans/ROADMAP.md`로 전환
+  - `tests/oracle/ORACLE_RESULTS.md`
+    - 현재 판정 참조를 `Plans/Archive/...` + `Plans/ROADMAP.md` + 최신 `Reports/` 기준으로 보정
+  - `tests/oracle/CATEGORY_C_EXCEPTIONS.md`
+    - backlog entry 기준을 `Plans/` 하위 활성 계획 문서 기준으로 보정
+    - 후속 추적 문구를 `Plans/ROADMAP.md` 기준으로 보정
+- 아카이브 무변경 증빙
+  - `git rev-parse HEAD:ROADMAP.md` 해시와 `hash-object Plans/Archive/ROADMAP_202602_202603_Closed.md` 해시가 동일함을 확인
+  - 확인값: `b9c862cba3f37a364d7ac3634e1e0e1815c22ce2`
+
+---
+
+## ✅ 테스트 결과
+- `dotnet build --configuration Release --nologo` ✅
+  - 경고 0 / 오류 0
+- `dotnet test --configuration Release -v minimal --nologo` ✅
+  - Core 125/125 pass
+  - Generator 27/27 pass
+  - Total 152/152 pass
+- 추가 점검
+  - `git diff --summary`로 root `ROADMAP.md`, `NEXT_ROADMAP.md` 제거(Plans 이관) 상태 확인
+  - `grep`으로 `AGENTS.md`, `tests/oracle/*`, `Plans/ROADMAP.md`의 새 경로 참조 확인
+
+---
+
+## ⏭ 다음 계획
+- 필요 시 다음 세션에서 `Plans/ROADMAP.md` 기준으로 신규/후속 계획을 이어서 관리한다.
+- historical 보고서(`Reports/` 기존 파일)는 불변 이력 원칙에 따라 수정하지 않고, 경로 체계 변경은 본 보고서 이후 patch-forward 방식으로만 누적한다.

Reports/20260315_1844_Plans_구조전환_정합성.md

@@ -9,7 +9,7 @@ To be classified as Category C, an exception must satisfy all four of the follow
 1.  **Clear Technical Limitation**: The divergence is rooted in a specific architectural choice, environment constraint, or reference tool behavior.
 2.  **Scoped Impact Count**: The number of affected signals or tests must be quantified.
 3.  **No Feasible Alternative**: There's no trivial fix without breaking existing functionality or requiring a major refactor.
-4.  **Backlog Entry**: The limitation must be tracked in the current canonical planning document (`ROADMAP.md` when active, or `NEXT_ROADMAP.md` / successor roadmap after close-out) for future resolution.
+4.  **Backlog Entry**: The limitation must be tracked in the current canonical planning document (`Plans/ROADMAP.md` or successor roadmap under `Plans/`) for future resolution.
 
 ---
 
@@ -23,7 +23,7 @@ The current oracle pipeline executes tests using a single-signal configuration.
 | Technical Limitation | PASS | Oracle `run_oracle.py` lacks multi-branch selection logic. |
 | Scoped Impact | PASS | 83 signals marked `skipped` in `ORACLE_RESULTS.md`. |
 | No Feasible Alternative | **RESOLVED** | Implemented `_generate_mux_vectors()` in `engine.py` (B-O2). |
-| ROADMAP Entry | PASS | Tracked under B-O2 (completed 2026-03-12). |
+| Backlog Entry | PASS | Tracked under B-O2 (completed 2026-03-12). |
 
 **Category**: `cantools_oracle_limitation`
 
@@ -35,7 +35,7 @@ Float32 rounding during the encode→decode cycle can introduce a ±1 LSB diverg
 | Technical Limitation | PASS | Inherent float32 rounding divergence in C vs Python. |
 | Scoped Impact | PASS | 227 value-level mismatches in corpus handled by tolerance. |
 | No Feasible Alternative | PASS | Floating-point behavior is non-deterministic across platforms. |
-| ROADMAP Entry | PASS | N/A (Intentionally covered by `tolerance.py` baseline). |
+| Backlog Entry | PASS | N/A (Intentionally covered by `tolerance.py` baseline). |
 
 **Category**: `float32_rounding`
 
@@ -47,7 +47,7 @@ The generated `valid` bitmask was a fixed `uint32_t`. Auto-widening (B-O3, v0.3.
 | Technical Limitation | PASS | Architectural choice of `uint32_t` for the `valid` field. |
 | Scoped Impact | PASS | Impact limited to complex industrial/heavy-duty DBCs. |
 | No Feasible Alternative | **RESOLVED** | Implemented auto-widening to `uint64_t` in `Codegen.fs` (B-O3, v0.3.2). |
-| ROADMAP Entry | PASS | Tracked under B-O3 (completed 0.3.2). |
+| Backlog Entry | PASS | Tracked under B-O3 (completed 0.3.2). |
 
 **Category**: `valid_mask_width`
 
@@ -65,7 +65,7 @@ Specific vendor DBCs contain syntax anomalies or 29-bit extended IDs that `canto
 | Technical Limitation | PASS | Reference decoder (`cantools`) cannot parse valid/used DBCs. |
 | Scoped Impact | PASS | 3 DBC files entirely excluded from oracle comparison. |
 | No Feasible Alternative | PASS | Requires a different reference decoder or `cantools` patch. |
-| Backlog Entry | PASS | After ROADMAP close-out, this remains tracked in `NEXT_ROADMAP.md` as the oracle reference-decoder incompatibility follow-up. |
+| Backlog Entry | PASS | After roadmap close-out, this remains tracked in active planning document `Plans/ROADMAP.md` as the oracle reference-decoder incompatibility follow-up. |
 
 **Category**: `reference_decoder_incompatible`
 

tests/oracle/CATEGORY_C_EXCEPTIONS.md

@@ -3,7 +3,7 @@
 **Date**: 2026-03-12 (B-O2 update)  
 **Commit**: `839e777` (oracle-failure-resolution boulder complete)
 
-> ⚠️ **Historical Snapshot**: 이 문서는 2026-03-12 시점의 통합 실행 결과 스냅샷입니다. Recommendation #1~#3 및 mux skip 이슈는 이후 세션에서 해결되었으며, 현재 상태 판정은 `ROADMAP.md` Tracking 섹션과 최신 `Reports/` 문서를 우선합니다.
+> ⚠️ **Historical Snapshot**: 이 문서는 2026-03-12 시점의 통합 실행 결과 스냅샷입니다. Recommendation #1~#3 및 mux skip 이슈는 이후 세션에서 해결되었으며, 현재 상태 판정은 `Plans/Archive/ROADMAP_202602_202603_Closed.md` Tracking 섹션, 활성 계획 `Plans/ROADMAP.md`, 최신 `Reports/` 문서를 우선합니다.
 
 ## Executive Summary