Projekty v ColdHost AI – jak nechat AI upravovat vaše soubory

Běžný chat je skvělý na jednotlivé dotazy, ale u skutečného projektu brzy narazíte: kopírujete soubory sem a tam, hlídáte, kterou verzi jste už upravili, a výsledek ručně skládáte dohromady. Projekty v ColdHost AI tohle řeší – AI vidí vaše soubory a může je přímo měnit.

Co projekt umí

• nahrát jednotlivé soubory nebo celý ZIP archiv,
• importovat repozitář z GitHubu,
• nechat AI upravovat soubory – celým přepsáním nebo cílenými úpravami,
• stáhnout výsledek jako ZIP,
• poslat změny zpět na GitHub jako novou větev nebo pull request.

Založení projektu a nahrání souborů

1. V aplikaci založte nový projekt a pojmenujte ho.
2. Nahrajte soubory. U většího projektu je nejpohodlnější ZIP.

Než ZIP vytvoříte, vynechte složky, které AI nepotřebuje a které by jen zabíraly místo:

zip -r projekt.zip . \
  -x "node_modules/*" "vendor/*" ".git/*" "dist/*" "build/*" \
  -x "*.log" ".env"

Soubor .env s hesly a API klíči do projektu nenahrávejte. Místo něj přiložte .env.example s prázdnými hodnotami, aby AI věděla, jaké proměnné aplikace používá.

Jak AI soubory upravuje

ColdHost AI má dva způsoby úprav:

Celý soubor – vhodné pro nové soubory nebo krátké soubory, kde se mění většina obsahu.

SEARCH/REPLACE – AI najde konkrétní úsek a nahradí ho novým. Princip vypadá takto:

<<<<<<< SEARCH
def get_user(id):
    return db.query(User).get(id)
=======
def get_user(user_id: int) -> User | None:
    return db.get(User, user_id)
>>>>>>> REPLACE

Výhoda je zřejmá: u souboru s pěti sty řádky se nepřepisuje všechno kvůli jedné funkci. Úprava je přesná, přehledná a spotřebuje méně tokenů.

Jak zadávat úkoly v projektu

Dobré zadání v projektu má tři části: co, kde a jak ověřit.

Přidej do API endpoint GET /api/health, který vrací {"status": "ok"}.
Routy jsou v src/routes/, registrace v src/app.ts.
Dodej i test do tests/health.test.ts ve stejném stylu jako ostatní testy.

Další tipy:

• Jedna logická změna na zadání. „Přidej health endpoint“ je lepší než „přidej health endpoint, přepiš autentizaci a aktualizuj README“.
• Odkazujte na existující vzory: „ve stejném stylu jako users.ts“.
• Po větší úpravě si nechte vypsat seznam změněných souborů, ať víte, co kontrolovat.

Kontrola změn

AI se může mýlit, proto změny před nasazením vždy projděte. Praktický postup po exportu:

unzip projekt-upraveny.zip -d projekt-novy
diff -ru projekt-puvodni/ projekt-novy/ | less

Nebo, pokud máte projekt v gitu, rozbalte export přes pracovní kopii a podívejte se na git diff:

cd muj-projekt
unzip -o ../projekt-upraveny.zip
git status
git diff

Pak spusťte testy a linter, než změny commitnete.

Export a GitHub

Hotový projekt stáhnete jako ZIP. Pokud jste projekt importovali z GitHubu, můžete změny poslat zpět jako novou větev nebo rovnou jako pull request – podrobnosti najdete v samostatném návodu k importu a pushi na GitHub.

Kdy projekt a kdy obyčejný chat

Situace	Doporučení
Dotaz na jeden úryvek kódu	chat
Oprava chyby v jednom souboru	chat s přílohou
Změny napříč více soubory	projekt
Nová funkce do existující aplikace	projekt
Opakovaná práce na stejném kódu	projekt

Na co si dát pozor

• Tajné údaje – hesla, tokeny a privátní klíče do projektu nepatří.
• Velké binární soubory – obrázky, videa, databázové dumpy AI k úpravě kódu nepotřebuje.
• Generovaný kód – dist/, build/, lock soubory zbytečně zvětšují kontext.

Projekt s čistým zdrojovým kódem bez balastu znamená přesnější úpravy a nižší spotřebu tokenů.