A starter for AI-assisted repositories. It enforces the documentation layout used by DeepSeek Harness (nested AGENTS.md, path-encoded Agent Notes, one home per fact) and adds a scientific-method experiment tree.
This is not a fork of the harness. Product, plugin, and bilingual machinery stay with upstream.
git clone https://github.com/bigwolfeman/ai-project-template.git my-project
cd my-project
python scripts/verify_template.pyThen follow .agents/cookbook/starting-a-project.md.
| Kind of work | Where it goes |
|---|---|
| Standing orders | AGENTS.md |
| Project vision (fill at start) | docs/constitution.md |
| Design decisions | .agents/notes/ |
| How-tos | .agents/cookbook/ |
| Experiments | lab/experiments/ — predictions first |
| Escaped bugs | .agents/postmortem/ |
| Spikes | lab/spikes/ — informal exploration; no prior hypothesis |
| Campaigns | lab/campaigns/ — bounded programs with trials |
| Production code | src/ |
Incomplete/ and ignored/ are gitignored. Put local clones and bulky artifacts in ignored/. Campaign worktrees live under ignored/research/<slug>/.
python scripts/verify_template.py