ilaandClaude Fable 5
85162bf1e0
The original design spec content lives entirely in the numbered harness docs; the file itself is recoverable from the initial commit. Drop it from agent-context routes and fix all doc references. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
42 lines
3.0 KiB
Markdown
42 lines
3.0 KiB
Markdown
# 项目文档导航
|
|
|
|
> soft_quay_web(SoftBox 中央发布 / 登记系统)的 harness coding 文档集。agent 开始工作时以 [`00-ai-start-here.md`](00-ai-start-here.md) 为入口。
|
|
|
|
## 一句话定位
|
|
|
|
soft_quay_web = 软件登记 + 构建包接收校验 + Ed25519 签名服务 + 双通道清单生成 + 对象存储发布 + 许可证/撤销签发 + Web 管理后台;产物是静态签名文件,信任根是私钥,客户端 `soft_quay` 只内置公钥离线验签。
|
|
|
|
## 文档导航
|
|
|
|
- [`../AGENTS.md`](../AGENTS.md):AI coding agent 的仓库级入口(含硬性边界)。
|
|
- [`../CLAUDE.md`](../CLAUDE.md):Claude Code 的薄入口,具体规则以 `AGENTS.md` 为准。
|
|
- [`../progress.md`](../progress.md):可选历史归档 / 项目级大事记。
|
|
- [AI 开发入口](00-ai-start-here.md):agent 每次开始工作的入口、阅读顺序和任务领取规则。
|
|
- [项目愿景](01-vision.md):为什么做、为谁做、设计原则、非目标。
|
|
- [需求](02-requirements.md):要什么、用户故事、验收标准,不写技术实现。
|
|
- [技术栈](03-tech-stack.md):选型、待定项、构建命令、依赖纪律。
|
|
- [架构设计](04-architecture.md):信任模型、组件边界、数据模型、发布流水线、密钥管理。
|
|
- [编码规则](05-coding-rules.md):协议对齐与安全的硬约束。
|
|
- [任务路线图](06-tasks.md):Phase 0-5 阶段划分、里程碑、未定项裁定清单、待办池;只读。
|
|
- [任务文件(默认)](tasks/README.md):一任务一文件 `docs/tasks/W-<编号>.md`,单 Agent 串行执行。
|
|
- [协议合约](api.md):发布端视角的清单 / 包 / 许可证摘要与本仓库特有接口;权威源在 `soft_quay` 仓库。
|
|
- [当前实现状态](current-state.md):可覆盖的当前快照。
|
|
- [Agent 上下文清单](agent-context.md) / [`agent-context.json`](agent-context.json) / [`Schema`](agent-context.schema.json):按任务类型选择文档。
|
|
- [收尾检查清单](clean-state-checklist.md):会话结束前逐项检查。
|
|
- [`../init.sh`](../init.sh) / [`../init.ps1`](../init.ps1):标准启动与验证入口(W-001 前为占位符)。
|
|
- [`../scripts/validate_agent_context.py`](../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` 进入。
|