用途:PLANERA(Planning Logic: Adaptive Notation, Executable Requirements Architecture)用于在实现前做结构化规划,只负责 WHAT 与 WHY,HOW 交给 realisera。
主要能力:按复杂度自适应选择三级——skip(单文件改动、修 bug、配置微调、少于 50 行)、light(单模块、范围清晰、一个 realisera 周期)、full(多模块、多文件、3 个以上逻辑步骤、跨架构新功能)。full 级会启动对抗式评审,评审者必须至少指出一个问题。
使用方式:先读取 VISION.md、DECISIONS.md、TODO.md、HEALTH.md、PROGRESS.md 等上下文,再依次执行 orient、specify、review、audit、write、handoff 六步。产物写入 .agentera/PLAN.md,归档目录为 .agentera/archive/。若存在 .agentera/DOCS.md 的 Artifact Mapping,则按其中路径解析,否则使用默认布局。可选运行 python3 scripts/effective_profile.py 获取决策画像。
适用场景:需要把模糊需求拆成可执行任务、为 realisera 提供工作队列、或为 optimera、inspektera 等技能提供规划输入时。
限制:PLAN.md 不得包含实现细节(函数名、行号、类名、API 端点、数据库表);full 计划任务不超过 8 个;full 计划必须运行对抗评审;人工发起时不得自动批准;trivial 工作应直接跳过。具体 token 预算、严重级别与格式约定以 references/contract.md 为准。其他细节暂未提供。