项目文档导航
一句话定位
Skelet 是一个面向 AI coding 开发者、独立开发者和小团队的开源项目骨架导航与评测网站，用于解决“从哪个稳定骨架开始新项目更省 token、更省时间、更不容易跑偏”的决策问题，第一版先完成“浏览分类 -> 筛选骨架 -> 查看详情与评分 -> 形成选型判断”的 MVP 闭环。
文档导航
../AGENTS.md：Codex / 通用 AI coding agent 的仓库级入口。../CLAUDE.md：Claude Code 的薄入口，具体规则以AGENTS.md为准。../tasks.md：根目录任务入口，指向06-tasks.md。../progress.md：执行历史流水，只追加记录任务执行、验证、阻塞和决策。- AI 开发入口：agent 每次开始工作的入口、阅读顺序和任务领取规则。
- 项目愿景：为什么做、为谁做、产品原则、非目标。
- 需求：MVP 要什么、怎么算达成。
- 技术栈：Wagtail / Django / Python / SQLite 等技术选型和运行命令。
- 架构设计：系统结构、模块职责、数据模型、关键风险和开发顺序。
- 编码规则：AI 写代码前必须遵守的硬约束。
- 任务看板：按依赖拆分的小任务，agent 每轮只做一个。
- API 合约：MVP 不提供公开 API，记录 Wagtail 路由、后续 API 边界。
- 路由与页面结构：前台页面、后台路由、页面职责和组件归属。
- 当前实现状态：当前仓库现实状态、可运行命令和下一步任务。
- 收尾检查清单：会话结束前逐项检查，保证下一轮无需人工修复即可继续。
- 已有项目接入清单：已有代码库接入 harness 文档时使用，本项目当前是空项目初始化。
- 方法对照表：失败模式与首要修复工件。
- 评审评分表：单次会话输出质量评审。
- 质量文档：代码库长期健康度追踪。
../init.sh/../init.ps1：标准启动与验证入口脚本；生产代码初始化后再替换真实命令。
任务 / 进度 / 当前状态
06-tasks.md维护任务看板：任务 ID、依赖、验收要点和状态。../progress.md维护执行进度：每轮实际做了什么、跑了什么验证、遇到什么阻塞、做了什么决策。current-state.md维护当前快照：当前目录、当前可运行命令、已完成任务摘要和下一个可领取任务。
维护原则
- 需求变化先改
02-requirements.md，再改代码。 - 技术方案变化先改
03-tech-stack.md和04-architecture.md，再改代码。 - 代码现实变化后同步
current-state.md和06-tasks.md，执行过程追加到../progress.md。 - MVP 范围外的商业化、会员、用户投稿、复杂搜索只进入 Backlog，不提前实现。