ilaandClaude Fable 5
a89821a571
Split docs/softbox-catalog-design.md into the numbered harness doc set (00-06, api.md, current-state, agent-context, tasks) following the harness_coding_docs template and soft_quay conventions. Register the nine open decision items from the design spec into the 06-tasks roadmap as W- tasks and backlog entries. Keep the original design spec as an archived design input with a header note. Recreated after the repository's previous git history was lost to an external reset; content matches the original initial commit. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
项目文档导航
soft_quay_web(SoftBox 中央发布 / 登记系统)的 harness coding 文档集。agent 开始工作时以
00-ai-start-here.md为入口。
一句话定位
soft_quay_web = 软件登记 + 构建包接收校验 + Ed25519 签名服务 + 双通道清单生成 + 对象存储发布 + 许可证/撤销签发 + Web 管理后台;产物是静态签名文件,信任根是私钥,客户端 soft_quay 只内置公钥离线验签。
文档导航
../AGENTS.md:AI coding agent 的仓库级入口(含硬性边界)。../CLAUDE.md:Claude Code 的薄入口,具体规则以AGENTS.md为准。../progress.md:可选历史归档 / 项目级大事记。- AI 开发入口:agent 每次开始工作的入口、阅读顺序和任务领取规则。
- 项目愿景:为什么做、为谁做、设计原则、非目标。
- 需求:要什么、用户故事、验收标准,不写技术实现。
- 技术栈:选型、待定项、构建命令、依赖纪律。
- 架构设计:信任模型、组件边界、数据模型、发布流水线、密钥管理。
- 编码规则:协议对齐与安全的硬约束。
- 任务路线图:Phase 0-5 阶段划分、里程碑、未定项裁定清单、待办池;只读。
- 任务文件(默认):一任务一文件
docs/tasks/W-<编号>.md,单 Agent 串行执行。 - 协议合约:发布端视角的清单 / 包 / 许可证摘要与本仓库特有接口;权威源在
soft_quay仓库。 - 设计规格(原始):立项前的完整设计规格;内容已拆分进编号文档,冲突时以编号文档为准。
- 当前实现状态:可覆盖的当前快照。
- Agent 上下文清单 /
agent-context.json/Schema:按任务类型选择文档。 - 收尾检查清单:会话结束前逐项检查。
../init.sh/../init.ps1:标准启动与验证入口(W-001 前为占位符)。../scripts/validate_agent_context.py:零第三方依赖校验上下文清单。
任务 / 进度 / 当前状态
tasks/(docs/tasks/W-<编号>.md)维护任务:规格、依赖、状态(frontmatter)和执行记录,一任务一文件。06-tasks.md维护路线图:阶段划分、里程碑和待办池,不跟踪单任务状态。current-state.md维护当前快照:当前目录、当前可运行命令、任务摘要和下一个可领取任务。../progress.md可选:历史归档或项目级大事记,不逐任务追加。
维护原则
- 需求变化先改文档,再改代码。
- 协议(manifest / app.json / 许可证)以客户端仓库
soft_quay为唯一权威源;本仓库文档只做摘要,变更先走客户端仓库。 - 代码现实变化后同步
current-state.md;任务长期状态和执行证据写进对应任务文件。 - agent 开始新任务前,必须从
00-ai-start-here.md进入。