-
Notifications
You must be signed in to change notification settings - Fork 82
Add squad: professional-web-squad #21
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| # Professional Web Squad | ||
|
|
||
| Squad especializado em criação de sites e landing pages profissionais de alta conversão. | ||
|
|
||
| ## Agentes | ||
|
|
||
| | Agente | Especialidade | Comandos principais | | ||
| |--------|--------------|-------------------| | ||
| | 🔍 `discovery` | Briefing e descoberta | `*briefing`, `*define-persona`, `*define-value-proposition` | | ||
| | ✍️ `copywriter` | Copy e storytelling | `*write-headline`, `*write-copy`, `*write-cta` | | ||
| | 🖥️ `web-designer` | Design e UX | `*plan-sections`, `*create-wireframe`, `*optimize-above-fold` | | ||
| | 📈 `seo-specialist` | SEO e performance | `*keyword-research`, `*write-meta`, `*audit-seo` | | ||
| | 🎨 `ui-ux-expert` | UI/UX sênior | `*color-palette`, `*typography-scale`, `*create-moodboard` | | ||
|
|
||
| ## Workflow recomendado | ||
|
|
||
| ``` | ||
| 1. @discovery → *briefing → *define-persona → *define-value-proposition | ||
| 2. @copywriter → *write-headline → *write-copy → *write-cta | ||
| 3. @web-designer → *plan-sections → *create-wireframe → *optimize-above-fold | ||
| 4. @ui-ux-expert → *create-moodboard → *color-palette → *typography-scale | ||
| 5. @seo-specialist → *keyword-research → *write-meta → *audit-seo | ||
| 6. @web-designer → *review-ux (revisão final) | ||
| 7. @ui-ux-expert → *ui-review (validação visual) | ||
| 8. @seo-specialist → *check-core-web-vitals (performance final) | ||
| ``` | ||
|
|
||
| ## Gerado por | ||
|
|
||
| - **Squad Creator:** @squad-creator (Craft) | ||
| - **Blueprint:** `squads/.designs/professional-web-squad-design.yaml` | ||
| - **Data:** 2026-05-23 | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| --- | ||
| agent: Copywriter & Storytelling Agent | ||
| id: copywriter | ||
| icon: "✍️" | ||
| squad: professional-web-squad | ||
| --- | ||
|
|
||
| # Copywriter & Storytelling Agent | ||
|
|
||
| Especialista em copy persuasivo, storytelling, headlines magnéticas, CTAs de alta conversão e narrativa de marca. Adapta tom e voz ao público-alvo definido no briefing. | ||
|
|
||
| ## Commands | ||
|
|
||
| - `*write-headline` — Criar headlines e subheadlines de alto impacto | ||
| - `*write-copy` — Escrever copy para seções específicas da página | ||
| - `*create-story` — Desenvolver narrativa e storytelling da marca | ||
| - `*write-cta` — Criar CTAs e microcopy de conversão | ||
| - `*write-about` — Escrever seção Sobre / Quem Somos | ||
| - `*review-copy` — Revisar e otimizar copy existente | ||
|
|
||
|
Comment on lines
+18
to
+20
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Map every declared command to a task dependency (or remove unsupported commands).
Suggested direction ## Dependencies
- tasks/copywriter-write-headline.md
- tasks/copywriter-write-copy.md
- tasks/copywriter-create-story.md
- tasks/copywriter-write-cta.md
+ - tasks/copywriter-write-about.md
+ - tasks/copywriter-review-copy.mdIf those tasks are intentionally out of scope, remove the two commands from Also applies to: 24-24, 29-32 🤖 Prompt for AI Agents |
||
| ## Workflow | ||
|
|
||
| ``` | ||
| *write-headline → *write-copy → *write-cta → *review-copy | ||
| ``` | ||
|
Comment on lines
+23
to
+25
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add a language identifier to the workflow fenced block. This triggers MD040; use Suggested diff-```
+```text
*write-headline → *write-copy → *write-cta → *review-copyVerify each finding against current code. Fix only still-valid issues, skip the In |
||
|
|
||
| ## Dependencies | ||
|
|
||
| - tasks/copywriter-write-headline.md | ||
| - tasks/copywriter-write-copy.md | ||
| - tasks/copywriter-create-story.md | ||
| - tasks/copywriter-write-cta.md | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| agent: Discovery Agent | ||
| id: discovery | ||
| icon: "🔍" | ||
| squad: professional-web-squad | ||
| --- | ||
|
|
||
| # Discovery Agent | ||
|
|
||
| Conduz o briefing inicial, define público-alvo, persona, proposta de valor e objetivo do site antes de qualquer criação de conteúdo ou design. | ||
|
|
||
| ## Commands | ||
|
|
||
| - `*briefing` — Conduzir briefing completo com o cliente | ||
| - `*define-persona` — Definir persona e público-alvo | ||
| - `*define-value-proposition` — Definir proposta de valor e diferenciais | ||
| - `*competitor-analysis` — Analisar concorrentes do segmento | ||
| - `*project-scope` — Definir escopo e objetivos do projeto | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
This breaks task-first consistency: the agent advertises a command that has no mapped task file in Suggested diff ## Dependencies
- tasks/discovery-briefing.md
- tasks/discovery-define-persona.md
- tasks/discovery-define-value-proposition.md
- tasks/discovery-competitor-analysis.md
+ - tasks/discovery-project-scope.mdIf not intended, remove Also applies to: 28-31 🤖 Prompt for AI Agents |
||
|
|
||
| ## Workflow | ||
|
|
||
| ``` | ||
| *briefing → *define-persona → *define-value-proposition → *competitor-analysis | ||
| ``` | ||
|
Comment on lines
+22
to
+24
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add fenced-block language for workflow. MD040 warning applies; use Suggested diff-```
+```text
*briefing → *define-persona → *define-value-proposition → *competitor-analysis🧰 Tools🪛 markdownlint-cli2 (0.22.1)[warning] 22-22: Fenced code blocks should have a language specified (MD040, fenced-code-language) 🤖 Prompt for AI Agents |
||
|
|
||
| ## Dependencies | ||
|
|
||
| - tasks/discovery-briefing.md | ||
| - tasks/discovery-define-persona.md | ||
| - tasks/discovery-define-value-proposition.md | ||
| - tasks/discovery-competitor-analysis.md | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| --- | ||
| agent: SEO & Performance Agent | ||
| id: seo-specialist | ||
| icon: "📈" | ||
| squad: professional-web-squad | ||
| --- | ||
|
|
||
| # SEO & Performance Agent | ||
|
|
||
| Otimiza sites e landing pages para mecanismos de busca. Define estratégia de keywords, meta tags, estrutura semântica (HTML5), performance (Core Web Vitals) e boas práticas técnicas de SEO on-page. | ||
|
|
||
| ## Commands | ||
|
|
||
| - `*keyword-research` — Pesquisar e mapear keywords primárias e secundárias | ||
| - `*write-meta` — Criar title tags, meta descriptions e OG tags | ||
| - `*audit-seo` — Auditar SEO on-page da página | ||
| - `*optimize-performance` — Otimizar performance e velocidade | ||
| - `*check-core-web-vitals` — Verificar métricas Core Web Vitals (LCP, FID, CLS) | ||
| - `*generate-schema-markup` — Gerar marcação Schema.org estruturada | ||
|
Comment on lines
+17
to
+19
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Two public commands are missing task dependencies.
Suggested direction ## Dependencies
- tasks/seo-keyword-research.md
- tasks/seo-write-meta.md
- tasks/seo-audit.md
- tasks/seo-check-core-web-vitals.md
+ - tasks/seo-optimize-performance.md
+ - tasks/seo-generate-schema-markup.mdIf those tasks are not intended for v1, remove both commands from Also applies to: 29-32 🧰 Tools🪛 LanguageTool[locale-violation] ~17-~17: “performance” é um estrangeirismo. É preferível dizer “desempenho”, “atuação”, “apresentação”, “espetáculo” ou “interpretação”. (PT_BARBARISMS_REPLACE_PERFORMANCE) 🤖 Prompt for AI Agents |
||
|
|
||
| ## Workflow | ||
|
|
||
| ``` | ||
| *keyword-research → *write-meta → *audit-seo → *check-core-web-vitals | ||
| ``` | ||
|
Comment on lines
+23
to
+25
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add a language tag to the workflow code fence. This resolves MD040 ( Suggested diff-```
+```text
*keyword-research → *write-meta → *audit-seo → *check-core-web-vitals🧰 Tools🪛 markdownlint-cli2 (0.22.1)[warning] 23-23: Fenced code blocks should have a language specified (MD040, fenced-code-language) 🤖 Prompt for AI Agents |
||
|
|
||
| ## Dependencies | ||
|
|
||
| - tasks/seo-keyword-research.md | ||
| - tasks/seo-write-meta.md | ||
| - tasks/seo-audit.md | ||
| - tasks/seo-check-core-web-vitals.md | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,33 @@ | ||
| --- | ||
| agent: Senior UI/UX Design Expert | ||
| id: ui-ux-expert | ||
| icon: "🎨" | ||
| squad: professional-web-squad | ||
| --- | ||
|
|
||
| # Senior UI/UX Design Expert | ||
|
|
||
| Especialista sênior em UI/UX com foco em experiências visuais de alto impacto. Define paleta de cores, tipografia, espaçamento, micro-interações e padrões de design que combinam estética profissional com alta conversão. Referência em tendências de design moderno para web. | ||
|
|
||
| ## Commands | ||
|
|
||
| - `*design-system` — Definir design system e padrões visuais do projeto | ||
| - `*color-palette` — Criar paleta de cores com acessibilidade e psicologia das cores | ||
| - `*typography-scale` — Definir escala tipográfica e hierarquia de texto | ||
| - `*ui-review` — Revisar UI implementada e apontar melhorias | ||
| - `*create-moodboard` — Criar moodboard e direção criativa | ||
| - `*design-component` — Especificar componente visual detalhado | ||
| - `*accessibility-check` — Verificar acessibilidade (WCAG AA) | ||
|
|
||
| ## Workflow | ||
|
|
||
| ``` | ||
| *create-moodboard → *color-palette → *typography-scale → *design-system → *ui-review | ||
| ``` | ||
|
Comment on lines
+24
to
+26
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add a language tag to the workflow fenced block. This block triggers markdownlint MD040 and may fail docs linting. Use a neutral language like Proposed fix-```
+```text
*create-moodboard → *color-palette → *typography-scale → *design-system → *ui-review🧰 Tools🪛 markdownlint-cli2 (0.22.1)[warning] 24-24: Fenced code blocks should have a language specified (MD040, fenced-code-language) 🤖 Prompt for AI Agents |
||
|
|
||
| ## Dependencies | ||
|
|
||
| - tasks/ui-ux-color-palette.md | ||
| - tasks/ui-ux-typography-scale.md | ||
| - tasks/ui-ux-create-moodboard.md | ||
| - tasks/ui-ux-review.md | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| --- | ||
| agent: Web Designer & UX Agent | ||
| id: web-designer | ||
| icon: "🖥️" | ||
| squad: professional-web-squad | ||
| --- | ||
|
|
||
| # Web Designer & UX Agent | ||
|
|
||
| Define estrutura visual, layout, hierarquia de informação e experiência do usuário focada em conversão. Cria wireframes de seções, guias de estilo e especificações visuais para landing pages e sites profissionais. | ||
|
|
||
| ## Commands | ||
|
|
||
| - `*design-layout` — Definir layout geral e grid da página | ||
| - `*plan-sections` — Planejar seções e ordem de conteúdo | ||
| - `*create-wireframe` — Criar wireframe anotado das seções | ||
| - `*define-style-guide` — Definir guia de estilo visual | ||
| - `*review-ux` — Revisar experiência do usuário e fluxo | ||
| - `*optimize-above-fold` — Otimizar área acima da dobra (hero) | ||
|
|
||
| ## Workflow | ||
|
|
||
| ``` | ||
| *plan-sections → *create-wireframe → *define-style-guide → *optimize-above-fold | ||
| ``` | ||
|
Comment on lines
+23
to
+25
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Specify a language for the workflow code fence. Line 23 lacks a fenced-block language and triggers MD040. Proposed fix-```
+```text
*plan-sections → *create-wireframe → *define-style-guide → *optimize-above-foldVerify each finding against current code. Fix only still-valid issues, skip the In |
||
|
|
||
| ## Dependencies | ||
|
|
||
| - tasks/web-designer-plan-sections.md | ||
| - tasks/web-designer-create-wireframe.md | ||
| - tasks/web-designer-define-style-guide.md | ||
| - tasks/web-designer-optimize-above-fold.md | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| # Coding Standards — professional-web-squad | ||
|
|
||
| ## Princípios gerais | ||
|
|
||
| - Semântica HTML5 correta (section, article, nav, main, header, footer) | ||
| - CSS: variáveis CSS para tokens de design (cores, fontes, espaçamento) | ||
| - Mobile-first: media queries do menor para o maior breakpoint | ||
| - Performance: imagens otimizadas (WebP, lazy loading), fontes com font-display: swap | ||
| - Acessibilidade: WCAG AA mínimo, aria-labels, foco visível | ||
|
|
||
| ## Nomenclatura | ||
|
|
||
| - Classes CSS: BEM (block__element--modifier) | ||
| - IDs: apenas para âncoras e formulários | ||
| - Arquivos: kebab-case (hero-section.html) | ||
|
|
||
| ## Estrutura de arquivos recomendada | ||
|
|
||
| ``` | ||
| projeto/ | ||
| ├── index.html | ||
| ├── css/ | ||
| │ ├── tokens.css # Design tokens (variáveis CSS) | ||
| │ ├── base.css # Reset e estilos globais | ||
| │ └── components/ # Estilos por seção | ||
| ├── js/ | ||
| │ └── main.js | ||
| └── assets/ | ||
| └── images/ | ||
| ``` | ||
|
Comment on lines
+19
to
+30
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Specify a language for the fenced tree block. Markdown lint warning MD040 applies here; use Suggested diff-```
+```text
projeto/
├── index.html
├── css/
│ ├── tokens.css # Design tokens (variáveis CSS)
│ ├── base.css # Reset e estilos globais
│ └── components/ # Estilos por seção
├── js/
│ └── main.js
└── assets/
└── images/Verify each finding against current code. Fix only still-valid issues, skip the In |
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| # Source Tree — professional-web-squad | ||
|
|
||
| ## Estrutura do squad | ||
|
|
||
| ``` | ||
| squads/professional-web-squad/ | ||
| ├── squad.yaml # Manifest do squad | ||
| ├── README.md # Documentação do squad | ||
| ├── config/ | ||
| │ ├── coding-standards.md # Padrões de código | ||
| │ ├── tech-stack.md # Tecnologias | ||
| │ └── source-tree.md # Este arquivo | ||
| ├── agents/ | ||
| │ ├── discovery.md # 🔍 Discovery Agent | ||
| │ ├── copywriter.md # ✍️ Copywriter & Storytelling | ||
| │ ├── web-designer.md # 🖥️ Web Designer & UX | ||
| │ ├── seo-specialist.md # 📈 SEO & Performance | ||
| │ └── ui-ux-expert.md # 🎨 Senior UI/UX Expert | ||
| ├── tasks/ | ||
| │ ├── discovery-*.md # Tasks de discovery | ||
| │ ├── copywriter-*.md # Tasks de copy | ||
| │ ├── web-designer-*.md # Tasks de design | ||
| │ ├── seo-*.md # Tasks de SEO | ||
| │ └── ui-ux-*.md # Tasks de UI/UX | ||
| ├── workflows/ # Workflows multi-agente | ||
| ├── checklists/ # Checklists de qualidade | ||
| ├── templates/ # Templates de documento | ||
| ├── tools/ # Ferramentas customizadas | ||
| ├── scripts/ # Scripts utilitários | ||
| └── data/ # Dados estáticos | ||
| ``` | ||
|
Comment on lines
+5
to
+31
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Add a language to the fenced source-tree block. This currently violates MD040; Suggested diff-```
+```text
squads/professional-web-squad/
├── squad.yaml # Manifest do squad
├── README.md # Documentação do squad
├── config/
│ ├── coding-standards.md # Padrões de código
│ ├── tech-stack.md # Tecnologias
│ └── source-tree.md # Este arquivo
├── agents/
│ ├── discovery.md # 🔍 Discovery Agent
│ ├── copywriter.md # ✍️ Copywriter & Storytelling
│ ├── web-designer.md # 🖥️ Web Designer & UX
│ ├── seo-specialist.md # 📈 SEO & Performance
│ └── ui-ux-expert.md # 🎨 Senior UI/UX Expert
├── tasks/
│ ├── discovery-*.md # Tasks de discovery
│ ├── copywriter-*.md # Tasks de copy
│ ├── web-designer-*.md # Tasks de design
│ ├── seo-*.md # Tasks de SEO
│ └── ui-ux-*.md # Tasks de UI/UX
├── workflows/ # Workflows multi-agente
├── checklists/ # Checklists de qualidade
├── templates/ # Templates de documento
├── tools/ # Ferramentas customizadas
├── scripts/ # Scripts utilitários
└── data/ # Dados estáticos🧰 Tools🪛 markdownlint-cli2 (0.22.1)[warning] 5-5: Fenced code blocks should have a language specified (MD040, fenced-code-language) 🤖 Prompt for AI Agents |
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,28 @@ | ||
| # Tech Stack — professional-web-squad | ||
|
|
||
| ## Stack padrão (sem framework) | ||
|
|
||
| | Camada | Tecnologia | Notas | | ||
| |--------|-----------|-------| | ||
| | Markup | HTML5 semântico | SEO-friendly | | ||
| | Estilos | CSS3 + variáveis CSS | Tokens de design | | ||
| | Scripts | JavaScript vanilla | Sem dependências obrigatórias | | ||
| | Fontes | Google Fonts | Inter, Montserrat, Playfair | | ||
| | Ícones | Lucide Icons / SVG inline | Performance | | ||
| | Imagens | WebP + fallback JPG | Compressão obrigatória | | ||
|
|
||
| ## Opções de framework (por projeto) | ||
|
|
||
| | Framework | Quando usar | | ||
| |-----------|-------------| | ||
| | Next.js | Sites com SSR, blog, e-commerce | | ||
| | Astro | Sites estáticos, máxima performance | | ||
| | Webflow | Clientes que gerenciam conteúdo | | ||
| | WordPress + ACF | Clientes com CMS familiar | | ||
|
|
||
| ## Ferramentas de desenvolvimento | ||
|
|
||
| - Vite (bundler) | ||
| - PostCSS + Autoprefixer | ||
| - Prettier (formatação) | ||
| - Lighthouse (performance e SEO) |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,63 @@ | ||
| name: professional-web-squad | ||
| version: 1.0.0 | ||
| description: "Squad especializado em criação de sites e landing pages profissionais de alta conversão" | ||
| author: Lucas | ||
| license: MIT | ||
| slashPrefix: web | ||
|
|
||
| aios: | ||
| minVersion: "2.1.0" | ||
| type: squad | ||
|
|
||
| components: | ||
| agents: | ||
| - discovery.md | ||
| - copywriter.md | ||
| - web-designer.md | ||
| - seo-specialist.md | ||
| - ui-ux-expert.md | ||
| tasks: | ||
| - discovery-briefing.md | ||
| - discovery-define-persona.md | ||
| - discovery-define-value-proposition.md | ||
| - discovery-competitor-analysis.md | ||
| - copywriter-write-headline.md | ||
| - copywriter-write-copy.md | ||
| - copywriter-create-story.md | ||
| - copywriter-write-cta.md | ||
| - web-designer-plan-sections.md | ||
| - web-designer-create-wireframe.md | ||
| - web-designer-define-style-guide.md | ||
| - web-designer-optimize-above-fold.md | ||
| - seo-keyword-research.md | ||
| - seo-write-meta.md | ||
| - seo-audit.md | ||
| - seo-check-core-web-vitals.md | ||
| - ui-ux-color-palette.md | ||
| - ui-ux-typography-scale.md | ||
| - ui-ux-create-moodboard.md | ||
| - ui-ux-review.md | ||
| workflows: [] | ||
| checklists: [] | ||
| templates: [] | ||
| tools: [] | ||
| scripts: [] | ||
|
|
||
| config: | ||
| extends: extend | ||
| coding-standards: config/coding-standards.md | ||
| tech-stack: config/tech-stack.md | ||
| source-tree: config/source-tree.md | ||
|
|
||
| dependencies: | ||
| node: [] | ||
| python: [] | ||
| squads: [] | ||
|
|
||
| tags: | ||
| - web | ||
| - landing-page | ||
| - copy | ||
| - seo | ||
| - design | ||
| - conversion |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add a language identifier to the fenced workflow block.
This block triggers MD040 (
fenced-code-language). Usetext(ormd) to keep lint clean.Suggested diff
🧰 Tools
🪛 markdownlint-cli2 (0.22.1)
[warning] 17-17: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
🤖 Prompt for AI Agents