Skip to content

docs(archicad): add guarded structural DWG sync - #131

Open
Archwiz-boss wants to merge 1 commit into
shuotao:mainfrom
Archwiz-boss:feat/archicad-structural-dwg-sync
Open

Archwiz-boss wants to merge 1 commit into
shuotao:mainfrom
Archwiz-boss:feat/archicad-structural-dwg-sync

Conversation

@Archwiz-boss

@Archwiz-boss Archwiz-boss commented Sep 8, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • add domain/archicad-structural-dwg-sync.md for per-story structural DWG/DXF alignment, new-column pilot, existing Column/Beam/Slab comparison, guarded Property marking, and human review
  • grade every Archicad capability as verified, approximate mapping, or unsupported, with the 2026-09-08 version and test/inherited basis
  • define SI metre-to-mm normalization, an absolute 5 mm comparison threshold, raw-vs-snapped evidence, story isolation, write/read-back gates, and professional-use boundaries
  • register the new file in the domain/README.md category table

Scope(分支重建後補述,非原作者內容)

原本這條分支自 feat/archicad-domain-specs(#130 的 head)開出,因此 PR 一併帶入 #130 的 commit,並改到 23 個超出 fork PR 允許路徑的檔案。CI 的 check-files 明確界定:fork PR 只允許修改 domain/*.md 與 GEMINI.md。

分支已重建為自 main 起算,只保留本工作線自己的兩個檔案:

  • domain/archicad-structural-dwg-sync.md(新增,299 行,內容未更動)
  • domain/README.md(分類登記一行,數量 18 → 19)

計數同步、CLAUDE.md 關鍵字表、docs/BIM_MCP 索引與 hero 圖等連帶更新已全部移出。依維護者既有作法,那些由收編時處理——5dad238 的訊息載明「Domain(79)/Skills(54)/Tools(180) 皆不變」,是維護者自行核算後落地的。

與 #130 的關係:兩者現在各自獨立,不再有先後依賴,任一先合併都可以。唯一交集是 domain/README.md 的分類表——#130 加三行、本 PR 加一行,先後收編時需合併該表,數量取合併後的實際值。

Evidence boundary

  • verified: live Archicad 28 build 3001 + Tapir MCP 0.5.3 pilot on 2026-09-08, or explicitly labelled inherited runtime-facts evidence from that date/version
  • approximate mapping: View Map creation, F5-like review chain, Favorite application, Beam Element ID, linked-DWG primitive extraction, and DXF/AutoCAD fallback where no end-to-end pilot exists
  • unsupported: the known-broken detail/classification read paths and untrustworthy tool-level success for batch Property writes
  • no real structural DWG was available; synthetic R00/R01 DXF acceptance cases are specified for the next pilot

Validation

  • read-only specialist review: pass after removing a false reverse-Skill link from the domain-index card
  • referenced_by: [] intentionally remains unconnected; scripts/backfill-domain-metadata.py was run and skipped the existing frontmatter, so no contributor was hand-filled
  • .mcp.json, .vscode/mcp.json, and .vscode/settings.json are excluded from the commit
  • 註:先前記錄的 verify-qaqc.ps1 61 PASS / 0 FAIL 是在含連帶更新的舊分支上跑的。重建後本 PR 不再改動計數與索引,那部分的一致性由維護者收編時驗證;domain 檔本身的 frontmatter 與 related 指向檢查(Phase 6)不受影響。

Refs #98

Archwiz-boss added a commit to Archwiz-boss/BIM_MCP_study that referenced this pull request Sep 8, 2026
兩個缺漏,都是我先前新增 domain 檔時沒做完,由另一條工作線(PR shuotao#131)改到
同一批檔案時才浮現。

**一、卡片放錯 section。** 我把三張卡片插在 domain-index.html 的 wall-check
之後,而那整段屬於 `id="compliance"`(法規與 compliance SOP),等於把 Archicad
的轉譯邊界、名詞對照與可攜性矩陣歸成了法規檢核。

正確歸屬是 ops。索引裡所有同性質的 meta-reference——tool-capability-boundary、
skill-authoring-standard、frontmatter-standard、session-context-guard、
core-reload-boundary、lessons——都在 ops(維運、QA 與 authoring 標準)。
references section 不適用,它的定義是「非本專案產出的 SOP,引用外部規範本文,
放在 domain/references/ 子目錄」,只收 building-code-tw.md。

三張卡片改置於 ops section,compliance 回到 11,ops 由 11 改為 14
(cat-summary 與 section 標題同步)。

**二、hero 圖的分類計數沒改。** scripts/gen-hero-grains.mjs 帶有 domain 的
五分類計數,加總即總數。我先前把總數從 83 改到 86,卻沒有改這裡,因此
domain__hero__grains.svg 仍畫著 83。QAQC 的 claim-pattern 不涵蓋 .mjs 與 .svg,
所以沒有被擋下來。

維運 11 改為 14、console.log 的總數 83 改為 86,並重跑 gen-hero-grains.mjs
重新產生 domain__hero__grains.svg。skills__hero__grains.svg 的內容不變,僅行尾
差異,已還原不納入。

scripts/verify-qaqc.ps1 -SkipBuild -SkipDeploy:61 PASS / 0 FAIL。

Refs shuotao#98

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Document evidence-graded workflows for per-story structural CAD comparison,
unit normalization, safe property marking, and human review boundaries.

--- 分支重建說明(收尾時補,非原作者內容)---

原分支自 feat/archicad-domain-specs 開出,因此 PR 連同該分支的 commit 一併帶入,
並改到 23 個超出 fork PR 允許路徑的檔案。CI 的 check-files 明確界定:fork PR
只允許修改 domain/*.md 與 GEMINI.md。

現改為自 upstream/main 重建,只保留本工作線自己的兩個檔案:

- domain/archicad-structural-dwg-sync.md(新增,299 行)
- domain/README.md(分類登記一行,數量 18 → 19)

計數同步、CLAUDE.md 關鍵字表、docs/BIM_MCP 索引與 hero 圖等連帶更新,依維護者
既有作法由收編時處理(見 5dad238 的訊息:「Domain(79)/Skills(54)/Tools(180)
皆不變」,是維護者自行核算後落地),不在 fork PR 範圍內。

與 PR shuotao#130 的關係:兩者現在各自獨立,唯一交集是 domain/README.md 的分類表——
shuotao#130 加三行、本 PR 加一行,先後收編時需合併該表,數量取合併後的實際值。

Refs shuotao#98

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
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