Internal Documentation internal
TalkIDE internal documentation

STATUS: DEPRECATED

Tento dokument popisoval samostatný BE-managed sidecar soubor <project>/.project-config.yml. Po refaktoru per-project architektury byl tento soubor sloučen s novým souborem <project>/.talkide/project.yml, který drží kompletní konfiguraci projektu (meta + porty + URLs + DB credentials).

Aktivní zdroj pravdy: per-project-architecture.md

Tento dokument zůstává pro historický kontext (vysvětlení privacy boundary a odůvodnění oddělení BE-only dat od LLM-shared CLAUDE.md). Novou implementaci řiďte výhradně podle per-project-architecture.md.

Co se změnilo

AspektPřed (deprecated)Nyní
Cesta<project>/.project-config.yml<project>/.talkide/project.yml
Obsahjen database sekceid, slug, name, description, accent, backend, frontend, urls, a budoucí database
Lokaceroot projektu (vedle CLAUDE.md)uvnitř BE-managed .talkide/ adresáře
PrivacyBE-only, sensitivestejně — BE-only, sensitive (privacy boundary nezměněna)
Kdo píšeCreateProjectUseCase (jednou)CreateProjectUseCase (eager) + ClaudeCliService.startProcess (lazy guard)
Kdo čteProjectConfigService, DB Explorer use casestotožní + plugin skripty přes yq

Privacy boundary — zůstává v platnosti

Privacy princip popsaný v této specifikaci (oddělení sensitive operačních dat od LLM-shared CLAUDE.md) zůstává stejný — jen se přesunul ze starého souboru na nový:

Anything in .talkide/project.yml stays inside TalkIDE infrastructure and MUST NOT be sent to the LLM. It MAY contain sensitive data (DB password, API tokens). The privacy contract is identical to the deprecated .project-config.yml.

Anything in <project>/CLAUDE.md is shared with Anthropic as part of the LLM context (their infrastructure, logs, retention windows, prompt cache). Therefore CLAUDE.md may contain ONLY data with explicit user consent (see mara-context.md → Privacy principle).

Když přidáváš nové pole, rozhodni se na základě jediné otázky: musí to vidět LLM? Pokud ano → CLAUDE.md (ověř consent). Pokud ne → .talkide/project.yml.

Migrace

Stávající projekty v workspace/output-projects/ se vymažou (nikdo je nepoužívá v produkci) — žádný migration script ze .project-config.yml do .talkide/project.yml. Nové projekty vznikají rovnou v cílové struktuře.

Detail viz per-project-architecture.md → sekce “Migrace stávajících projektů”.

Historický obsah (pro referenci)

Pro úplnost historie — toto byl původní obsah .project-config.yml:

# .project-config.yml — DEPRECATED, nahrazeno .talkide/project.yml
database:
  engine: postgres
  version: 17
  host: localhost
  port: 5432
  name: clay-co
  username: root
  password: 30+Dodge+78

V nové architektuře se DB sekce stane součástí .talkide/project.yml (viz per-project-architecture.md — schéma souboru bude rozšířeno o database sekci až jí budou agenti potřebovat; v MVP je DB konfigurace generována z BE defaults a držena v paměti BE).


Was this page helpful?

Thanks for the feedback.