decision-logger

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Decision Logger

决策记录器

Two-layer memory system. Layer 1 stores everything. Layer 2 stores only what the founder approved. Future meetings read Layer 2 only — this prevents hallucinated consensus from past debates bleeding into new deliberations.

双层记忆系统。第一层存储所有内容，第二层仅存储创始人批准的内容。未来的会议仅读取第二层——这可防止过去辩论中产生的虚假共识影响新的审议。

Keywords

关键词

decision log, memory, approved decisions, action items, board minutes, /cs:decisions, /cs:review, conflict detection, DO_NOT_RESURFACE

decision log、memory、已批准决策、行动项、董事会会议纪要、/cs:decisions、/cs:review、冲突检测、DO_NOT_RESURFACE

Quick Start

快速开始

bash

python scripts/decision_tracker.py --demo             # See sample output
python scripts/decision_tracker.py --summary          # Overview + overdue
python scripts/decision_tracker.py --overdue          # Past-deadline actions
python scripts/decision_tracker.py --conflicts        # Contradiction detection
python scripts/decision_tracker.py --owner "CTO"      # Filter by owner
python scripts/decision_tracker.py --search "pricing" # Search decisions

bash

python scripts/decision_tracker.py --demo             # 查看示例输出
python scripts/decision_tracker.py --summary          # 概览 + 逾期项
python scripts/decision_tracker.py --overdue          # 超期行动项
python scripts/decision_tracker.py --conflicts        # 矛盾检测
python scripts/decision_tracker.py --owner "CTO"      # 按负责人筛选
python scripts/decision_tracker.py --search "pricing" # 搜索决策

Commands

命令

Command	Effect
`/cs:decisions`	Last 10 approved decisions
`/cs:decisions --all`	Full history
`/cs:decisions --owner CMO`	Filter by owner
`/cs:decisions --topic pricing`	Search by keyword
`/cs:review`	Action items due within 7 days
`/cs:review --overdue`	Items past deadline

命令	作用
`/cs:decisions`	最近10项已批准决策
`/cs:decisions --all`	完整历史记录
`/cs:decisions --owner CMO`	按负责人筛选
`/cs:decisions --topic pricing`	按关键词搜索
`/cs:review`	7天内到期的行动项
`/cs:review --overdue`	超期项

Two-Layer Architecture

双层架构

Layer 1 — Raw Transcripts

第一层——原始会议记录

Location:

memory/board-meetings/YYYY-MM-DD-raw.md

Full Phase 2 agent contributions, Phase 3 critique, Phase 4 synthesis
All debates, including rejected arguments
NEVER auto-loaded. Only on explicit founder request.
Archive after 90 days →
```
memory/board-meetings/archive/YYYY/
```

存储位置：

memory/board-meetings/YYYY-MM-DD-raw.md

包含第2阶段Agent的所有贡献、第3阶段的批评意见、第4阶段的综合内容
所有辩论内容，包括被否决的论点
绝不会自动加载，仅在创始人明确要求时才会加载
90天后归档至
```
memory/board-meetings/archive/YYYY/
```

Layer 2 — Approved Decisions

第二层——已批准决策

Location:

memory/board-meetings/decisions.md

ONLY founder-approved decisions, action items, user corrections
Loaded automatically in Phase 1 of every board meeting
Append-only. Decisions are never deleted — only superseded.
Managed by Chief of Staff after Phase 5. Never written by agents directly.

存储位置：

memory/board-meetings/decisions.md

仅包含创始人批准的决策、行动项、用户修正内容
每次董事会会议的第1阶段自动加载
仅允许追加内容，决策永不删除——仅会被取代
由Chief of Staff在第5阶段后管理，绝不允许Agent直接写入

Decision Entry Format

决策条目格式

markdown

undefined

markdown

undefined

[YYYY-MM-DD] — [AGENDA ITEM TITLE]

[YYYY-MM-DD] — [议程项标题]

Decision: [One clear statement of what was decided.] Owner: [One person or role — accountable for execution.] Deadline: [YYYY-MM-DD] Review: [YYYY-MM-DD] Rationale: [Why this over alternatives. 1-2 sentences.]

User Override: [If founder changed agent recommendation — what and why. Blank if not applicable.]

Rejected:

[Proposal] — [reason] [DO_NOT_RESURFACE]

Action Items:

[Action] — Owner: [name] — Due: [YYYY-MM-DD] — Review: [YYYY-MM-DD]

Supersedes: [DATE of previous decision on same topic, if any] Superseded by: [Filled in retroactively if overridden later] Raw transcript: memory/board-meetings/[DATE]-raw.md

---

决策： [清晰说明所做的决定。] 负责人： [个人或角色——对执行负责。] 截止日期： [YYYY-MM-DD] 复核日期： [YYYY-MM-DD] 理由： [为何选择该方案而非其他替代方案。1-2句话。]

用户覆盖： [如果创始人修改了Agent的建议——说明修改内容及原因。无则留空。]

被否决项：

[提案] — [理由] [DO_NOT_RESURFACE]

行动项：

[行动内容] — 负责人：[姓名] — 截止日期：[YYYY-MM-DD] — 复核日期：[YYYY-MM-DD]

取代： [同一主题的先前决策日期（如有）] 被取代： [后续被覆盖时追溯填写] 原始记录： memory/board-meetings/[DATE]-raw.md

---

Conflict Detection

冲突检测

Before logging, Chief of Staff checks for:

DO_NOT_RESURFACE violations — new decision matches a rejected proposal
Topic contradictions — two active decisions on same topic with different conclusions
Owner conflicts — same action assigned to different people in different decisions

When a conflict is found:

⚠️ DECISION CONFLICT
New: [text]
Conflicts with: [DATE] — [existing text]

Options: (1) Supersede old  (2) Merge  (3) Defer to founder

DO_NOT_RESURFACE enforcement:

🚫 BLOCKED: "[Proposal]" was rejected on [DATE]. Reason: [reason].
To reopen: founder must explicitly say "reopen [topic] from [DATE]".

记录前，Chief of Staff会检查以下内容：

DO_NOT_RESURFACE违规——新决策与被否决的提案匹配
主题矛盾——同一主题存在两个结论不同的有效决策
负责人冲突——不同决策中同一行动分配给了不同人员

发现冲突时：

⚠️ DECISION CONFLICT
New: [文本]
Conflicts with: [日期] — [现有文本]

Options: (1) Supersede old  (2) Merge  (3) Defer to founder

DO_NOT_RESURFACE规则执行：

🚫 BLOCKED: "[Proposal]" was rejected on [DATE]. Reason: [reason].
To reopen: founder must explicitly say "reopen [topic] from [DATE]".

Logging Workflow (Post Phase 5)

记录工作流（第5阶段之后）

Founder approves synthesis
Write Layer 1 raw transcript →
```
YYYY-MM-DD-raw.md
```
Check conflicts against
```
decisions.md
```
Surface conflicts → wait for founder resolution
Append approved entries to
```
decisions.md
```
Confirm: decisions logged, actions tracked, DO_NOT_RESURFACE flags added

创始人批准综合内容
写入第一层原始记录至
```
YYYY-MM-DD-raw.md
```
与
```
decisions.md
```
检查冲突
显示冲突 → 等待创始人解决
将批准的条目追加至
```
decisions.md
```
确认：决策已记录、行动项已跟踪、DO_NOT_RESURFACE标记已添加

Marking Actions Complete

标记行动项完成

markdown

- [x] [Action] — Owner: [name] — Completed: [DATE] — Result: [one sentence]

Never delete completed items. The history is the record.

markdown

- [x] [行动内容] — 负责人：[姓名] — 完成日期：[DATE] — 结果：[一句话说明]

绝不删除已完成项，历史记录即为凭证。

File Structure

文件结构

memory/board-meetings/
├── decisions.md       # Layer 2: append-only, founder-approved
├── YYYY-MM-DD-raw.md  # Layer 1: full transcript per meeting
└── archive/YYYY/      # Raw files after 90 days

memory/board-meetings/
├── decisions.md       # Layer 2: append-only, founder-approved
├── YYYY-MM-DD-raw.md  # Layer 1: full transcript per meeting
└── archive/YYYY/      # Raw files after 90 days

References

参考资料

```
templates/decision-entry.md
```
— single entry template with field rules
```
scripts/decision_tracker.py
```
— CLI parser, overdue tracker, conflict detector

```
templates/decision-entry.md
```
— 带有字段规则的单条目模板
```
scripts/decision_tracker.py
```
— CLI解析器、逾期跟踪器、冲突检测器