AGENTS.md |
AI coding agent 仓库级入口(含硬性架构边界) |
CLAUDE.md |
Claude Code 薄入口,规则以 AGENTS.md 为准 |
init.sh / init.ps1 |
标准启动与验证入口脚本,按操作系统二选一 |
progress.md |
可选历史归档 / 项目级大事记 |
docs/README.md |
文档导航 |
docs/00-ai-start-here.md |
agent 入口、阅读顺序、任务领取规则 |
docs/01-vision.md |
项目愿景与非目标 |
docs/02-requirements.md |
需求、用户故事、验收标准 |
docs/03-tech-stack.md |
Go + Gio 双工具链矩阵与构建命令 |
docs/04-architecture.md |
分层结构、目录、数据模型、安全流程 |
docs/05-coding-rules.md |
编码硬规则(分层、工具链、安全纪律) |
docs/06-tasks.md |
任务路线图(Phase 0-6、里程碑、Backlog) |
docs/tasks/README.md |
一任务一文件约定 |
docs/api.md |
Catalog / 软件包 / 许可证 / 事件 / CLI 协议合约 |
docs/routes.md |
Gio 视图结构与交互约束 |
docs/troubleshooting.md |
unsafe_cache 等人工故障排查与安全恢复步骤 |
docs/current-state.md |
当前实现状态快照 |
docs/agent-context.md / docs/agent-context.json / docs/agent-context.schema.json |
上下文路由清单及其契约 |
docs/adoption-checklist.md |
已有项目接入迁移清单(备查) |
docs/clean-state-checklist.md |
会话收尾检查清单 |
docs/method-map.md |
失败模式 → 首要修复 → 工件对照表 |
docs/evaluator-rubric.md |
单次会话输出评审评分表 |
docs/quality-document.md |
代码库长期健康度追踪 |
docs/gitea-mcp.md / docs/gitea-collaboration.md |
可选 Gitea 协作(当前未启用) |
gitea.env.example |
Gitea MCP 本机私有配置示例;真实文件不得入库 |
scripts/validate_agent_context.py |
校验上下文清单、Schema 和仓库相对路径 |
scripts/validate_harness_governance.py |
离线检查导航、链接、任务、模板和敏感信息 |
scripts/setup_gitea_labels.py |
Gitea 协作标签初始化(未启用,备查) |
scripts/audit_gitea_coordination.py |
只读审计远端任务协调(未启用,备查) |
scripts/test_gitea_claim_race.py |
claim 分支并发兼容性 smoke(未启用,备查) |
tests/test_governance.py |
标准库治理回归测试 |
.gitea/ISSUE_TEMPLATE/task.md / .gitea/PULL_REQUEST_TEMPLATE.md |
Gitea 任务 Issue 与 PR 模板(未启用,备查) |
.gitea/workflows/harness-governance.yml |
push / PR 离线治理检查工作流模板 |
