ahtserhsuddav/project-setup

Projekteinrichtung

Jeder Schritt verwendet die offizielle CLI oder Dokumentation des betreffenden Tools (Skill official-docs). Fragen Sie vor allem, was Remote betrifft.

Gerade erstellt (die CLI hat bereits alles eingerichtet, installiert und überprüft)

1. Lesen Sie PROJECT.md und füllen Sie Was (Name, Domain, Typ, Zweck) mit dem Menschen aus, in seinen eigenen Worten. {{#dotenv}}
2. Der Mensch kopiert .env.example zu .env und füllt es aus{{#auth}} ({{dlx}} auth@latest secret erzeugt das Auth-Secret){{/auth}}. Agenten erstellen, lesen oder schreiben niemals .env. Bis es existiert, testen Sie mit Wegwerfwerten, die nur für diesen Befehl gesetzt werden. {{/dotenv}} {{#postgres}}
3. Lokale Datenbank: docker compose up -d, dann {{run}} db:migrate (vorher fragen). {{/postgres}} {{#d1}}
4. Lokale Datenbank: {{run}} db:migrate (vorher fragen). {{/d1}}
5. {{run}} docs:sync, dann füllen Sie docs/DEPLOYMENT.md (URLs, wo Secrets gesetzt sind). {{#cloudflare}} Ersetzen Sie die Platzhalter-IDs in wrangler.jsonc, sobald die Ressourcen existieren (DEPLOYMENT.md → Ersteinrichtung). {{/cloudflare}}
6. Lassen Sie design/DESIGN.md für das website-design Skill, das die Design-Inputs der Reihe nach vor der ersten Seite sammelt; die Startseite ist ein Platzhalter.
7. Sobald das Repository auf GitHub ist, schaltet der Mensch unter Einstellungen → Aktionen → Allgemein die Option „GitHub Actions erlauben, Pull Requests zu erstellen und zu genehmigen“ ein, damit das wöchentliche Agenten-Skills-Update seinen Pull Request öffnen kann. Dependabot und Workflow-Änderungen: Skills dependabot und github-actions-hardening.
8. {{run}} log "Projekt eingerichtet" --by <agent>.

Bestehendes Projekt (Übernahme des Kits)

1. {{dlx}} create-agent-ready-app@latest install . fügt nur die Agenteneinrichtung hinzu (AGENTS.md, Skills, Skripte, Guardrails); es erkennt die Add-ons aus package.json. Alte AGENTS.md, CLAUDE.md, .cursorrules und ähnliche Dateien werden nach docs/legacy-agents.md verschoben: Fassen Sie die noch geltenden Regeln in PROJECT.md → Regeln für Agenten zusammen und löschen Sie die Datei dann (fragen).
2. Füllen Sie PROJECT.md aus dem, was vorhanden ist (package.json, Routen, eine schnelle Ordnerauflistung). Erkunden Sie nicht tiefgehend.
3. Nehmen Sie keine Umstrukturierung vor. Listen Sie die Lücken (Struktur, Prüfungen, SEO, Sicherheit) als eine vorgeschlagene große Aufgabe auf und fragen Sie.

Später ein Add-on hinzufügen (Geschützt)

1. Stellen Sie eine Ja/Nein-Frage: das Add-on, die Pakete, die es hinzufügt, die Dateien, die es erstellt.
2. {{dlx}} create-agent-ready-app@latest add <add-on> . erstellt die noch nicht vorhandenen Dateien des Add-ons, aktualisiert AGENTS.md und die Skills, installiert sein Skill-Paket und gibt die hinzuzufügenden Pakete aus.
3. {{add}} diese Pakete. Dann binden Sie es in die Dateien ein, die das Projekt bereits besitzt, gemäß den Dateien des Add-ons im create-agent-ready-app Repository (template/frameworks/) und der offiziellen Dokumentation:
   • Abfrage: {{#tanstack-start}}src/router.tsx (QueryClient + SSR-Integration) und src/routes/__root.tsx (Devtools-Panel){{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx in src/app/layout.tsx{{/next}};
   • shadcn: {{dlx}} shadcn@latest apply --preset nova, dann add die benötigten Komponenten;
   • Auth: die Guards unter {{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} und {{run}} auth:generate, dann {{run}} db:generate.
4. {{run}} docs:sync, {{run}} check, aktualisieren Sie PROJECT.md → Stack und Entscheidungen und fügen Sie eine Logzeile hinzu.

Ein Add-on entfernen (Geschützt)

{{dlx}} create-agent-ready-app@latest remove <add-on> . entfernt seine Kit-Dateien, Skills, Skripte und Berechtigungen. Das Löschen seines Codes und seiner Pakete ist eine große Aufgabe: rg für jede Verwendung, dann löschen, dann {{run}} check.

Agenten-Skills

• Die Community-Skills in .agents/skills/ stammen von ihren Erstellern (skills-lock.json zeichnet jede Quelle und einen Hash auf). {{run}} skills:update aktualisiert sie; lesen Sie das Diff vor dem Commit, wie bei jeder Codeänderung.
• Weitere Skills: Bevorzugen Sie die offiziellen von den Machern der Tools (https://www.skills.sh/official); Skill find-skills, oder {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code (vorher fragen). Ein optionales Kit-Paket: {{dlx}} create-agent-ready-app@latest add <pack> . (Marketing, Security-Review…).

Das Kit aktualisieren

{{run}} kit:update aktualisiert AGENTS.md, Skills und Skripte. Im Projekt geänderte Kit-Dateien werden beibehalten und gemeldet; fügen Sie projektspezifische Regeln in PROJECT.md ein, anstatt Kit-Dateien zu bearbeiten.