The Ledger 是 Gangsta Agents Family 的持久化机构记忆,存放在目标项目而非 gangsta 包内,目录为 docs/gangsta/,包含 constitution.md、insights/ 与 fails/。若目录不存在,可用 mkdir -p docs/gangsta/insights docs/gangsta/fails 初始化,并创建初始 constitution.md,内含 Commandments、Negative Constraints 与 Architectural Decisions 三节。
写入 Insight 时,记录绕过复杂约束、发现非显然方案或确立新 Commandment 的情况,文件为 docs/gangsta/insights/YYYY-MM-DD-<topic-slug>.md,含 date、heist、phase、tags 元数据及 Discovery、Solution、Project Commandment 等节;随后更新 constitution.md 的 Commandments 并附来源引用。写入 Fail 时,记录导致回归、安全缺口、浪费时间或错误实现的做法,文件为 docs/gangsta/fails/YYYY-MM-DD-<topic-slug>.md,含 severity 元数据及 What Happened、Cognitive Diagnosis、Negative Constraint 等节;随后更新 constitution.md 的 Negative Constraints 并附来源引用。
读取方面:Reconnaissance 阶段按标签检索 insights/ 与 fails/ 并写入侦察档案;The Grilling 阶段 Devils-Advocate 必须检查所有 Negative Constraints,违反者自动拒绝;The Sit-Down 阶段 Underboss 起草 Contract 时须引用相关 Commandments;The Hit 阶段 Worker 实施前检查 Negative Constraints,若违反则上报 Crew Lead;Laundering 阶段写入新洞察与失败并更新 Constitution。Omerta 合规要求所有条目引用具体阶段、heist 与可观察证据,文件每次更新后提交 git,Constitution 中的 Negative Constraints 对未来所有 Heist 具有约束力。