treinamento-kiro

KO | EN

gitlite — search

#ai-agents #data-science #agent #github #developer-tools #tailwindcss #cloud-native #docker #tensorflow #golang

treinamento-kiro

(★ 9)

No description available.

File Explorer

ZIP Download

- - story-refiner.md
  - test-generator.json
  - test-generator.md
- - .gitkeep
- - mcp.json
  - mcp_placeholder.json
- - guia-commit.md
  - guia-git-flow.md
  - guia-trello.md
  - padroes-testes.md
  - product.md
  - structure.md
  - tech.md
- - commit-changes.kiro.hook
  - lint-on-save.kiro.hook
  - update-readme.kiro.hook
- - git-flow.md
  - padroes-testes.md
  - product.md
  - structure.md
  - tech.md
  - trello.md
- - README.md
- - README.md
- - 00-roteiro.md
  - 01-o-que-sao-hooks.md
  - 02-tipos-e-acoes.md
  - 03-exemplos-praticos.md
  - 04-demo-ao-vivo.md
  - 05-roteiro-apresentacao.md
  - README.md
- - 01-o-que-sao-powers.md
  - 02-anatomia-de-um-power.md
  - 03-instalacao-e-uso.md
  - 04-criando-power.md
  - 05 - handson
  - README.md
- - .gitignore
  - README.md
- - 01-o-que-e-spec-driven.md
  - 02-fluxo-na-pratica.md
  - 03-demo-ao-vivo.md
  - README.md
- - 00-roteiro.md
  - 01-o-que-sao-steering-documents.md
  - 02-como-criar-e-configurar.md
  - 03-modos-de-inclusao.md
  - 04-referencias-e-composicao.md
  - 05-casos-de-uso-reais.md
  - 06-boas-praticas-e-organizacao.md
  - 07-demo-pratica.md
  - README.md
- - .gitignore
  - README.md
- - products.ts
- - health.ts
  - products.ts
- - productService.ts
- - productTypes.ts
- app.ts
- server.ts
.gitignore
.prettierrc
eslint.config.mjs
package-lock.json
package.json
README.md
tsconfig.json
vitest.config.ts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Repositório de apoio para o programa de treinamento do **Kiro IDE**. O projeto é uma API REST de catálogo de produtos que evolui ao longo das sessões — cada módulo adiciona novas funcionalidades e demonstra uma feature diferente do Kiro.

## Stack

- Node.js + TypeScript (strict mode)
- Express 4.x
- Vitest + fast-check + supertest (testes)
- ESLint + Prettier (qualidade de código)
- Dados em memória (sem banco externo)

## Setup

```bash
npm install
npm run dev
```

## Comandos disponíveis

| Comando | Descrição |
|---------|-----------|
| `npm run dev` | Servidor com hot reload |
| `npm run build` | Compila TypeScript para `dist/` |
| `npm start` | Roda build compilado |
| `npm test` | Executa todos os testes |
| `npm run lint` | Roda ESLint |
| `npm run lint:fix` | Corrige problemas de lint |
| `npm run format` | Formata com Prettier |

## Endpoints

| Método | Rota | Descrição |
|--------|------|-----------|
| GET | /health | Health check (status + timestamp) |
| GET | /products | Listagem com filtros, ordenação e paginação |

### Query params de `/products`

| Param | Tipo | Default | Descrição |
|-------|------|---------|-----------|
| category | string | — | Filtro por categoria (exato) |
| minPrice | number | — | Preço mínimo (inclusivo) |
| maxPrice | number | — | Preço máximo (inclusivo) |
| sortBy | name \| price | name | Campo de ordenação |
| sortOrder | asc \| desc | asc | Direção da ordenação |
| limit | 1–100 | 10 | Itens por página |
| offset | ≥ 0 | 0 | Itens a pular |

## Módulos do Treinamento

Cada sessão foca em uma feature do Kiro e adiciona algo ao projeto:

| # | Sessão | Feature do Kiro | O que adiciona ao projeto | Docs |
|---|--------|-----------------|---------------------------|------|
| 1 | Spec Driven Development | Specs (requirements → design → tasks) | Endpoint `/products`, services, types, testes | [docs/kiro-spec-driven](docs/kiro-spec-driven/) |
| 2 | Steering Documents | Steering files (.kiro/steering/) | Padrões de tech, estrutura, produto, testes, git flow | [docs/kiro-steering-documents](docs/kiro-steering-documents/) |
| 3 | Agent Hooks | Hooks (.kiro/hooks/) | Automações de lint on save e update README | [docs/kiro-hooks](docs/kiro-hooks/) |
| 4 | Kiro Powers | Powers + MCP | Integração com serviços externos via Powers | [docs/kiro-powers](docs/kiro-powers/) |
| 5 | Kiro Skills | Skills do agente | Skills customizadas (caveman, commit, review) | [docs/kiro-skills](docs/kiro-skills/) |
| 6 | Kiro CLI | CLI (autocomplete, chat, translate) | Uso do Kiro fora da IDE | [docs/kiro-cli](docs/kiro-cli/) |
| 7 | Caveman Mode | Compressão de tokens | Comunicação ultra-compacta para economizar contexto | [docs/kiro-caveman-training](docs/kiro-caveman-training/) |
| 8 | Subagents | Agentes especializados | Delegação de tarefas a subagentes | [docs/kiro-subagents](docs/kiro-subagents/) |

## Estrutura do Projeto

```
├── src/
│   ├── app.ts                  # Setup Express (middleware + rotas)
│   ├── server.ts               # Entrypoint
│   ├── database/products.ts    # 15 produtos em memória
│   ├── routes/
│   │   ├── health.ts           # GET /health
│   │   └── products.ts         # GET /products (pipeline)
│   ├── services/
│   │   └── productService.ts   # Validate, filter, sort, paginate
│   └── types/
│       └── productTypes.ts     # Interfaces e tipos
├── tests/
│   ├── unit/                   # Testes unitários
│   ├── property/               # Testes property-based (fast-check)
│   └── integration/            # Testes HTTP (supertest)
├── .kiro/
│   ├── steering/               # Steering documents do projeto
│   ├── hooks/                  # Agent hooks configurados
│   └── specs/                  # Specs (requirements, design, tasks)
├── docs/                       # Material de cada sessão de treinamento
└── backup-files/               # Backups de hooks e steerings para demos
```

## Como usar este repositório

### Como instrutor
1. Clone o repo e rode `npm install`
2. Abra no Kiro IDE
3. Siga o material em `docs/` na ordem das sessões
4. Cada sessão tem seu próprio README com roteiro de apresentação

### Como participante
1. Clone o repo e rode `npm install`
2. Acompanhe a sessão ao vivo
3. Consulte os docs de cada módulo para revisão posterior
4. Explore os arquivos em `.kiro/` para entender a configuração

## Evolução progressiva

O projeto começa simples (Express + health check) e vai ganhando corpo:

```
Sessão 1 → Código (endpoint, services, types, testes)
Sessão 2 → Governança (steering documents com padrões do time)
Sessão 3 → Automação (hooks para lint, README, segurança)
Sessão 4 → Integração (powers e MCP servers)
Sessão 5 → Produtividade (skills customizadas)
Sessão 6 → CLI (uso headless e em pipelines)
Sessão 7 → Eficiência (caveman mode para economizar tokens)
Sessão 8 → Delegação (subagentes especializados)
```

---

> 📌 **Fontes**: [Documentação Kiro](https://kiro.dev/docs/)

treinamento-kiro

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README