Back to the catalog

<NOME DO PROJETO>

Memória arquitetural do projeto <NOME>.

Open source Repository Open in the app JSON README (API)

About

# <NOME DO PROJETO>

<Breve descrição do que o serviço faz e por que existe.>

## Architecture

- [[architecture/overview.md]]

## Decisions

- [[decisions/adr-001-<decisao-inicial>.md]]

## Domains

_(preencher com domínios relevantes do negócio)_

## Patterns

_(preencher conforme padrões específicos do projeto forem estabelecidos)_

## Agents

_(preencher se o projeto tiver agentes ou workers especializados)_

Details

Kind
OKF bundles
Topic
No topic detected
Publisher
brenothales
Origin
okf_github
Category
dados
Version
0.2
Last push
2026-08-11T20:54:45Z
Repository state
ativo
Language
HTML
Added
2026-09-08 09:04:14
Updated
2026-09-08 09:04:14
Origin id
brenothales/tcecode:.okf-template/index.md

README

# Institutional AI Engineering Platform — TCE

Plataforma de engenharia de software assistida por IA para as squads do Tribunal de Contas.

## Início rápido

### 1. Subir o AI Gateway localmente

```bash
cd gateway
cp .env.example .env
# Editar .env com as API keys institucionais fornecidas pelo AI_SQUAD_ADMIN
docker compose up -d
```

### 2. Instalar o CLI

```bash
pip install -e cli/
# ou pipx install cli/
```

### 3. Instalar o OpenCode (coding agent)

```bash
tce-ai install
# Seguir as instruções para instalar o OpenCode
```

### 4. Configurar

```bash
tce-ai configure
# Squad: squad-dados
# Virtual key: (fornecida pelo AI_SQUAD_ADMIN)
```

### 5. Usar

```bash
tce-ai           # inicia sessão de coding
tce-ai models    # lista modelos disponíveis
tce-ai status    # verifica conectividade com o gateway
```

---

## Estrutura do repositório

```
tce-ai/
  gateway/          ← AI Gateway (LiteLLM)
  cli/              ← tce-ai CLI (Python)
  skills/           ← Skills institucionais por tecnologia
  knowledge/        ← OKF: arquitetura, decisões, padrões
  .okf-template/    ← Template de OKF para projetos das squads
  AGENTS.md         ← Regras institucionais para o agente neste repo
```

## Documentação arquitetural

Consulte `knowledge/index.md` para a visão completa da plataforma.

## Roadmap

Ver `knowledge/reference/phases-roadmap.md`.

| Fase | Status | Conteúdo |
|---|---|---|
| 1 — Foundation | 🚧 Em andamento | OpenCode + LiteLLM + tce-ai CLI |
| 2 — Identity | Planejada | Keycloak + OIDC + RBAC |
| 3 — Knowledge | Planejada | Skills completas + OKF integrado |
| 4 — Tools | Planejada | MCP Servers institucionais |
| 5 — Agents | Planejada | A2A: agentes especializados |
| 6 — Governance | Planejada | Audit, Cost, Quota, Compliance |

More