feat: project setup — research structure, specs, decisions, conventions #1

2026-05-27T22:00:48Z

mathias commented

2026-05-27 22:00:48 +00:00

What this does

Full project setup from template. The template scaffolded Go-web boilerplate (hostexecutor, Templ, HTMX) which has been replaced entirely with research-appropriate structure.

Files replaced / written

File	Change
`README.md`	Project overview, hypothesis, phase table, architecture split
`DECISIONS.md`	All post-grill architectural and methodology decisions
`.context/PROJECT.md`	Research conventions, agent instructions, brain wing pointer
`CLAUDE.md` / `AGENTS.md`	Synced stubs pointing to PROJECT.md
`Taskfile.yml`	Research tasks: data:fetch, data:process, experiment:run, eval:*, model:train
`.gitignore`	Research-appropriate: data/, experiments/*/embeddings/, results/raw/ gitignored
`.context/mcp.json`	brain + gitea only (removed infra/knowledge)

Files added

File	Purpose
`specs/phase-0-ssl-feasibility.md`	Phase 0 experiment spec (MAE baseline feasibility gate)
`specs/phase-1-representation-poc.md`	Phase 1 experiment spec (JEPA representation PoC)
`data/README.md`	DUKASCopy download instructions; split definitions; cutoff policy
`experiments/README.md`	Run naming convention; git tag convention
`results/README.md`	Summary format; null result policy
`notebooks/README.md`	EDA-only policy; output stripping rule
`model/README.md`	Python perimeter policy; setup instructions
`.skills/README.md`	Active skills index

Files removed / to be cleaned up

Dockerfile — not needed for a research project (leave for now, address in issue)
.gitea/workflows/cd.yml — Go-web CD pipeline; not applicable
cmd/ / internal/ — empty Go-web scaffolding; will be populated with research Go code in Phase 0

## What this does Full project setup from template. The template scaffolded Go-web boilerplate (hostexecutor, Templ, HTMX) which has been replaced entirely with research-appropriate structure. ## Files replaced / written | File | Change | |---|---| | `README.md` | Project overview, hypothesis, phase table, architecture split | | `DECISIONS.md` | All post-grill architectural and methodology decisions | | `.context/PROJECT.md` | Research conventions, agent instructions, brain wing pointer | | `CLAUDE.md` / `AGENTS.md` | Synced stubs pointing to PROJECT.md | | `Taskfile.yml` | Research tasks: data:fetch, data:process, experiment:run, eval:*, model:train | | `.gitignore` | Research-appropriate: data/, experiments/*/embeddings/, results/raw/ gitignored | | `.context/mcp.json` | brain + gitea only (removed infra/knowledge) | ## Files added | File | Purpose | |---|---| | `specs/phase-0-ssl-feasibility.md` | Phase 0 experiment spec (MAE baseline feasibility gate) | | `specs/phase-1-representation-poc.md` | Phase 1 experiment spec (JEPA representation PoC) | | `data/README.md` | DUKASCopy download instructions; split definitions; cutoff policy | | `experiments/README.md` | Run naming convention; git tag convention | | `results/README.md` | Summary format; null result policy | | `notebooks/README.md` | EDA-only policy; output stripping rule | | `model/README.md` | Python perimeter policy; setup instructions | | `.skills/README.md` | Active skills index | ## Files removed / to be cleaned up - `Dockerfile` — not needed for a research project (leave for now, address in issue) - `.gitea/workflows/cd.yml` — Go-web CD pipeline; not applicable - `cmd/` / `internal/` — empty Go-web scaffolding; will be populated with research Go code in Phase 0 ## Related - Brain wing: `jepa-fx` — all decisions mirrored there - Skills PR: `mathias/skills#feat/experiment-spec-skill` — new experiment-spec skill

mathias added 16 commits 2026-05-27 22:00:48 +00:00

docs: seed README with project overview, hypothesis, phase table f7dbe5cc1c

docs: write PROJECT.md — research conventions, hypothesis, agent instructions a2414cf4c9

chore: sync CLAUDE.md and AGENTS.md from PROJECT.md 668f800868

chore: sync AGENTS.md from PROJECT.md cf1c47048f

chore: replace Go-web Taskfile with research task definitions 2112b3f765

chore: replace .gitignore with research-appropriate rules 414ad1bdb2

chore: update mcp.json — brain + gitea only (no infra/knowledge for research project) 5c24864021

docs: write DECISIONS.md — all post-grill architectural and methodology decisions 192651cb66

docs: add Phase 0 experiment spec (SSL feasibility gate) 4338abf176

docs: add Phase 1 experiment spec (JEPA representation PoC) a27200cc5e

docs: add data/README.md — download instructions and split definitions 4608c8ee29