Chapters · 14. Preparing a folder that is not a project

Describes Team AI Console 0.4.13 · updated 2026-11-06

14. Preparing a folder that is not a project

If you open a folder that has no team-ai-console.json, the app shows “This folder cannot be opened as a Team AI Console project yet” with what is missing and these options, depending on what it finds:

  • Adopt this project with a team… — if the folder has code but no team (see Adopting).
  • Yes, analyze the folder with the AI — if there is a folder with team documents (team/, roles/, agents/…) but no configuration: the agent (Claude Code or Codex; with both installed, the one you are signed in to) reads it and proposes the configuration (roles, workflow document and steps). The agent only reads; the app validates and writes the files. If it does not find a clear definition of the team and its roles, it writes nothing and explains why.
  • Generate team-ai-console.json from … — if the project uses the team document from earlier versions (the button names that previous-format file).
  • Create team-ai-console.json with the example team — writes a complete, commented example for you to edit.
  • Open folder and Check again.