FlowForge v3

当前入口。v3 规范以 docs/proposal-v3/ 为唯一语义来源；实现状态以 CLI 源码和测试为准。

FlowForge 是面向 AI 辅助软件设计与交付的工作流工具包。它用 FEATURE 文档承载功能生命周期，用库卡片沉淀跨功能知识。

当前卡片类型只有：

• PROP：Proposal control-plane metadata，描述提案范围和 FEATURE 关系；不是普通用户卡。
• FEATURE：一个功能的完整生命周期，阶段为 draft → designed → planned → in_progress → done。
• CONV、DEC、MOD、FIND：跨 FEATURE 复用的约定、决策、模块知识和发现。

STR 只作为 Proposal control-plane metadata 存在，不是普通用户卡，也不进入普通卡片读写、列表、搜索或索引视图。

flowforge init
flowforge project create <id> --wiki-root ff-wiki --src-dir .
flowforge card init --type feature --title "..." --proposal <proposal-id>
flowforge card evolve <feature-id> --stage designed
flowforge context feature --feature <feature-id> --step <n>
flowforge card log <feature-id> --event "..."
flowforge card steps <feature-id> --status done <n>
flowforge proposal inspect <proposal-id>

结构化操作使用 CLI；卡片正文由 Agent 直接编辑。docs/proposal-v3/ 的 implementation-plan.md 仅是计划，不是实现事实。

• v3 总览与权威矩阵
• 卡片模型
• CLI 规范
• SKILL 规范
• 实施计划（计划）
• 架构说明
• 索引管理实现边界

其余 v2 文档仅作 historical 背景，不从当前入口导出。

flowforge upgrade
flowforge upgrade --dry-run
flowforge uninstall

更新命令只处理 FlowForge 自身版本；本项目不承诺旧 wiki、旧 ID/links 或数据迁移。

MIT License