Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions squads/professional-web-squad/README.md
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)
```
Comment on lines +17 to +26

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language identifier to the fenced workflow block.

This block triggers MD040 (fenced-code-language). Use text (or md) to keep lint clean.

Suggested diff
-```
+```text
 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)
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 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
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/README.md` around lines 17 - 26, The fenced
workflow block beginning with "1. `@discovery`  → *briefing → *define-persona →
*define-value-proposition" is missing a language identifier which triggers
MD040; update that fenced code block in README.md by adding a language tag
(e.g., ```text or ```md) immediately after the opening backticks so the block
becomes ```text and the rest of the workflow lines remain unchanged, ensuring
the linter no longer flags the fenced-code-language issue.


## Gerado por

- **Squad Creator:** @squad-creator (Craft)
- **Blueprint:** `squads/.designs/professional-web-squad-design.yaml`
- **Data:** 2026-05-23
32 changes: 32 additions & 0 deletions squads/professional-web-squad/agents/copywriter.md
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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Map every declared command to a task dependency (or remove unsupported commands).

*write-about and *review-copy are exposed in Commands/Workflow, but no corresponding task files are declared in Dependencies. In a task-first squad, this creates unresolved command paths at runtime.

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.md

If those tasks are intentionally out of scope, remove the two commands from ## Commands and ## Workflow instead.

Also applies to: 24-24, 29-32

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/agents/copywriter.md` around lines 18 - 20, The
Commands `*write-about` and `*review-copy` declared in the "## Commands" / "##
Workflow" sections are not mapped to any task entries in "Dependencies", causing
unresolved command paths at runtime; either add matching task definitions for
these commands in the Dependencies block (create tasks named write-about and
review-copy or whatever the squad uses as task IDs and include their metadata)
or remove both commands from the Commands and Workflow sections if they are
intentionally unsupported; update any references to these symbols (e.g.,
`*write-about`, `*review-copy`, Commands/Workflow, Dependencies) so every
declared command has a corresponding dependency task.

## Workflow

```
*write-headline → *write-copy → *write-cta → *review-copy
```
Comment on lines +23 to +25

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language identifier to the workflow fenced block.

This triggers MD040; use text.

Suggested diff
-```
+```text
 *write-headline → *write-copy → *write-cta → *review-copy
</details>

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.22.1)</summary>

[warning] 23-23: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @squads/professional-web-squad/agents/copywriter.md around lines 23 - 25, Add
a language identifier "text" to the fenced code block containing the workflow
line so the markdown linter MD040 is satisfied; locate the fenced block that
contains the sequence "*write-headline → *write-copy → *write-cta →
*review-copy" and change its opening fence from totext (leave the
content and closing fence unchanged).


</details>

<!-- fingerprinting:phantom:triton:hawk -->

<!-- This is an auto-generated comment by CodeRabbit -->


## Dependencies

- tasks/copywriter-write-headline.md
- tasks/copywriter-write-copy.md
- tasks/copywriter-create-story.md
- tasks/copywriter-write-cta.md
31 changes: 31 additions & 0 deletions squads/professional-web-squad/agents/discovery.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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

*project-scope is declared without a backing task dependency.

This breaks task-first consistency: the agent advertises a command that has no mapped task file in ## Dependencies.

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.md

If not intended, remove *project-scope from ## Commands.

Also applies to: 28-31

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/agents/discovery.md` at line 18, The Commands
list contains `*project-scope` (and similar entries around the 28-31 area) but
there is no corresponding task declared under `## Dependencies`; remove
`*project-scope` from the `## Commands` section or add a matching
dependency/task entry under `## Dependencies` so every command has a backing
task (look for the `*project-scope` token and the `## Commands` / `##
Dependencies` headers to locate and fix).


## Workflow

```
*briefing → *define-persona → *define-value-proposition → *competitor-analysis
```
Comment on lines +22 to +24

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add fenced-block language for workflow.

MD040 warning applies; use text.

Suggested diff
-```
+```text
 *briefing → *define-persona → *define-value-proposition → *competitor-analysis
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 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
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/agents/discovery.md` around lines 22 - 24, Wrap
the workflow line "*briefing → *define-persona → *define-value-proposition →
*competitor-analysis" in a fenced code block with the language label text (use
```text ... ```), replacing the inline/backtick rendering so the markdown linter
(MD040) is satisfied and the content remains unchanged; ensure you include both
opening and closing triple backticks and preserve the exact arrowed sequence.


## Dependencies

- tasks/discovery-briefing.md
- tasks/discovery-define-persona.md
- tasks/discovery-define-value-proposition.md
- tasks/discovery-competitor-analysis.md
32 changes: 32 additions & 0 deletions squads/professional-web-squad/agents/seo-specialist.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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Two public commands are missing task dependencies.

*optimize-performance and *generate-schema-markup are documented commands but have no corresponding task entries in Dependencies, which violates task-first command mapping.

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.md

If those tasks are not intended for v1, remove both commands from ## Commands.

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”.
Context: ...na - *optimize-performance — Otimizar performance e velocidade - *check-core-web-vitals...

(PT_BARBARISMS_REPLACE_PERFORMANCE)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/agents/seo-specialist.md` around lines 17 - 19,
The Commands list includes `*optimize-performance` and `*generate-schema-markup`
but there are no corresponding task entries under the Dependencies section,
breaking the task-first command mapping; either add Dependency task entries
named/identified for optimize-performance and generate-schema-markup (with the
expected task details and identifiers) so each command maps to its task, or
remove these two commands from the "## Commands" section if they are not
intended for v1; update any references in Dependencies and Commands to keep
names consistent (look for the `*optimize-performance`,
`*generate-schema-markup`, `## Commands`, and `Dependencies` identifiers).


## Workflow

```
*keyword-research → *write-meta → *audit-seo → *check-core-web-vitals
```
Comment on lines +23 to +25

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language tag to the workflow code fence.

This resolves MD040 (fenced-code-language).

Suggested diff
-```
+```text
 *keyword-research → *write-meta → *audit-seo → *check-core-web-vitals
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 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
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/agents/seo-specialist.md` around lines 23 - 25,
Add a language tag to the fenced code block that contains the workflow arrow
sequence "*keyword-research → *write-meta → *audit-seo → *check-core-web-vitals"
(e.g., change ``` to ```text) so the Markdown linter rule MD040
(`fenced-code-language`) is satisfied; edit the code fence around that exact
sequence in the SEO specialist workflow to include the language tag.


## Dependencies

- tasks/seo-keyword-research.md
- tasks/seo-write-meta.md
- tasks/seo-audit.md
- tasks/seo-check-core-web-vitals.md
33 changes: 33 additions & 0 deletions squads/professional-web-squad/agents/ui-ux-expert.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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language tag to the workflow fenced block.

This block triggers markdownlint MD040 and may fail docs linting. Use a neutral language like text.

Proposed fix
-```
+```text
 *create-moodboard → *color-palette → *typography-scale → *design-system → *ui-review
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 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
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/agents/ui-ux-expert.md` around lines 24 - 26,
The fenced code block containing "*create-moodboard → *color-palette →
*typography-scale → *design-system → *ui-review" needs a neutral language tag to
satisfy markdownlint MD040; update the fence from ``` to ```text so the block
becomes a labeled text code fence (i.e., change the opening triple backticks to
```text) in the UI/UX expert doc where that snippet appears.


## Dependencies

- tasks/ui-ux-color-palette.md
- tasks/ui-ux-typography-scale.md
- tasks/ui-ux-create-moodboard.md
- tasks/ui-ux-review.md
32 changes: 32 additions & 0 deletions squads/professional-web-squad/agents/web-designer.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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Specify a language for the workflow code fence.

Line 23 lacks a fenced-block language and triggers MD040. text is sufficient here.

Proposed fix
-```
+```text
 *plan-sections → *create-wireframe → *define-style-guide → *optimize-above-fold
</details>

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.22.1)</summary>

[warning] 23-23: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @squads/professional-web-squad/agents/web-designer.md around lines 23 - 25,
Add the missing fenced-block language to the Markdown code fence that contains
the workflow sequence "*plan-sections → *create-wireframe → *define-style-guide
→ *optimize-above-fold" (the code block surrounding that sequence); specify
"text" after the opening triple backticks so the fence becomes ```text to
satisfy MD040 and make the block language explicit.


</details>

<!-- fingerprinting:phantom:triton:hawk -->

<!-- This is an auto-generated comment by CodeRabbit -->


## 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
Empty file.
30 changes: 30 additions & 0 deletions squads/professional-web-squad/config/coding-standards.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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Specify a language for the fenced tree block.

Markdown lint warning MD040 applies here; use text for directory trees.

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/
</details>

<details>
<summary>🧰 Tools</summary>

<details>
<summary>🪛 markdownlint-cli2 (0.22.1)</summary>

[warning] 19-19: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

</details>

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @squads/professional-web-squad/config/coding-standards.md around lines 19 -
30, The fenced code block that shows the directory tree (the block beginning
with and the line "projeto/") is missing a language specifier; update the opening fence totext so the directory tree is treated as plain text
(resolving MD040) while keeping the block contents unchanged.


</details>

<!-- fingerprinting:phantom:triton:hawk -->

<!-- This is an auto-generated comment by CodeRabbit -->

31 changes: 31 additions & 0 deletions squads/professional-web-squad/config/source-tree.md
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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language to the fenced source-tree block.

This currently violates MD040; text is appropriate for ASCII trees.

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
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 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
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@squads/professional-web-squad/config/source-tree.md` around lines 5 - 31, The
fenced code block in squads/professional-web-squad/config/source-tree.md is
missing a language specifier (violates MD040); update the opening fence from ```
to ```text so the ASCII tree is treated as plain text (preserve the existing
tree content and comments), then commit the change referencing the fenced block
(triple-backticks) and MD040 in your commit message.

28 changes: 28 additions & 0 deletions squads/professional-web-squad/config/tech-stack.md
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)
Empty file.
Empty file.
63 changes: 63 additions & 0 deletions squads/professional-web-squad/squad.yaml
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
Loading