Praetor 內部設計與維護文件索引

Status: 2026-05-19 refreshed。

這個目錄是 Praetor 的產品與實作規格中心，主要給維護者、貢獻者與產品設計決策使用。

如果你是一般 owner / founder，想知道怎麼安裝、第一次設定、選 runtime、使用 workspace、處理 approval、設定 Telegram 或排除問題，請先讀 Praetor 使用者手冊。

本索引收的是內部 source of truth。文件依用途分四類，讀的順序按目的，不是按字母。

---

A. 從這裡開始（必讀）

1. ADR-002-praetor-as-ai-company.md — 最新產品決策：Praetor 是 AI 公司本身；使用者管理 Agent，Role 是職務框架

2. ADR-003-model-routing-and-native-subagents.md — model profile routing 與 executor-native subagents 的產品/架構邊界

3. PRAETOR_CURRENT_DEVELOPMENT_ROADMAP.zh-CN.md — 目前實際開發 checklist；每個 phase 完成後提交 commit

4. PRAETOR_PAPERCLIP_MATURITY_ROADMAP.zh-CN.md — Paperclip-inspired 成熟化總路線與已完成狀態

5. ROADMAP.md — active rebuild roadmap 與既有完成狀態

6. PRAETOR_PRODUCT_BRIEF.zh-TW.md — 產品北極星與市場定位；若與 ADR-002 衝突，以 ADR-002 為準

B. 設計層（UI / 視覺 / 多端策略）

| 文件 | 角色 |

|---|---|

| UI_REBUILD_PLAYBOOK.zh-TW.md | 歷史 React 重建執行稿；不得覆蓋 ADR-002 或 maturity roadmap |

| PRAETOR_UI_SPEC.zh-TW.md | 長期有效的 UI 原則（六條 UX 原則、checkpoint UX、通知分類、多端策略總綱、核心取捨） |

| PRAETOR_BRAND_SPEC.zh-TW.md | 視覺基線：配色 token、字體、logo、語氣、動效原則 |

| PRAETOR_SURFACES_SPEC.zh-TW.md | Web / Mobile Web / Telegram 三端邊界、權限、interaction flow |

衝突權威順序：ADR-002 > PRAETOR_CURRENT_DEVELOPMENT_ROADMAP > PRAETOR_PAPERCLIP_MATURITY_ROADMAP > ROADMAP > PRODUCT_BRIEF > UI_SPEC > BRAND_SPEC > historical playbooks。

C. 系統層（後端 / 部署 / 安全）

| 文件 | 角色 |

|---|---|

| PRAETOR_SYSTEM_SPEC.zh-TW.md | 核心概念、schema、治理、記憶、runtime、executor、安全策略 |

| PRAETOR_REPO_ARCHITECTURE.zh-TW.md | 技術選型、repo 切分（含 as-built 對照）、部署形態、背景工作 |

| PRAETOR_EXECUTOR_BRIDGE_SPEC.zh-TW.md | praetor-execd 主機側 bridge 的 API contract、事件模型、狀態機 |

| DEPLOYMENT_SECURITY_SPEC.zh-TW.md | Docker 部署模式、網路邊界、secrets、備份還原 |

| PRAETOR_PUBLIC_SECURITY_REVIEW.zh-TW.md | 公開使用前的安全稽核、已完成控制、上線阻擋項 |

| PRAETOR_PRIVACY_BOUNDARIES.zh-TW.md | 使用者資料存放、檔案存取、外部 provider 與刪除說明 |

D. 行為層（產品內的核心流程）

| 文件 | 角色 |

|---|---|

| PRAETOR_CEO_INTERACTION_POLICY.zh-TW.md | CEO 對話 route、direct answer、mission 建立門檻、approval 邊界 |

| PRAETOR_COMPANY_CULTURE.md | 公司文化、Wiki/Memory、Playbook、Standing Orders、Agent Contract 的邊界與 onboarding 定義方式 |

| PRAETOR_MEMORY_PROMOTION.md | 對話 → 決策 → 文件 → 長期 Wiki 記憶的沉澱流程 |

| PRAETOR_MEMORY_MANAGEMENT_SKILL.md | CEO 自動管理記憶的規則：自動寫入、draft、owner decision、rollback |

| PRAETOR_WORKER_QUEUE_PLAN.md | mission worker queue 接管執行的狀態機、遷移步驟與驗證要求 |

| PRAETOR_BROWSER_CAPABILITY.md | Agent browser request、授權分類、evidence lifecycle、Codex browser fallback |

| PRAETOR_EXECUTOR_SECTION_LIFECYCLE.md | Codex/Executor section lifecycle、context 不保留、互動升級與 closeout |

| PRAETOR_INTERACTION_REQUESTS.md | AI 管理 AI 的正式問題請求、沿組織圖升級、會議 owner、Agent 評價 |

| PRAETOR_TEAM_PLANNING.md | CEO 組隊、PM 交辦、董事長簡報、授權執行與升級邊界 |

| PRAETOR_ORGANIZATION_OPERATING_SYSTEM.md | mission lifecycle、agent employment contracts、permission profiles、work trace |

| PRAETOR_WORKSPACE_STEWARD.md | File System Steward 產品方向；大型 registry/restructure layer 仍分階段恢復 |

E. 安裝 / 部署 / 對外手冊

| 文件 | 角色 |

|---|---|

| PRAETOR_LOCAL_DEPLOY.md | 本地 Docker 啟動方式 |

| PRAETOR_INSTALL_RECOVERY.md | 一鍵安裝、operator CLI、備份還原、bridge 安全 |

| PRAETOR_REMOTE_PRIVATE_DEPLOY.md | 私有遠端部署、reverse proxy |

| ADVANCED_DEPLOYMENT.md | 手動 Docker、production overlay、多服務 stack |

| INSTALL_CHECKLIST.md | release candidate 前的乾淨安裝 checklist |

| QA_SMOKE_MATRIX.md | release candidate 前的自動 smoke matrix 與手動 UI 驗證路徑 |

| RELEASE_READINESS_REPORT.md | 最新 release readiness gate 報告 |

| PRAETOR_BACKUP_RESTORE.md | 備份還原、最小可行 backup script |

| DEVELOPER_SETUP.md | Pixi 本機開發、smoke tests、planner、bridge 開發 |

| CHATGPT_SUBSCRIPTION_EXECUTOR.md | ChatGPT subscription 連接 Praetor 的設定流程 |

| TELEGRAM_SETUP.md | Telegram CEO 入口、webhook、配對碼 |

| GITHUB_SETUP.md | GitHub Pages 發布與 CI 相關設定 |

F. 對外行銷 / 開源定位

G. 歷史 / 延期（不在 v1 執行路徑）

---

目前共識（2026-05-19）