# Skelet

Skelet 是一个面向 AI coding 开发者、独立开发者和小团队的开源项目骨架导航与评测网站。

第一版目标是把“我应该基于哪个稳定骨架开始新项目”这个决策做清楚：按场景分类，按语言和框架筛选，提供骨架项目详情、AI Coding 友好度评分、适用/不适用场景和基础对比。

## 当前状态

当前仓库只完成 harness coding 文档初始化，尚未初始化生产代码。

下一步任务见 [`docs/06-tasks.md`](docs/06-tasks.md)：先初始化 Wagtail 项目骨架，再实现内容模型和 MVP 页面。

## 技术方案摘要

| 维度 | 第一版选择 |
| --- | --- |
| 后端 / CMS | Wagtail |
| Web 框架 | Django |
| Python | 3.12 |
| 数据库 | SQLite with JSON1 |
| 部署目标 | 2 核 2G VPS 可运行 |
| 账号体系 | 第一版只使用 Wagtail 管理后台账号 |
| 前台用户注册 | MVP 不做 |

详细选型见 [`docs/03-tech-stack.md`](docs/03-tech-stack.md)，架构见 [`docs/04-architecture.md`](docs/04-architecture.md)。

## 文档入口

- [`AGENTS.md`](AGENTS.md)：Codex / 通用 AI coding agent 仓库级入口。
- [`CLAUDE.md`](CLAUDE.md)：Claude Code 薄入口。
- [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)：每轮 AI 开发入口。
- [`docs/01-vision.md`](docs/01-vision.md)：项目愿景和非目标。
- [`docs/02-requirements.md`](docs/02-requirements.md)：MVP 需求与验收标准。
- [`docs/03-tech-stack.md`](docs/03-tech-stack.md)：技术栈、运行命令、依赖纪律。
- [`docs/04-architecture.md`](docs/04-architecture.md)：系统结构、数据模型、开发顺序。
- [`docs/05-coding-rules.md`](docs/05-coding-rules.md)：AI 编码硬规则。
- [`docs/06-tasks.md`](docs/06-tasks.md)：任务看板。
- [`progress.md`](progress.md)：执行历史流水。
- [`docs/current-state.md`](docs/current-state.md)：当前实现状态快照。

## 开发原则

- 先内容闭环，再商业化。
- 先场景分类，再语言筛选。
- 先 Wagtail + SQLite 上线验证，再按需要迁移 PostgreSQL。
- 第一版不做用户注册、评论、收藏、付费会员和复杂搜索。
- 每轮 AI coding 只领取一个任务，完成后更新任务状态、进度和当前状态。

## 标准开工方式

生产代码尚未初始化，因此根目录 `init.ps1` / `init.sh` 仍保留模板占位命令。完成 `T-001` 后必须替换脚本顶部安装、验证和启动命令，并同步更新：

- [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)
- [`docs/03-tech-stack.md`](docs/03-tech-stack.md)
- [`docs/05-coding-rules.md`](docs/05-coding-rules.md)
- [`docs/current-state.md`](docs/current-state.md)

在此之前，任何 agent 不得宣称项目“可运行”。