---
name: research-scaffold
description: Set up a new research project using the agreed workspace
  and layout conventions. Use when asked to create a project.
---

Read the workspace index and project-layout conventions if available.
Confirm the project's purpose, intended output, and where its folder should be created.
Propose the folder structure before creating it. Preserve existing files.

After the researcher accepts the structure:
- Create only the folders needed for the intended output.
- Draft CLAUDE.md (or AGENTS.md) with instructions and paths to the other
  project context files and relevant conventions.
- Add status and task records appropriate to the work already agreed.
- Record unresolved research decisions as questions, not assumed facts.
- For a paper project, write SPECIFICATION.md from the researcher's current
  decisions and start METHODOLOGY.md with decisions actually made and their reasons.
  Leave unresolved choices explicit; do not invent a history.
- In CLAUDE.md (or AGENTS.md), tell the agent to follow SPECIFICATION.md when
  implementing or checking the analysis and consult METHODOLOGY.md for rationale.
  Approved scientific changes update both: rewrite the specification and add a
  dated decision at the top of the log, preserving earlier entries.

Check the result:
- Confirm that the created paths match the accepted structure.
- Check that the instructions refer to files that exist, or clearly identify
  files still to be supplied or created.
- Confirm that existing files were preserved.
- Show the folder structure, the project context files, and unresolved decisions.

Ask before changing an existing project or adding software or services.
Do not acquire data, fit models, or publish files as part of this setup.
