Communitygithub.com

FelipeStruchel/landing-page-skills

Verwenden, wenn eine Landing Page über die statische Seite hinaus Software benötigt: Terminplanung oder Buchung, Dashboard, API, Datenbank, transaktionale E-Mail, Benachrichtigung oder jeder Dienst, der auf dem Server neben einem anderen System läuft. Nicht für reine HTML-, CSS- und JS-Seiten verwenden.

Was ist landing-page-skills?

Dieses Skill definiert den Prozess für die Entwicklung von Software-Extras (Buchungssysteme, APIs, Datenbanken, E-Mail-Benachrichtigungen) auf Landing Pages, die über statische Seiten hinausgehen. Es schreibt eine strenge Genehmigungshierarchie vor, bei der der Projektbesitzer (Felipe) jede Architekturentscheidung autorisieren muss, bevor Code umgesetzt wird. Das Skill enthält eine Gate-Funktion, die Entwickler anleitet, offene Entscheidungen zu katalogisieren, Alternativen mit Kostenbewertung zu empfehlen, Entscheidungen in `03-decisoes.md` zu protokollieren und erst nach expliziter Freigabe durch Felipes Befehl zu implementieren. Es erzwingt TDD, unabhängige Überprüfung und einen Post-Deployment-Health-Check mit realen Nachbarsystemen, wobei Red Flags (wie nicht genehmigte Datenbankauswahl oder Namenskonflikte wie `api`) sofortigen Stopp erzwingen. Das Skill unterstützt jede Umgebung, die Node.js und docker ausführen kann, und ist plattformunabhängig.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FelipeStruchel/landing-page-skills/tree/HEAD/skills/landing-software-extra

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation


name: landing-software-extra description: Verwenden, wenn eine Landing Page über die statische Seite hinaus Software benötigt: Terminplanung oder Buchung, Dashboard, API, Datenbank, transaktionale E-Mail, Benachrichtigung oder jeder Dienst, der auf dem Server neben einem anderen System läuft. Nicht für reine HTML-, CSS- und JS-Seiten verwenden.

Landing: Software extra

Die Architekturentscheidung liegt beim Projektinhaber. Den Buchstaben zu verletzen bedeutet, den Geist zu verletzen.

Ehernes Gesetz

KEINE ENTSCHEIDUNG ÜBER STACK, NETZWERK ODER GEMEINSAME RESSOURCE
OHNE VORHERIGE RÜCKFRAGE. HOCHRISIKOPHASE: AKZEPTIERE NUR ÜBER FELIPES BEFEHL.

Erste Aktion: node check-gate.js --cliente <Name> --antes-de software-extra ausführen; 01 und plano.md lesen; references/agendamento.md lesen, falls eine Buchung vorhanden ist.

Gate-Funktion

  1. Liste die offenen Entscheidungen auf (Stack, Datenbank, Ausführungsort, gemeinsam genutzte Ressourcen, E-Mail, Benachrichtigung, Backup).
  2. Für jede: Optionen, Empfehlung mit Begründung, Kosten bei Fehlentscheidung. Frage nach; wähle nicht.
  3. Halte in 03-decisoes.md fest (D). Bei Verstoß gegen eine globale Regel override: R-nnn mit Felipes Genehmigung eintragen.
  4. Felipe führt ! node approve.js --file <03> --fase software-extra --via comando aus. Erst dann implementieren.
  5. Implementiere mit TDD. Unabhängiger Prüfer am Ende.
  6. Nach dem Deployment: echter Pfad des Nachbarsystems (z. B. GET /api/health des anderen Systems) sowie docker logs <proxy> --since 2m | grep -c "502|refused".

Feste Regeln

  • Projektpräfix für jeden Dienst, Container und Alias des gemeinsamen Netzwerks (agenda-api, agenda-db). Vor dem Beitritt zu einem Netzwerk die Namen auflisten, die der Nachbar auflöst (set $api, upstream, proxy_pass).
  • Geheimnisse nur in der .env-Datei des Servers, Berechtigung 600; im Chat übertragene Werte sollten ausgetauscht werden.
  • Zeiten, Dienste und Preise stammen aus einer Quelle (der Datenbank); das statische HTML ist nur Reserve.
  • Optionenname und Dauer sind unterschiedliche Felder; die Ansicht entscheidet, was nach expliziter Regel angezeigt wird.
  • Interne Ansicht durchläuft landing-direcao-visual und frontend-design; Ergänzung erfolgt mit Mockup und Einzelprüfung.
  • Produktion: Backup vorher, nginx -t vor Neuladen, Fenster ohne Ausfallzeit, schriftliche Rücknahmeanweisung. Was root erfordert, wird zu einer Zeile für Felipe.

Rote Flaggen: Stopp

  • Auswahl der Datenbank „weil sie die beste ist“ · Wiederverwendung des Namens api · Deployment ohne Backup
  • Wiederholung eines 5.000-zeiligen Plans auf dem Server, den Sie selbst ausführen würden
  • „Läuft bei mir“ ohne Test des Nachbarn
RationalisierungRealität
„Die Wahl ist offensichtlich“Wenn Felipe es durch den Code entdecken würde, wäre er überrascht? Dann frage.
„Der kurze Name ist sauberer“api im edge-Netzwerk brachte den Nachbarn mit 502 zu Fall.
„Die Genehmigung galt für die Landing Page“Zustimmung in einem Kontext gilt nicht für den anderen.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

FelipeStruchel/landing-page-skills

Use when o Felipe pede para criar, montar, refazer ou retomar uma landing page ou site de uma página para um negócio ou cliente, ou abre uma pasta de cliente em criar-site/. Não use para redesenhar as próprias skills (landing-evoluir-skill).

FelipeStruchel/landing-page-skills

Use when começa um cliente novo de landing page sem 01-negocio-e-escopo.md aprovado, quando faltam dados do negócio, mídias, nomes ou perfis, ou quando o Felipe pede o questionário de entrada. Não use para escolher estilo visual (landing-direcao-visual).

FelipeStruchel/landing-page-skills

Use when o 01-negocio-e-escopo.md está aprovado e falta escolher o estilo visual de uma landing page, ou quando uma tela interna (agenda, painel) de um cliente precisa de visual. Não use para levantar dados do negócio (landing-descoberta).

FelipeStruchel/landing-page-skills

Use when o Felipe pede para redesenhar skills de landing page, revisar aprendizados acumulados, processar feedbacks pendentes, atualizar o _regras-vivas.md, fazer a migração inicial das regras, ou quando o Passo 0 oferece a migração. Não use durante a construção de um cliente.

FelipeStruchel/landing-page-skills

Use when uma landing page está pronta para ir ao ar: publicar, fazer deploy, configurar domínio ou Cloudflare, limpar cache, ou conferir o site já publicado. Não use para construir a página (criar-landing-page).

FelipeStruchel/landing-page-skills

Use when SEMPRE durante o trabalho em uma landing page de cliente: ao entregar qualquer coisa (texto, foto, tela, deploy) e ao receber reação, correção, elogio ou aprovação do Felipe ou do cliente.

Verwandte Skills