AGENTS.md - AI 协作协议
"Se você está lendo este documento, você é a Inteligência (The Intelligence)."
Este arquivo é sua âncora (Anchor) . Ele define as leis do projeto, o mapa do território e o protocolo de memória. Quando você acordar (iniciar uma nova sessão), leia este arquivo primeiro.
🧠 Protocolo de recuperação rápida (Quick Recovery) de 30 segundos
Quando você iniciar uma nova sessão ou se sentir "perdido", execute imediatamente:
- Leia o AGENTS.md na raiz → Obtenha o mapa do projeto
- Veja o "Status atual" abaixo → Encontre a versão de arquitetura mais recente
- Leia
.anws/v{N}/05_TASKS.md→ Entenda as tarefas pendentes atuais - Comece a trabalhar
🗺️ Mapa (Percepção do Território)
Esta é a organização do projeto:
| Caminho | Descrição | Protocolo de Acesso |
|---|---|---|
src/ | Camada de implementação. O código real. | Leitura/Escrita via Task. |
.anws/ | Diretório raiz de arquitetura unificada. Contém estado de arquitetura versionado e registros de atualização. | Somente leitura (versão antiga) / Escrever uma vez (nova versão) / changelog mantido pela CLI. |
.anws/v{N}/ | Verdade atual. A definição de arquitetura mais recente. | Sempre procure pelo maior v{N}. |
.anws/changelog/ | Registro de atualizações. Registro de mudanças gerado por anws update. | Mantido automaticamente pela CLI, não exclua. |
target-specific workflow projection | Fluxo de trabalho. /genesis, /blueprint, etc. | Leia o arquivo de projeção nativa correspondente ao target atual. |
target-specific skill projection | Biblioteca de habilidades. Capacidades atômicas. | Chame o arquivo de projeção nativa correspondente ao target atual. |
.nexus-map/ | Base de conhecimento. Mapeamento da estrutura do código. | Gerado pelo nexus-mapper. |
🛠️ Registro de Fluxos de Trabalho
[!IMPORTANT] Princípio de prioridade do fluxo de trabalho: Quando uma tarefa corresponde a um fluxo de trabalho, ou você julgar que a tarefa atual claramente se encaixa, basicamente se encaixa, ou até mesmo apenas suspeita se encaixar no cenário de aplicação de um fluxo de trabalho, você DEVE ler o arquivo correspondente primeiro e seguir rigorosamente os passos descritos. Os fluxos de trabalho são protocolos cuidadosamente projetados, não referências opcionais.
Fluxo de disparo:
- O usuário menciona o nome do fluxo de trabalho, ou você julga que a tarefa atual claramente se encaixa, basicamente se encaixa, ou até mesmo apenas suspeita se encaixar no cenário de aplicação de um fluxo de trabalho, você DEVE ler o arquivo correspondente primeiro
- Leia imediatamente o arquivo de fluxo de trabalho correspondente
- Siga rigorosamente os passos do fluxo de trabalho
- Pause nos pontos de verificação e aguarde confirmação do usuário
| Fluxo de trabalho | Momento de disparo | Saída |
|---|---|---|
/quickstart | Entrada para novos usuários / Não sabe por onde começar | Orquestra outros fluxos de trabalho |
/genesis | Novo projeto / Grande refatoração | PRD, Architecture, ADRs |
/probe | Antes de mudanças / Ao assumir um projeto | .anws/v{N}/00_PROBE_REPORT.md |
/design-system | Após genesis | 04_SYSTEM_DESIGN/*.md |
/blueprint | Após genesis | 05_TASKS.md + Wave inicial do AGENTS.md |
/change | Ajustes em tarefas existentes | Atualizar TASKS + SYSTEM_DESIGN (somente modificação) + CHANGELOG |
/explore | Durante pesquisa | Relatório de exploração |
/challenge | Questionar antes de decisões | 07_CHALLENGE_REPORT.md (com índice geral de perguntas) |
/forge | Execução de codificação | Código + Bloco Wave atualizado no AGENTS.md |
/craft | Criar fluxos de trabalho/habilidades/prompts | Documento Workflow / Skill / Prompt |
/upgrade | Orquestração de atualização após anws update | Determinar Minor/Major e rotear para /change ou /genesis |
📜 A Constituição (The Constitution)
- Versão é lei: Não "conserta" documentos de arquitetura, apenas os "evolui". Mudanças devem criar uma nova versão.
- Contexto explícito: Decisões são registradas em ADRs, não ficam na "memória do chat".
- Validação cruzada: Antes de codificar, verifique
05_TASKS.md. Estou fazendo o que foi planejado? - Estética: Documentos devem ser bonitos. Use bem Markdown e Emoji.
🔄 Zona de Preservação de Estado do Projeto
📍 Status Atual (Atualizado automaticamente pelo Workflow)
Nota: Esta é a parte preservada do arquivo do projeto, mantida automaticamente por
/genesis,/blueprinte/forge.
- Versão de arquitetura mais recente:
.anws/v1 - Lista de tarefas ativas:
.anws/v1/05_TASKS.md - Número de tarefas pendentes: 0 tarefas de implementação bloqueadoras; atualmente em fase de revisão manual final
- Última atualização:
2026-03-16
🌊 Wave 1 — Core Guiado + Cadeia principal de Replay concluída
- Concluída a cadeia principal da CLI
start / step / replay - Concluída a exportação automática de
final.md,replay.mde para o diretório atual - Concluída a verificação de um clique
verify - Concluída a reescrita do protocolo CLI para
.windsurf/skills/sequential-thinking/SKILL.mdeskills/sequential-thinking-skills/SKILL.md - Estado atual: Aguardando revisão manual final e decisão sobre commit
🌳 Estrutura do Projeto (Project Tree)
Nota: Esta parte é mantida por
/genesis.
src/
└── anws/
├── bin/cli.js
├── lib/ (init, update, diff, changelog, copy, manifest, ...)
└── templates/
├── .agents/ (fonte canônica interna de templates, distribuída via projeção para cada target)
└── AGENTS.md
.anws/
├── changelog/ (registro de atualizações)
└── v{N}/ (documentos de arquitetura atuais)
🧭 Guia de Navegação (Navigation Guide)
Nota: Esta parte é mantida por
/genesis.
- Antes que a nova arquitetura esteja pronta: Não faça modificações em larga escala no código.
- Visão geral da arquitetura:
.anws/v{N}/02_ARCHITECTURE_OVERVIEW.md - ADR:
.anws/v{N}/03_ADR/(fonte única de registro para decisões entre sistemas) - Problemas de arquitetura: Consulte
.anws/v{N}/03_ADR/.
Decisões de Stack Tecnológico
- [Preenchido automaticamente por .anws/tech-evaluator ou /genesis]
Fronteiras do Sistema
- [Preenchido automaticamente por .anws/system-architect ou /genesis]
ADRs Ativos
- [Resumos de ADR preenchidos automaticamente por .anws]
Status de Tarefas Atuais
T4.3.1concluídaT1.3.1concluídapnpm typecheck / test / build / verifytudo aprovado- Atualmente não faz commit automático no Git, aguardando confirmação manual
Auto-diagnóstico: Pronto? Lembre ao usuário de executar
/quickstartpara começar.